xref: /openbsd/gnu/usr.bin/texinfo/util/texinfo.dtd (revision a1acfa9b) 
1<!-- $Id: texinfo.dtd,v 1.1.1.1 2006/07/17 16:03:49 espie Exp $
2   Document Type Definition for Texinfo.
3
4   Author: Philippe Martin (feloy@free.fr)
5   Contributors:
6           Karl Eichwalder (keichwa@gmx.net)
7           Alper Ersoy (dirt@gtk.org)
8
9   Copyright (C) 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
10
11  Copying and distribution of this file, with or without modification,
12  are permitted in any medium without royalty provided the copyright
13  notice and this notice are preserved.
14
15-->
16
17<!-- ENTITIES -->
18
19<!-- Meta-information -->
20<!ENTITY % metainformation "setfilename | settitle | dircategory
21                            | documentdescription">
22<!ENTITY % variables "setvalue | clearvalue">
23
24<!-- Document language -->
25<!ENTITY % lang "documentlanguage">
26
27<!-- Language codes -->
28<!ENTITY % languagecodes "aa|ab|af|am|ar|as|ay|az|ba|be|bg|bh|bi|bn|bo|br|ca|co|cs|cy|da|de|dz|el|en|eo|es|et|eu|fa|fi|fj|fo|fr|fy|ga|gd|gl|gn|gu|ha|he|hi|hr|hu|hy|ia|id|ie|ik|is|it|iu|ja|jw|ka|kk|kl|km|kn|ko|ks|ku|ky|la|ln|lo|lt|lv|mg|mi|mk|ml|mn|mo|mr|ms|mt|my|na|ne|nl|no|oc|om|or|pa|pl|ps|pt|qu|rm|rn|ro|ru|rw|sa|sd|sg|sh|si|sk|sl|sm|sn|so|sq|sr|ss|st|su|sv|sw|ta|te|tg|th|ti|tk|tl|tn|to|tr|ts|tt|tw|ug|uk|ur|uz|vi|vo|wo|xh|yi|yo|za|zh|zu">
29
30<!-- ToC -->
31<!ENTITY % toc "contents | shortcontents">
32
33<!-- Title page -->
34<!ENTITY % titlepage_cmds "author | booktitle | booksubtitle">
35
36<!-- block -->
37<!-- ***** -->
38<!ENTITY % block "menu | para | quotation | example | smallexample | lisp
39                  | smalllisp | cartouche | copying
40                  | format | smallformat | display
41                  | smalldisplay | itemize | enumerate | sp | center | group
42                  | table | multitable | definition">
43
44<!-- API definitions -->
45<!-- *************** -->
46<!ENTITY % definition.cmds "defcategory | deffunction | defvariable | defparam
47                            | defdelimiter | deftype | defparamtype | defdatatype
48                            | defclass | defclassvar | defoperation">
49
50<!-- Headings -->
51<!-- ******** -->
52<!ENTITY % headings "majorheading | chapheading | heading | subheading
53                     | subsubheading">
54
55
56<!-- Sectioning -->
57<!-- ********** -->
58<!ENTITY % section.level1 "top | chapter | unnumbered | appendix">
59
60<!ENTITY % section.level2 "section | unnumberedsec | appendixsec">
61
62<!ENTITY % section.level3 "subsection | unnumberedsubsec | appendixsubsec">
63
64<!ENTITY % section.level4 "subsubsection | unnumberedsubsubsec
65                           | appendixsubsubsec">
66
67<!ENTITY % section.all "%section.level1; | %section.level2; | %section.level3;
68                        | %section.level4;">
69
70
71<!ENTITY % section.level1.content "(%block;
72                                   | %section.level2;
73                                   | %section.level3;
74                                   | %section.level4;
75                                   | verbatim | titlepage | %toc;
76                                   | %lang; | %variables;
77                                   | %headings;
78                                   | printindex)*">
79
80<!ENTITY % section.level2.content "(%block;
81                                   | %section.level3;
82                                   | %section.level4;
83                                   | verbatim | titlepage | %toc;
84                                   | %lang; | %variables;
85                                   | %headings;)*">
86
87<!ENTITY % section.level3.content "(%block;
88                                   | %section.level4;
89                                   | verbatim | titlepage | %toc;
90                                   | %lang; | %variables;
91                                   | %headings;)*">
92
93<!ENTITY % section.level4.content "(%block;
94                                    | verbatim | titlepage | %toc;
95                                    | %lang; | %variables;
96                                    | %headings;)*">
97
98
99<!-- Inline -->
100<!-- ****** -->
101<!ENTITY % Inline.emphasize "strong | emph">
102<!ENTITY % Inline.fonts "b | i | r | sansserif | slanted | titlefont | tt">
103<!ENTITY % Inline.footnote "footnote">
104<!ENTITY % Inline.markup "code | command | env | file | option | samp
105                          | dfn | cite | key | kbd | var | acronym | url">
106<!ENTITY % Inline.math "math">
107<!ENTITY % Inline.reference "xref | inforef | indexterm | email | uref">
108<!ENTITY % Inline.smallcaps "sc">
109
110<!ENTITY % Inline.phrase
111           "%Inline.emphasize; | %Inline.smallcaps; | %Inline.fonts;
112            | %Inline.markup; | %Inline.math; | %Inline.reference;
113            | %Inline.footnote; ">
114
115
116<!-- ************ -->
117<!-- * ELEMENTS * -->
118<!-- ************ -->
119
120<!-- TOP Level Element -->
121<!-- ***************** -->
122<!ELEMENT texinfo ((%metainformation; | titlepage | node | %block; | %toc;
123                    | %variables; | %lang;)* )>
124<!ATTLIST texinfo xml:lang (%languagecodes;) 'en'>
125
126<!-- meta-information -->
127<!ELEMENT setfilename (#PCDATA)>
128<!ELEMENT settitle    (#PCDATA | %Inline.phrase; | footnote)*>
129<!ELEMENT dircategory (#PCDATA)>
130
131<!ELEMENT setvalue    (#PCDATA | %Inline.phrase;)*>
132<!ELEMENT clearvalue  EMPTY>
133<!ATTLIST setvalue
134                name CDATA #REQUIRED>
135<!ATTLIST clearvalue
136                name CDATA #REQUIRED>
137
138<!-- ToC -->
139<!ELEMENT contents      EMPTY>
140<!ELEMENT shortcontents EMPTY>
141
142<!-- Document language -->
143<!ELEMENT documentlanguage EMPTY>
144<!ATTLIST documentlanguage xml:lang (%languagecodes;) 'en'>
145
146<!-- Titlepage -->
147<!ELEMENT titlepage    (%titlepage_cmds; | %block;)*>
148<!ELEMENT author       (#PCDATA | %Inline.phrase;)*>
149<!ELEMENT booktitle    (#PCDATA | %Inline.phrase;)*>
150<!ELEMENT booksubtitle (#PCDATA | %Inline.phrase;)*>
151
152<!-- NODES -->
153<!-- ***** -->
154<!ELEMENT node (nodename, nodenext?, nodeprev?, nodeup?,
155                (%section.all; | %block; | %toc; | %lang; | image)*) >
156
157<!ELEMENT nodename (#PCDATA)>
158<!ELEMENT nodenext (#PCDATA)>
159<!ELEMENT nodeprev (#PCDATA)>
160<!ELEMENT nodeup   (#PCDATA)>
161
162<!-- SECTIONING -->
163<!-- ********** -->
164
165<!ELEMENT top           (title?, (%section.level1.content;))>
166
167<!ELEMENT chapter       (title?, (%section.level1.content;))>
168<!ELEMENT section       (title?, (%section.level2.content;))>
169<!ELEMENT subsection    (title?, (%section.level3.content;))>
170<!ELEMENT subsubsection (title?, (%section.level4.content;))>
171
172<!ELEMENT unnumbered          (title?, (%section.level1.content;))>
173<!ELEMENT unnumberedsec       (title?, (%section.level2.content;))>
174<!ELEMENT unnumberedsubsec    (title?, (%section.level3.content;))>
175<!ELEMENT unnumberedsubsubsec (title?, (%section.level4.content;))>
176
177<!ELEMENT appendix          (title?, (%section.level1.content;))>
178<!ELEMENT appendixsec       (title?, (%section.level2.content;))>
179<!ELEMENT appendixsubsec    (title?, (%section.level3.content;))>
180<!ELEMENT appendixsubsubsec (title?, (%section.level4.content;))>
181
182<!-- Headings and titles -->
183<!ELEMENT majorheading  (#PCDATA | %Inline.phrase; | footnote)*>
184<!ELEMENT chapheading   (#PCDATA | %Inline.phrase; | footnote)*>
185<!ELEMENT heading       (#PCDATA | %Inline.phrase; | footnote)*>
186<!ELEMENT subheading    (#PCDATA | %Inline.phrase; | footnote)*>
187<!ELEMENT subsubheading (#PCDATA | %Inline.phrase; | footnote)*>
188<!ELEMENT title         (#PCDATA | %Inline.phrase; | footnote)*>
189
190<!-- Negative Indentation in Blocks -->
191<!ELEMENT exdent       (#PCDATA | %Inline.phrase;)*>
192
193<!-- BLOCK Elements -->
194<!-- ************** -->
195
196<!ELEMENT quotation    (%block; | %Inline.phrase; | exdent)*>
197<!ELEMENT documentdescription (#PCDATA | %block; | %Inline.phrase;)*>
198<!ELEMENT example      (#PCDATA | %block; | %Inline.phrase; | exdent)*>
199<!ELEMENT smallexample (#PCDATA | %block; | %Inline.phrase; | exdent)*>
200<!ELEMENT lisp         (#PCDATA | %block; | %Inline.phrase; | exdent)*>
201<!ELEMENT smalllisp    (#PCDATA | %block; | %Inline.phrase; | exdent)*>
202<!ELEMENT cartouche    (#PCDATA | %block; | %Inline.phrase; | exdent)*>
203<!ELEMENT copying      (#PCDATA | %block; | %Inline.phrase; | exdent)*>
204<!ELEMENT format       (#PCDATA | %block; | %Inline.phrase; | exdent)*>
205<!ELEMENT smallformat  (#PCDATA | %block; | %Inline.phrase; | exdent)*>
206<!ELEMENT display      (#PCDATA | %block; | %Inline.phrase; | exdent)*>
207<!ELEMENT smalldisplay (#PCDATA | %block; | %Inline.phrase; | exdent)*>
208<!ELEMENT center       (#PCDATA | %block; | %Inline.phrase; | exdent)*>
209<!ELEMENT group        (#PCDATA | %block; | %Inline.phrase; | exdent)*>
210
211<!ELEMENT image        (alttext)>
212<!ELEMENT alttext      (#PCDATA)>
213<!ATTLIST image
214            name      CDATA #REQUIRED
215            extension CDATA #REQUIRED
216            width     CDATA #REQUIRED
217            height    CDATA #REQUIRED>
218
219<!-- Whitespace in these elements are always preserved -->
220<!ATTLIST example      xml:space (preserve) #FIXED 'preserve'>
221<!ATTLIST smallexample xml:space (preserve) #FIXED 'preserve'>
222<!ATTLIST lisp         xml:space (preserve) #FIXED 'preserve'>
223<!ATTLIST smalllisp    xml:space (preserve) #FIXED 'preserve'>
224<!ATTLIST display      xml:space (preserve) #FIXED 'preserve'>
225<!ATTLIST smalldisplay xml:space (preserve) #FIXED 'preserve'>
226<!ATTLIST format       xml:space (preserve) #FIXED 'preserve'>
227<!ATTLIST smallformat  xml:space (preserve) #FIXED 'preserve'>
228
229<!ELEMENT verbatim     (#PCDATA)>
230<!ATTLIST verbatim     xml:space (preserve) #FIXED 'preserve'>
231
232<!ELEMENT para         (#PCDATA | %Inline.phrase; | footnote | %lang;)*>
233<!ATTLIST para
234          role CDATA #IMPLIED>
235
236<!ELEMENT menu (menuentry | detailmenu | para)*>
237<!ELEMENT detailmenu (menuentry | para)*>
238<!ELEMENT menuentry (menunode?, menutitle?, menucomment?)>
239<!ELEMENT menunode (#PCDATA)>
240<!ELEMENT menutitle (#PCDATA)>
241<!ELEMENT menucomment (#PCDATA | para)*>
242
243<!-- Floating displays -->
244<!ELEMENT float (floattype, floatpos, (%block;)*, caption?)>
245<!ATTLIST float
246          name CDATA #IMPLIED>
247<!ELEMENT floattype (#PCDATA)>
248<!ELEMENT floatpos (#PCDATA)>
249<!ELEMENT caption (#PCDATA | %Inline.phrase;)*>
250<!ELEMENT listoffloats EMPTY>
251<!ATTLIST listoffloats
252          type CDATA #IMPLIED>
253
254<!-- Lists -->
255<!ELEMENT itemize (itemfunction, (item | itemize | enumerate | indexterm)*)>
256<!ELEMENT enumerate (enumarg?, (item | itemize | enumerate)*)>
257<!ATTLIST enumerate
258          first CDATA #IMPLIED>
259
260<!ELEMENT item (%block;)*>
261<!ELEMENT enumarg (#PCDATA)>
262
263<!ELEMENT itemfunction (#PCDATA | %Inline.phrase;)*>
264
265<!-- Tables -->
266<!ELEMENT table (tableitem | indexterm)+>
267<!ELEMENT tableitem ((tableterm, indexterm*)+, item?)>
268<!ELEMENT tableterm (#PCDATA | %Inline.phrase;)*>
269
270<!ELEMENT multitable (columnfraction*, thead?, tbody)>
271<!ELEMENT columnfraction (#PCDATA)>
272<!ELEMENT thead (row+)>
273<!ELEMENT tbody (row+)>
274<!ELEMENT row (entry*)>
275<!ELEMENT entry (#PCDATA | %Inline.phrase;)*>
276
277<!-- API definitions -->
278<!ELEMENT definition (definitionterm | definitionitem)+>
279<!ELEMENT definitionterm (%definition.cmds; | indexterm)+>
280<!ELEMENT definitionitem (%block;)*>
281
282<!ELEMENT defcategory  (#PCDATA | %Inline.phrase; | footnote)*>
283<!ELEMENT deffunction  (#PCDATA | %Inline.phrase; | footnote)*>
284<!ELEMENT defvariable  (#PCDATA | %Inline.phrase; | footnote)*>
285<!ELEMENT defparam     (#PCDATA | %Inline.phrase; | footnote)*>
286<!ELEMENT defdelimiter (#PCDATA | %Inline.phrase; | footnote)*>
287<!ELEMENT deftype      (#PCDATA | %Inline.phrase; | footnote)*>
288<!ELEMENT defparamtype (#PCDATA | %Inline.phrase; | footnote)*>
289<!ELEMENT defdatatype  (#PCDATA | %Inline.phrase; | footnote)*>
290<!ELEMENT defclass     (#PCDATA | %Inline.phrase; | footnote)*>
291<!ELEMENT defclassvar  (#PCDATA | %Inline.phrase; | footnote)*>
292<!ELEMENT defoperation (#PCDATA | %Inline.phrase; | footnote)*>
293
294<!-- INLINE Elements -->
295<!-- *************** -->
296
297<!-- Emphasize -->
298<!ELEMENT strong (#PCDATA | %Inline.phrase;)*>
299<!ELEMENT emph   (#PCDATA | %Inline.phrase;)*>
300
301<!-- small caps -->
302<!ELEMENT sc (#PCDATA | %Inline.phrase;)*>
303
304<!-- fonts -->
305<!ELEMENT i  (#PCDATA | %Inline.phrase;)*>
306<!ELEMENT b  (#PCDATA | %Inline.phrase;)*>
307<!ELEMENT tt (#PCDATA | %Inline.phrase;)*>
308<!ELEMENT r  (#PCDATA | %Inline.phrase;)*>
309<!ELEMENT notfixedwidth (#PCDATA | %Inline.phrase;)*>
310<!ELEMENT titlefont   (#PCDATA | %Inline.phrase;)*>
311
312<!-- markup -->
313<!ELEMENT code    (#PCDATA | %Inline.phrase;)*>
314<!ELEMENT command (#PCDATA | %Inline.phrase;)*>
315<!ELEMENT env     (#PCDATA | %Inline.phrase;)*>
316<!ELEMENT file    (#PCDATA | %Inline.phrase;)*>
317<!ELEMENT option  (#PCDATA | %Inline.phrase;)*>
318<!ELEMENT samp    (#PCDATA | %Inline.phrase;)*>
319<!ELEMENT dfn     (#PCDATA | %Inline.phrase;)*>
320<!ELEMENT cite    (#PCDATA | %Inline.phrase;)*>
321<!ELEMENT key     (#PCDATA | %Inline.phrase;)*>
322<!ELEMENT kbd     (#PCDATA | %Inline.phrase;)*>
323<!ELEMENT var     (#PCDATA | %Inline.phrase;)*>
324<!ELEMENT url     (#PCDATA | %Inline.phrase;)*>
325
326<!ELEMENT acronym (acronymword, acronymdesc?)>
327<!ELEMENT acronymword (#PCDATA | %Inline.phrase;)*>
328<!ELEMENT acronymdesc (#PCDATA | %Inline.phrase;)*>
329
330<!ELEMENT abbrev (abbrevword, abbrevdesc?)>
331<!ELEMENT abbrevword (#PCDATA | %Inline.phrase;)*>
332<!ELEMENT abbrevdesc (#PCDATA | %Inline.phrase;)*>
333
334<!-- math -->
335<!ELEMENT math    (#PCDATA | %Inline.phrase;)*>
336
337<!-- reference -->
338<!ELEMENT anchor EMPTY>
339<!ATTLIST anchor
340          name CDATA #IMPLIED>
341
342<!ELEMENT xref (xrefnodename | xrefinfoname | xrefinfofile
343                | xrefprintedname | xrefprinteddesc)*>
344<!ELEMENT xrefnodename    (#PCDATA | %Inline.phrase;)*>
345<!ELEMENT xrefinfoname    (#PCDATA | %Inline.phrase;)*>
346<!ELEMENT xrefinfofile    (#PCDATA | %Inline.phrase;)*>
347<!ELEMENT xrefprintedname (#PCDATA | %Inline.phrase;)*>
348<!ELEMENT xrefprinteddesc (#PCDATA | %Inline.phrase;)*>
349
350<!ELEMENT inforef (inforefnodename | inforefrefname | inforefinfoname)*>
351<!ELEMENT inforefnodename (#PCDATA | %Inline.phrase;)*>
352<!ELEMENT inforefrefname  (#PCDATA | %Inline.phrase;)*>
353<!ELEMENT inforefinfoname (#PCDATA | %Inline.phrase;)*>
354
355<!ELEMENT indexterm (#PCDATA | %Inline.phrase;)*>
356<!ATTLIST indexterm
357          index CDATA #IMPLIED>
358
359<!ELEMENT email (emailaddress, emailname?)>
360<!ELEMENT emailaddress (#PCDATA | %Inline.phrase;)*>
361<!ELEMENT emailname (#PCDATA | %Inline.phrase;)*>
362
363<!ELEMENT uref (urefurl, urefdesc?, urefreplacement?)>
364<!ELEMENT urefurl         (#PCDATA | %Inline.phrase;)*>
365<!ELEMENT urefdesc        (#PCDATA | %Inline.phrase;)*>
366<!ELEMENT urefreplacement (#PCDATA | %Inline.phrase;)*>
367
368<!ELEMENT footnote (para)>
369
370
371<!ELEMENT neos      EMPTY>
372
373<!ENTITY tex        "TeX">        <!-- Should become an element. -->
374<!ENTITY latex      "LaTeX">      <!-- Should become an element. -->
375<!ENTITY ellipsis   "&#x2026;">
376<!ENTITY lt         "&#x3c;">
377<!ENTITY gt         "&#x3e;">
378<!ENTITY bullet     "&#x2022;">
379<!ENTITY copyright  "&#xa9;">
380<!ENTITY registered "&#xae;">
381<!ENTITY euro       "&#x20ac;">
382<!ENTITY pounds     "&#xa3;">
383<!ENTITY minus      "&#x2212;">
384<!ENTITY linebreak  "&#xa;">      <!-- Should become an element. -->
385<!ENTITY space      " ">          <!-- Should become an element. -->
386<!ENTITY dots       "&#x2026;<neos/>">
387<!ENTITY enddots    "&#x2026;">
388<!ENTITY amp        "&#x26;">
389<!ENTITY ldquo      "&#x201c;">
390<!ENTITY rdquo      "&#x201d;">
391<!ENTITY mdash      "&#x2014;">
392<!ENTITY ndash      "&#x2013;">
393<!ENTITY period     ".<neos/>">
394<!ENTITY eosperiod  ".">
395<!ENTITY quest      "?<neos/>">
396<!ENTITY eosquest   "?">
397<!ENTITY excl       "!<neos/>">
398<!ENTITY eosexcl    "!">
399
400<!ENTITY auml "&#xe4;">
401<!ENTITY ouml "&#xf6;">
402<!ENTITY uuml "&#xfc;">
403<!ENTITY Auml "&#xc4;">
404<!ENTITY Ouml "&#xd6;">
405<!ENTITY Uuml "&#xdc;">
406<!ENTITY Euml "&#xcb;">
407<!ENTITY euml "&#xeb;">
408<!ENTITY Iuml "&#xcf;">
409<!ENTITY iuml "&#xef;">
410<!ENTITY yuml "&#xff;">
411<!ENTITY uml  "&#xa8;">
412
413<!ENTITY Aacute "&#xc1;">
414<!ENTITY Eacute "&#xc9;">
415<!ENTITY Iacute "&#xcd;">
416<!ENTITY Oacute "&#xd3;">
417<!ENTITY Uacute "&#xda;">
418<!ENTITY Yacute "&#xdd;">
419<!ENTITY aacute "&#xe1;">
420<!ENTITY eacute "&#xe9;">
421<!ENTITY iacute "&#xed;">
422<!ENTITY oacute "&#xf3;">
423<!ENTITY uacute "&#xfa;">
424<!ENTITY yacute "&#xfd;">
425
426<!ENTITY ccedil "&#xe7;">
427<!ENTITY Ccedil "&#xc7;">
428
429<!ENTITY Acirc "&#xc2;">
430<!ENTITY Ecirc "&#xca;">
431<!ENTITY Icirc "&#xc3;">
432<!ENTITY Ocirc "&#xd4;">
433<!ENTITY Ucirc "&#xdb;">
434<!ENTITY acirc "&#xe2;">
435<!ENTITY ecirc "&#xea;">
436<!ENTITY icirc "&#xee;">
437<!ENTITY ocirc "&#xf4;">
438<!ENTITY ucirc "&#xfb;">
439
440<!ENTITY Agrave "&#xc0;">
441<!ENTITY Egrave "&#xc8;">
442<!ENTITY Igrave "&#xcc;">
443<!ENTITY Ograve "&#xd2;">
444<!ENTITY Ugrave "&#xd9;">
445<!ENTITY agrave "&#xe0;">
446<!ENTITY egrave "&#xe8;">
447<!ENTITY igrave "&#xec;">
448<!ENTITY ograve "&#xf2;">
449<!ENTITY ugrave "&#xf9;">
450
451<!ENTITY Atilde "&#xc3;">
452<!ENTITY Ntilde "&#xd1;">
453<!ENTITY Otilde "&#xd5;">
454<!ENTITY atilde "&#xe3;">
455<!ENTITY ntilde "&#xf1;">
456<!ENTITY otilde "&#xf5;">
457
458<!ENTITY oslash "&#xf8;">
459<!ENTITY Oslash "&#xd8;">
460
461<!ENTITY ordm "&#xba;">
462<!ENTITY ordf "&#xaa;">
463
464<!ENTITY iexcl "&#xa1;">
465<!ENTITY pound "&#xa3;">
466<!ENTITY iquest "&#xbf;">
467<!ENTITY AElig "&#xc6;">
468<!ENTITY aelig "&#xe6;">
469<!ENTITY OElig "&#x152;">
470<!ENTITY oelig "&#x153;">
471<!ENTITY Aring "&#xc5;">
472<!ENTITY aring "&#xe5;">
473<!ENTITY szlig "&#xdf;">
474
475<!ENTITY macr "&#xaf;">
476
477
478<!-- fixxme: not yet classified -->
479
480<!ELEMENT sp (#PCDATA)>
481<!ATTLIST sp
482          lines CDATA #IMPLIED>
483<!ELEMENT printindex (#PCDATA)>
484
485