doc/xml.txt
author Yiteng Zhang <yiteng.zhang@oracle.com>
Wed, 09 Mar 2016 11:27:23 -0800
changeset 3321 52e8eec3014c
parent 105 ade7e1f32442
permissions -rw-r--r--
17377205 IPS should not use M2Crypto 22332625 test suite should test signing certs with unsupported extensions 16718631 pkg verify traceback "AttributeError: 'int' object has no attribute 'check__ca'"
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
5
f713d9ac529c start xml argument
sch@rosseau
parents:
diff changeset
     1
f713d9ac529c start xml argument
sch@rosseau
parents:
diff changeset
     2
pkg
f713d9ac529c start xml argument
sch@rosseau
parents:
diff changeset
     3
USE OF XML
f713d9ac529c start xml argument
sch@rosseau
parents:
diff changeset
     4
f713d9ac529c start xml argument
sch@rosseau
parents:
diff changeset
     5
It might be helpful, for tools development, to offer an XML description
f713d9ac529c start xml argument
sch@rosseau
parents:
diff changeset
     6
of package transactions and manifests.
f713d9ac529c start xml argument
sch@rosseau
parents:
diff changeset
     7
8
4366caa7519e more on XML (but mostly to test notify)
sch@rosseau
parents: 5
diff changeset
     8
That is, if we're backing into a full fledged package dialect, beyond
4366caa7519e more on XML (but mostly to test notify)
sch@rosseau
parents: 5
diff changeset
     9
something single line-based, then we should consider whether an XML
4366caa7519e more on XML (but mostly to test notify)
sch@rosseau
parents: 5
diff changeset
    10
document is a suitable choice.  Usual pro-XML, con-XML position follows.
4366caa7519e more on XML (but mostly to test notify)
sch@rosseau
parents: 5
diff changeset
    11
105
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    12
1.  Specific cases in support.
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    13
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    14
Multiline text properties and localized text properties argues for use
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    15
of XML.
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    16
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    17
Sympathy with <property>, <value>, and <propval> in the smf(5) DTD might
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    18
be of benefit.
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    19
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    20
2.  Specific cases against.
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    21
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    22
Server side assembly of the transaction into a package version means
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    23
that the manifest might be difficult to construct.  Or maybe not:
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    24
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    25
open ->  <manifest package="...">
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    26
add ->   <action ...>
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    27
close -> </manifest>
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    28
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    29
(But accept and publish will require that manifest to be imported and
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    30
updated.)
ade7e1f32442 update various notes
"Stephen Hahn <sch@sun.com>"
parents: 8
diff changeset
    31