1<!-- tcldoc-1.0.dtd -
2   -
3   -	Customisation of DocBook for Tcl documentation.
4   -
5   - Copyright (c) 2000 Zveno Pty Ltd
6   -
7   - $Id: tcldoc-1.0.dtd,v 1.2 2002/06/11 13:37:45 balls Exp $
8 -->
9
10<!-- Define overriding entities here -->
11
12<!ENTITY % common.attrib "">
13
14<!ENTITY % local.para.mix "|tclpackage|tclnamespace">
15<!ENTITY % local.refcomponent.mix "|tclcmdsynopsis|tclpkgsynopsis|tclnamespacesynopsis">
16<!ENTITY % local.synop.class "|tclcmdsynopsis">
17
18<!ENTITY % local.tech.char.class "|tclcommand">
19
20<!-- Import the DocBook DTD -->
21
22<!ENTITY % DocBook 
23	PUBLIC "-//Norman Walsh//DTD DocBk XML V4.1.2//EN" 
24	       "file:///usr/local/share/xml/docbook/dtd/docbookx.dtd">
25%DocBook;
26
27<!--
28   - Tcl documentation is written as a DocBook RefEntry.
29   - RefEntry includes a number of elements to represent
30   - commands, functions, options, etc.  For system-related
31   - concepts, these are used as-is.  However, the elements 
32   - below are used to distinguish Tcl-related concepts.
33   -
34   - In addition, XLink may be used for hyperlinking.
35 -->
36
37<!-- tclcmdsynopsis -
38   -
39   -	Information about a Tcl command.
40   -	Content is taken to be Tcl commands, options, etc.
41   -
42  -->
43
44<!ELEMENT tclcmdsynopsis ((command | arg | group | sbr)+, synopfragment*)>
45<!ATTLIST tclcmdsynopsis
46	%cmdsynopsis.role.attrib;
47	%common.attrib;>
48
49<!-- tclpkgsynopsis -
50   -
51   -	Tcl Package usage synopsis.
52   -
53  -->
54
55<!ELEMENT tclpkgsynopsis ((package | version)+, synopfragment*)>
56<!ATTLIST tclpkgsynopsis
57	%cmdsynopsis.role.attrib;
58	%common.attrib;>
59
60<!ELEMENT package (#PCDATA)>
61<!ATTLIST package
62	%common.attrib;>
63
64<!ELEMENT version (#PCDATA)>
65<!ATTLIST version
66	%common.attrib;>
67
68<!ELEMENT tclpackage (#PCDATA)>
69<!ATTLIST tclpackage
70	%common.attrib;>
71
72<!-- tclnamespacesynopsis -
73   -
74   -	Tcl namespace usage synopsis.
75   -
76  -->
77
78<!ELEMENT tclnamespacesynopsis (tclnamespace+, synopfragment*)>
79<!ATTLIST tclnamespacesynopsis
80	%cmdsynopsis.role.attrib;
81	%common.attrib;>
82
83<!ELEMENT tclnamespace (#PCDATA)>
84<!ATTLIST tclnamespace
85	%common.attrib;>
86
87<!-- tcloptionsynopsis -
88   -
89   -	Tcl command configuration option synopsis.
90   -
91  -->
92
93<!ELEMENT tcloptionsynopsis ((option | arg | group | sbr)+, synopfragment*)>
94<!ATTLIST tcloptionsynopsis
95	%cmdsynopsis.role.attrib;
96	%common.attrib;>
97
98<!-- tclcommand -
99   -
100   -	A Tcl command, derived from DocBook's command.
101   -
102  -->
103
104<!ELEMENT tclcommand (%cptr.char.mix;)*>
105<!ATTLIST tclcommand
106	%moreinfo.attrib;
107	%command.role.attrib;
108	%common.attrib;>
109