Added 'list_only' option (and modified 'run()' to respect it).
[python/dscho.git] / Doc / sgml / oasis / exchange.txt
bloba6bbf02df92eb8d5d5b2a1af36d0219738419960
3 <!-- EXCHANGE TABLE MODEL DECLARATION MODULE -->
5 <!-- This set of declarations defines the Exchange Table Model as of the
6      date shown in the Formal Public Identifier (FPI) for this entity.
8      This set of declarations may be referred to using a public external
9      entity declaration and reference as shown in the following two lines:
11 <!ENTITY % calstbls PUBLIC "-//OASIS//DTD Exchange Table Model 19960430//EN">
12 %calstbls;
14      If various parameter entities used within this set of declarations
15      are to be given non-default values, the appropriate declarations
16      should be given before calling in this package (i.e., before the
17      "%calstbls;" reference).
19      NOTE:  This set of declarations assumes a NAMELEN of 32 as is used in
20      the standard CALS defined SGML declaration.
21 -->
23 <!-- This entity includes a set of element and attribute declarations
24      that partially defines the Exchange table model.  However, the model
25      is not well-defined without the accompanying natural language
26      description of the semantics (meanings) of these various elements,
27      attributes, and attribute values.  The semantic writeup, also available
28      from OASIS, should be used in conjunction with this entity.
29 -->
31 <!-- In order to use the Exchange table model, various parameter entity
32      declarations are required.  A brief description is as follows:
34      ENTITY NAME      WHERE USED              WHAT IT IS
36      %bodyatt         In ATTLIST of:          Additional (non-table related)
37                       table element(s)        attributes on the overall
38                                               (wrapper) table element(s)
40      %yesorno         In ATTLIST of:          An attribute declared value
41                       almost all elements     for a "boolean" attribute
43      %titles          In content model of:    The "title" part of the model
44                       table element(s)        group for the table element(s)
46      %paracon         In content model of:    The "text" (logical content)
47                       <entry>                 of the model group for <entry>
49      %tbl.table.name  In declaration of:      The name(s) of the "table"
50                       table element(s)        element(s)
52      %tbl.table-titles.mdl In content model of: The model group for the title
53                       table elements(s)       part of the content model for
54                                               table element(s)
56      %tbl.table-main.mdl In content model of: The model group for the main part
57                       table elements(s)       (not including titles) of the
58                                               content model for table element(s)
60      %tbl.table.mdl   In content model of:    The model group for the content
61                       table elements(s)       model for table element(s),
62                                               often (and by default) defined
63                                               in terms of %tbl.table-titles.mdl
64                                               and %tbl.table-main.mdl
66      %tbl.table.excep In content model of:    The exceptions for the content
67                       table element(s)        model for table element(s)
69      %tbl.table.att   In ATTLIST of:          Additional attributes on the
70                       table element(s)        table element(s)
72      %tbl.tgroup.mdl  In content model of:    The model group for the content
73                       <tgroup>                model for <tgroup>
75      %tbl.tgroup.att  In ATTLIST of:          Additional attributes on the
76                       <tgroup>                <tgroup> element
78      %tbl.tbody.att   In ATTLIST of:          Additional attributes on the
79                       <tbody>                 <tbody> element
81      %tbl.colspec.att In ATTLIST of:          Additional attributes on the
82                       <colspec>               <colspec> element
84      %tbl.hdft.name   In declaration of:      The name(s) of the table
85                       head/foot element(s)    head and foot element(s)
87      %tbl.hdft.mdl    In content model of:    The model group for the content
88                       head/foot element(s)    model for head/foot element(s)
90      %tbl.hdft.excep  In content model of:    The exceptions for the content
91                       head/foot element(s)    model for head/foot element(s)
93      %tbl.hdft.att    In ATTLIST of:          Additional attributes on the
94                       head/foot element(s)    head/foot element(s)
97      %tbl.row.mdl     In content model of:    The model group for the content
98                       <row>                   model for <row>
100      %tbl.row.excep   In content model of:    The exceptions for the content
101                       <row>                   model for <row>
103      %tbl.row.att     In ATTLIST of:          Additional attributes on the
104                       <row>                   <row> element
106      %tbl.entry.mdl   In content model of:    The model group for the content
107                       <entry>                 model for <entry>
109      %tbl.entry.excep In content model of:    The exceptions for the content
110                       <entry>                 model for <entry>
112      %tbl.entry.att   In ATTLIST of:          Additional attributes on the
113                       <entry>                 <entry> element
115      This set of declarations will use the default definitions shown below
116      for any of these parameter entities that are not declared before this
117      set of declarations is referenced.
120 <!-- These definitions are not directly related to the table model, but are
121      used in the default CALS table model and may be defined elsewhere (and
122      prior to the inclusion of this table module) in the referencing DTD. -->
124 <!ENTITY % bodyatt "">
125 <!ENTITY % yesorno 'NUMBER'  -- no if zero(s),
126                                 yes if any other digits value -->
127 <!ENTITY % titles  'title?'>
128 <!ENTITY % paracon '#PCDATA' -- default for use in entry content -->
130 <!--
131 The parameter entities as defined below change and simplify the CALS table
132 model as published (as part of the Example DTD) in MIL-HDBK-28001.  The
133 resulting simplified DTD has support from the OASIS vendors and is
134 therefore more interoperable among different systems.
136 These following declarations provide the Exchange default definitions
137 for these entities.  However, these entities can be redefined (by giving
138 the appropriate parameter entity declaration(s) prior to the reference
139 to this Table Model declaration set entity) to fit the needs of the
140 current application.
142 Note, however, that changes may have significant effect on the ability to
143 interchange table information.  These changes may manifest themselves
144 in useability, presentation, and possible structure information degradation.
147 <!ENTITY % tbl.table.name       "table">
148 <!ENTITY % tbl.table-titles.mdl "%titles;,">
149 <!ENTITY % tbl.table-main.mdl   "tgroup+">
150 <!ENTITY % tbl.table.mdl        "%tbl.table-titles.mdl; %tbl.table-main.mdl;">
151 <!ENTITY % tbl.table.excep      "-(%tbl.table.name)">
152 <!ENTITY % tbl.table.att        "
153     pgwide      %yesorno;       #IMPLIED ">
154 <!ENTITY % tbl.tgroup.mdl       "colspec*,thead?,tbody">
155 <!ENTITY % tbl.tgroup.att       "">
156 <!ENTITY % tbl.tbody.att        "">
157 <!ENTITY % tbl.colspec.att      "">
158 <!ENTITY % tbl.hdft.name        "thead">
159 <!ENTITY % tbl.hdft.mdl         "row+">
160 <!ENTITY % tbl.hdft.excep       "">
161 <!ENTITY % tbl.hdft.att         "">
162 <!ENTITY % tbl.row.mdl          "entry+">
163 <!ENTITY % tbl.row.excep        "">
164 <!ENTITY % tbl.row.att          "">
165 <!ENTITY % tbl.entry.mdl        "(%paracon;)*">
166 <!ENTITY % tbl.entry.excep      "">
167 <!ENTITY % tbl.entry.att        "">
169 <!-- =====  Element and attribute declarations follow. =====  -->
171 <!--
172      Default declarations previously defined in this entity and
173      referenced below include:
174      ENTITY % tbl.table.name       "table"
175      ENTITY % tbl.table-titles.mdl "%titles;,"
176      ENTITY % tbl.table-main.mdl   "tgroup+"
177      ENTITY % tbl.table.mdl        "%tbl.table-titles; %tbl.table-main.mdl;"
178      ENTITY % tbl.table.excep      "-(%tbl.table.name)"
179      ENTITY % tbl.table.att        "
180                         pgwide          %yesorno;       #IMPLIED "
183 <!ELEMENT %tbl.table.name; - - (%tbl.table.mdl;) %tbl.table.excep; >
185 <!ATTLIST %tbl.table.name
186         frame           (top|bottom|topbot|all|sides|none)      #IMPLIED
187         colsep          %yesorno;                               #IMPLIED
188         rowsep          %yesorno;                               #IMPLIED
189         %tbl.table.att;
190         %bodyatt;
193 <!--
194      Default declarations previously defined in this entity and
195      referenced below include:
196      ENTITY % tbl.tgroup.mdl    "colspec*,thead?,tbody"
197      ENTITY % tbl.tgroup.att    ""
200 <!ELEMENT tgroup - O (%tbl.tgroup.mdl;) >
202 <!ATTLIST tgroup
203         cols            NUMBER                                  #REQUIRED
204         colsep          %yesorno;                               #IMPLIED
205         rowsep          %yesorno;                               #IMPLIED
206         align           (left|right|center|justify|char)        #IMPLIED
207         %tbl.tgroup.att;
210 <!--
211      Default declarations previously defined in this entity and
212      referenced below include:
213      ENTITY % tbl.colspec.att   ""
216 <!ELEMENT colspec - O EMPTY >
218 <!ATTLIST colspec
219         colnum          NUMBER                                  #IMPLIED
220         colname         NMTOKEN                                 #IMPLIED
221         colwidth        CDATA                                   #IMPLIED
222         colsep          %yesorno;                               #IMPLIED
223         rowsep          %yesorno;                               #IMPLIED
224         align           (left|right|center|justify|char)        #IMPLIED
225         char            CDATA                                   #IMPLIED
226         charoff         NUTOKEN                                 #IMPLIED
227         %tbl.colspec.att;
230 <!--
231      Default declarations previously defined in this entity and
232      referenced below include:
233      ENTITY % tbl.hdft.name     "thead"
234      ENTITY % tbl.hdft.mdl      "row+"
235      ENTITY % tbl.hdft.excep    ""
236      ENTITY % tbl.hdft.att      ""
239 <!ELEMENT %tbl.hdft.name; - O (%tbl.hdft.mdl;)  %tbl.hdft.excep;>
241 <!ATTLIST %tbl.hdft.name;
242         valign          (top|middle|bottom)                     #IMPLIED
243         %tbl.hdft.att;
246 <!--
247      Default declarations previously defined in this entity and
248      referenced below include:
249      ENTITY % tbl.tbody.att     ""
252 <!ELEMENT tbody - O (row+)>
254 <!ATTLIST tbody
255         valign          (top|middle|bottom)                     #IMPLIED
256         %tbl.tbody.att;
259 <!--
260      Default declarations previously defined in this entity and
261      referenced below include:
262      ENTITY % tbl.row.mdl       "entry+"
263      ENTITY % tbl.row.excep     ""
264      ENTITY % tbl.row.att       ""
267 <!ELEMENT row - O (%tbl.row.mdl;) %tbl.row.excep;>
269 <!ATTLIST row
270         rowsep          %yesorno;                               #IMPLIED
271         valign          (top|middle|bottom)                     #IMPLIED
272         %tbl.row.att;
276 <!--
277      Default declarations previously defined in this entity and
278      referenced below include:
279      ENTITY % paracon           "#PCDATA"
280      ENTITY % tbl.entry.mdl     "(%paracon;)*"
281      ENTITY % tbl.entry.excep   ""
282      ENTITY % tbl.entry.att     ""
285 <!ELEMENT entry - O (%tbl.entry.mdl;) %tbl.entry.excep; >
287 <!ATTLIST entry
288         colname         NMTOKEN                                 #IMPLIED
289         namest          NMTOKEN                                 #IMPLIED
290         nameend         NMTOKEN                                 #IMPLIED
291         morerows        NUMBER                                  #IMPLIED
292         colsep          %yesorno;                               #IMPLIED
293         rowsep          %yesorno;                               #IMPLIED
294         align           (left|right|center|justify|char)        #IMPLIED
295         char            CDATA                                   #IMPLIED
296         charoff         NUTOKEN                                 #IMPLIED
297         valign          (top|middle|bottom)                     #IMPLIED
298         %tbl.entry.att;