Allow comment characters (#) to be escaped:
[python/dscho.git] / Doc / tools / sgmlconv / conversion.xml
blobe1d8b8ef1c4248e56a8fe3e1ec11a0abe1262a60
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <conversion>
3   <!-- Miscellaneous. -->
4   <macro name="declaremodule">
5     <attribute name="id" optional="yes"/>
6     <attribute name="type"/>
7     <attribute name="name"/>
8     </macro>
9   <macro name="modulesynopsis">
10     <content/>
11     </macro>
12   <macro name="platform">
13     <content/>
14     </macro>
15   <macro name="deprecated">
16     <attribute name="version"/>
17     <content/>
18     </macro>
19   <macro name="label">
20     <attribute name="id"/>
21     </macro>
22   <macro name="nodename" outputname="label">
23     <attribute name="id"/>
24     </macro>
25   <macro name="localmoduletable"/>
26   <macro name="manpage">
27     <attribute name="name"/>
28     <attribute name="section"/>
29     </macro>
30   <macro name="module">
31     <content/>
32     </macro>
33   <macro name="moduleauthor">
34     <attribute name="name"/>
35     <attribute name="email"/>
36     </macro>
37   <macro name="rfc">
38     <attribute name="num"/>
39     </macro>
40   <macro name="sectionauthor">
41     <attribute name="name"/>
42     <attribute name="email"/>
43     </macro>
44   <macro name="versionadded">
45     <attribute name="version"/>
46     </macro>
47   <macro name="versionchanged">
48     <attribute name="version"/>
49     </macro>
51   <!-- Module referencing. -->
52   <macro name="refmodule" outputname="module">
53     <attribute name="" optional="yes"/>
54     <attribute name="link">yes</attribute>
55     <content/>
56     </macro>
58   <!-- Information units. -->
59   <!-- C things. -->
60   <environment name="cfuncdesc">
61     <attribute name="type"/>
62     <attribute name="name"/>
63     <child name="args"/>
64     </environment>
65   <environment name="ctypedesc">
66     <attribute name="name"/>
67     </environment>
68   <environment name="cvardesc">
69     <attribute name="type"/>
70     <attribute name="name"/>
71     </environment>
73   <!-- Python things. -->
74   <macro name="optional">
75     <content/>
76     </macro>
77   <environment name="classdesc">
78     <attribute name="name"/>
79     <child name="args"/>
80     </environment>
81   <environment name="datadesc">
82     <attribute name="name"/>
83     </environment>
84   <environment name="excdesc">
85     <attribute name="name"/>
86     </environment>
88   <environment name="funcdesc">
89     <attribute name="name"/>
90     <child name="args"/>
91     </environment>
92   <macro name="funcline">
93     <attribute name="name"/>
94     <child name="args"/>
95     </macro>
96   <environment name="funcdescni" outputname="funcdesc">
97     <attribute name="index">no</attribute>
98     <attribute name="name"/>
99     <child name="args"/>
100     </environment>
101   <macro name="funclineni" outputname="funcline">
102     <attribute name="index">no</attribute>
103     <attribute name="name"/>
104     <child name="args"/>
105     </macro>
107   <environment name="memberdesc">
108     <attribute name="class" optional="yes"/>
109     <attribute name="name"/>
110     </environment>
111   <environment name="memberdescni" outputname="memberdesc">
112     <attribute name="index">no</attribute>
113     <attribute name="class" optional="yes"/>
114     <attribute name="name"/>
115     </environment>
117   <environment name="methoddesc">
118     <attribute name="class" optional="yes"/>
119     <attribute name="name"/>
120     <child name="args"/>
121     </environment>
122   <macro name="methodline">
123     <attribute name="class" optional="yes"/>
124     <attribute name="name"/>
125     <child name="args"/>
126     </macro>
127   <environment name="methoddescni">
128     <attribute name="index">no</attribute>
129     <attribute name="class" optional="yes"/>
130     <attribute name="name"/>
131     <child name="args"/>
132     </environment>
133   <macro name="methodlineni" outputname="methodline">
134     <attribute name="index">no</attribute>
135     <attribute name="class" optional="yes"/>
136     <attribute name="name"/>
137     <child name="args"/>
138     </macro>
140   <environment name="opcodedesc">
141     <attribute name="name"/>
142     <attribute name="var"/>
143     </environment>
145   <!-- "See also:" sections. -->
146   <macro name="seemodule">
147     <attribute name="ref" optional="yes"/>
148     <attribute name="name"/>
149     <content/>
150     </macro>
151   <macro name="seetext">
152     <content/>
153     </macro>
155   <!-- Index-generating markup. -->
156   <macro name="index" outputname="indexterm">
157     <attribute name="term1"/>
158     </macro>
159   <macro name="indexii" outputname="indexterm">
160     <attribute name="term1"/>
161     <attribute name="term2"/>
162     </macro>
163   <macro name="indexiii" outputname="indexterm">
164     <attribute name="term1"/>
165     <attribute name="term2"/>
166     <attribute name="term3"/>
167     </macro>
168   <macro name="indexiv" outputname="indexterm">
169     <attribute name="term1"/>
170     <attribute name="term2"/>
171     <attribute name="term3"/>
172     <attribute name="term4"/>
173     </macro>
175   <macro name="ttindex" outputname="indexterm">
176     <attribute name="style">tt</attribute>
177     <attribute name="term1"/>
178     </macro>
180   <macro name="refmodindex">
181     <attribute name="module"/>
182     </macro>
183   <macro name="stmodindex">
184     <attribute name="module"/>
185     </macro>
186   <macro name="refbimodindex" outputname="refmodindex">
187     <attribute name="module"/>
188     </macro>
189   <macro name="refexmodindex" outputname="refmodindex">
190     <attribute name="module"/>
191     </macro>
192   <macro name="refstmodindex" outputname="refmodindex">
193     <attribute name="module"/>
194     </macro>
196   <macro name="bifuncindex">
197     <attribute name="name"/>
198     </macro>
199   <macro name="exindex">
200     <attribute name="name"/>
201     </macro>
202   <macro name="obindex">
203     <attribute name="name"/>
204     </macro>
205   <macro name="kwindex">
206     <attribute name="name"/>
207     </macro>
208   <macro name="opindex">
209     <attribute name="type"/>
210     </macro>
211   <macro name="stindex">
212     <attribute name="type"/>
213     </macro>
214   <macro name="withsubitem">
215     <attribute name="text"/>
216     <content/>
217     </macro>
218   <macro name="setindexsubitem">
219     <attribute name="text"/>
220     </macro>
222   <!-- Entity management. -->
223   <macro name="include">
224     <attribute name="source"/>
225     </macro>
226   <macro name="input">
227     <attribute name="source"/>
228     </macro>
230   <!-- Large-scale document structure. -->
231   <macro name="documentclass">
232     <attribute name="classname"/>
233     </macro>
235   <environment name="document"
236                endcloses="chapter chapter* section section*
237                           subsection subsection*
238                           subsubsection subsubsection*
239                           paragraph paragraph* subparagraph subparagraph*"/>
241   <macro name="chapter"
242          closes="chapter chapter* section section* subsection subsection*
243                  subsubsection subsubsection*
244                  paragraph paragraph* subparagraph subparagraph*">
245     <text>
246   </text>
247     <child name="title"/>
248     <content implied="yes"/>
249     </macro>
250   <macro name="chapter*" outputname="chapter"
251          closes="chapter chapter* section section* subsection subsection*
252                  subsubsection subsubsection*
253                  paragraph paragraph* subparagraph subparagraph*">
254     <attribute name="numbered">no</attribute>
255     <text>
256   </text>
257     <child name="title"/>
258     <content implied="yes"/>
259     </macro>
261   <macro name="section"
262          closes="section section* subsection subsection*
263                  subsubsection subsubsection*
264                  paragraph paragraph* subparagraph subparagraph*">
265     <text>
266   </text>
267     <child name="title"/>
268     <content implied="yes"/>
269     </macro>
270   <macro name="section*" outputname="section"
271          closes="section section* subsection subsection*
272                  subsubsection subsubsection*
273                  paragraph paragraph* subparagraph subparagraph*">
274     <attribute name="numbered">no</attribute>
275     <text>
276   </text>
277     <child name="title"/>
278     <content implied="yes"/>
279     </macro>
281   <macro name="subsection"
282          closes="subsection subsection* subsubsection subsubsection*
283                  paragraph paragraph* subparagraph subparagraph*">
284     <text>
285   </text>
286     <child name="title"/>
287     <content implied="yes"/>
288     </macro>
289   <macro name="subsection*" outputname="subsection"
290          closes="subsection subsection* subsubsection subsubsection*
291                  paragraph paragraph* subparagraph subparagraph*">
292     <attribute name="numbered">no</attribute>
293     <text>
294   </text>
295     <child name="title"/>
296     <content implied="yes"/>
297     </macro>
299   <macro name="subsubsection"
300          closes="subsubsection subsubsection*
301                  paragraph paragraph* subparagraph subparagraph*">
302     <text>
303   </text>
304     <child name="title"/>
305     <content implied="yes"/>
306     </macro>
307   <macro name="subsubsection*" outputname="subsubsection"
308          closes="subsubsection subsubsection*
309                  paragraph paragraph* subparagraph subparagraph*">
310     <attribute name="numbered">no</attribute>
311     <text>
312   </text>
313     <child name="title"/>
314     <content implied="yes"/>
315     </macro>
317   <macro name="paragraph"
318          closes="paragraph paragraph* subparagraph subparagraph*">
319     <text>
320   </text>
321     <child name="title"/>
322     <content implied="yes"/>
323     </macro>
324   <macro name="paragraph*" outputname="paragraph"
325          closes="paragraph paragraph* subparagraph subparagraph*">
326     <attribute name="numbered">no</attribute>
327     <text>
328   </text>
329     <child name="title"/>
330     <content implied="yes"/>
331     </macro>
333   <macro name="subparagraph"
334          closes="subparagraph subparagraph*">
335     <text>
336   </text>
337     <child name="title"/>
338     <content implied="yes"/>
339     </macro>
340   <macro name="subparagraph*" outputname="subparagraph"
341          closes="subparagraph subparagraph*">
342     <attribute name="numbered">no</attribute>
343     <text>
344   </text>
345     <child name="title"/>
346     <content implied="yes"/>
347     </macro>
348   <macro name="title">
349     <content/>
350     </macro>
352   <macro name="appendix" outputname="back-matter"
353          closes="chapter chapter* section subsection subsubsection
354                  paragraph subparagraph"/>
356   <environment name="list"
357                endcloses="item">
358     <attribute name="bullet"/>
359     <attribute name="init"/>
360     </environment>
361   <macro name="item" closes="item">
362     <child name="leader" optional="yes"/>
363     <content implied="yes"/>
364     </macro>
366   <macro name="ref">
367     <attribute name="ref"/>
368     </macro>
370   <environment name="description" outputname="descriptionlist"
371                endcloses="item"/>
373   <environment name="enumerate" outputname="enumeration"
374                endcloses="item"/>
376   <environment name="fulllineitems"
377                endcloses="item"/>
379   <environment name="itemize"
380                endcloses="item"/>
382   <environment name="definitions" outputname="definitionlist"
383                encloses="term"/>
384   <macro name="term" closes="definition">
385     <!-- not really optional, but uses the [] syntax -->
386     <child name="term" optional="yes"/>
387     <child name="definition" implied="yes"/>
388     </macro>
390   <environment name="comment" verbatim="yes"/>
391   <environment name="verbatim" verbatim="yes"/>
392   <environment name="verbatim*" verbatim="yes">
393     <!-- not used anywhere, but it's a standard LaTeXism -->
394     <attribute name="spaces">visible</attribute>
395     </environment>
397   <!-- Table markup. -->
398   <macro name="hline"/>
399   <environment name="tableii" outputname="table">
400     <attribute name="cols">2</attribute>
401     <attribute name="colspec"/>
402     <attribute name="style"/>
403     <child name="entry"/>
404     <text>
405          </text>
406     <child name="entry"/>
407     </environment>
408   <macro name="lineii" outputname="row">
409     <child name="entry"/>
410     <text>
411          </text>
412     <child name="entry"/>
413     </macro>
415   <environment name="tableiii" outputname="table">
416     <attribute name="cols">3</attribute>
417     <attribute name="colspec"/>
418     <attribute name="style"/>
419     <child name="entry"/>
420     <text>
421          </text>
422     <child name="entry"/>
423     <text>
424          </text>
425     <child name="entry"/>
426     </environment>
427   <macro name="lineiii" outputname="row">
428     <child name="entry"/>
429     <text>
430          </text>
431     <child name="entry"/>
432     <text>
433          </text>
434     <child name="entry"/>
435     </macro>
437   <environment name="tableiv" outputname="table">
438     <attribute name="cols">4</attribute>
439     <attribute name="colspec"/>
440     <attribute name="style"/>
441     <child name="entry"/>
442     <text>
443          </text>
444     <child name="entry"/>
445     <text>
446          </text>
447     <child name="entry"/>
448     <text>
449          </text>
450     <child name="entry"/>
451     </environment>
452   <macro name="lineiv" outputname="row">
453     <child name="entry"/>
454     <text>
455          </text>
456     <child name="entry"/>
457     <text>
458          </text>
459     <child name="entry"/>
460     <text>
461          </text>
462     <child name="entry"/>
463     </macro>
465   <!-- These are handled at a later translation stage, at least for now. -->
466   <macro name="Cpp" outputname="">
467     <text>C++</text>
468     </macro>
469   <macro name="geq"/>
470   <macro name="LaTeX"/>
471   <macro name="ldots" outputname="">
472     <text>...</text>
473     </macro>
474   <macro name="leq"/>
475   <macro name="TeX"/>
476   <macro name="version"/>
478   <!-- Misc. -->
479   <macro name="emph">
480     <content/>
481     </macro>
482   <macro name="strong">
483     <content/>
484     </macro>
485   <macro name="textrm">
486     <content/>
487     </macro>
488   <macro name="texttt">
489     <content/>
490     </macro>
491   <macro name="code">
492     <content/>
493     </macro>
494   <macro name="exception">
495     <content/>
496     </macro>
497   <macro name="keyword">
498     <content/>
499     </macro>
500   <macro name="samp">
501     <content/>
502     </macro>
503   <macro name="class">
504     <content/>
505     </macro>
506   <macro name="cdata">
507     <content/>
508     </macro>
509   <macro name="cfunction">
510     <content/>
511     </macro>
512   <macro name="ctype">
513     <content/>
514     </macro>
515   <macro name="pytype">
516     <content/>
517     </macro>
518   <macro name="character">
519     <content/>
520     </macro>
521   <macro name="constant">
522     <content/>
523     </macro>
524   <macro name="envvar">
525     <content/>
526     </macro>
527   <macro name="file" outputname="filename">
528     <content/>
529     </macro>
530   <macro name="function">
531     <content/>
532     </macro>
533   <macro name="kbd">
534     <content/>
535     </macro>
536   <macro name="makevar">
537     <content/>
538     </macro>
539   <macro name="method">
540     <content/>
541     </macro>
542   <macro name="member">
543     <content/>
544     </macro>
545   <macro name="mimetype">
546     <content/>
547     </macro>
548   <macro name="newsgroup">
549     <content/>
550     </macro>
551   <macro name="program">
552     <content/>
553     </macro>
554   <macro name="regexp">
555     <content/>
556     </macro>
557   <macro name="var">
558     <content/>
559     </macro>
560   <macro name="email">
561     <content/>
562     </macro>
563   <macro name="url">
564     <content/>
565     </macro>
566   <macro name="footnote">
567     <content/>
568     </macro>
569   <macro name="dfn" outputname="definedterm">
570     <content/>
571     </macro>
573   <macro name="mbox">
574     <content/>
575     </macro>
577   <!-- minimal math stuff to get by -->
578   <macro name="sqrt">
579     <content/>
580     </macro>
581   <macro name="frac" outputname="fraction">
582     <child name="numerator"/>
583     <child name="denominator"/>
584     </macro>
585   <macro name="sum">
586     <content/>
587     </macro>
589   <!-- Conversions to text; perhaps could be different?  There's -->
590   <!-- no way for a style sheet to work with these this way.     -->
591   <macro name="ABC" outputname=""
592     <text>ABC</text>
593     </macro>
594   <macro name="ASCII" outputname="">
595     <text>ASCII</text>
596     </macro>
597   <macro name="C" outputname="">
598     <text>C</text>
599     </macro>
600   <macro name="EOF" outputname="">
601     <text>EOF</text>
602     </macro>
603   <macro name="e" outputname="">
604     <text>\</text>
605     </macro>
606   <macro name="NULL" outputname="constant">
607     <text>NULL</text>
608     </macro>
609   <macro name="POSIX" outputname="">
610     <text>POSIX</text>
611     </macro>
612   <macro name="UNIX" outputname="">
613     <text>Unix</text>
614     </macro>
616   <!-- These will end up disappearing as well! -->
617   <macro name="catcode" outputname=""/>
618   <macro name="fi" outputname=""/>
619   <macro name="ifhtml" outputname=""/>
620   <macro name="indexname" outputname=""/>
621   <macro name="labelwidth" outputname=""/>
622   <macro name="large" outputname=""/>
623   <macro name="leftmargin" outputname=""/>
624   <macro name="makeindex" outputname=""/>
625   <macro name="makemodindex" outputname=""/>
626   <macro name="maketitle" outputname=""/>
627   <macro name="noindent" outputname=""/>
628   <macro name="protect" outputname=""/>
629   <macro name="renewcommand">
630     <attribute name="macro"/>
631     <attribute name="nargs" optional="yes"/>
632     <content/>
633     </macro>
634   <macro name="tableofcontents" outputname=""/>
635   <macro name="vspace">
636     <attribute name="size"/>
637     </macro>
638 </conversion>