← Back to branch summary

~clint-fewbar/ubuntu/precise/erlang/merge-15b

« back to all changes in this revision

Viewing changes to lib/docbuilder/doc/src/user_guide_dtds.xml

  • Committer: Package Import Robot
  • Author(s): Sergei Golovan
  • Date: 2011-12-15 19:20:10 UTC
  • mfrom: (1.1.18) (3.5.15 sid)
  • mto: (3.5.16 sid)
  • mto: This revision was merged to the branch mainline in revision 33.
  • Revision ID: package-import@ubuntu.com-20111215192010-jnxcfe3tbrpp0big
Tags: 1:15.b-dfsg-1
* New upstream release.
* Upload to experimental because this release breaks external drivers
  API along with ABI, so several applications are to be fixed.
* Removed SSL patch because the old SSL implementation is removed from
  the upstream distribution.
* Removed never used patch which added native code to erlang beam files.
* Removed the erlang-docbuilder binary package because the docbuilder
  application was dropped by upstream.
* Documented dropping ${erlang-docbuilder:Depends} substvar in
  erlang-depends(1) manpage.
* Made erlang-base and erlang-base-hipe provide virtual package
  erlang-abi-15.b (the number means the first erlang version, which
  provides current ABI).

Show diffs side-by-side

added added

removed removed

Lines of Context:
lib/docbuilder/doc/src/user_guide_dtds.xml
1
 
<?xml version="1.0" encoding="latin1" ?>
2
 
<!DOCTYPE chapter SYSTEM "chapter.dtd">
3
 
 
4
 
<chapter>
5
 
  <header>
6
 
    <copyright>
7
 
      <year>1997</year><year>2009</year>
8
 
      <holder>Ericsson AB. All Rights Reserved.</holder>
9
 
    </copyright>
10
 
    <legalnotice>
11
 
      The contents of this file are subject to the Erlang Public License,
12
 
      Version 1.1, (the "License"); you may not use this file except in
13
 
      compliance with the License. You should have received a copy of the
14
 
      Erlang Public License along with this software. If not, it can be
15
 
      retrieved online at http://www.erlang.org/.
16
 
    
17
 
      Software distributed under the License is distributed on an "AS IS"
18
 
      basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
19
 
      the License for the specific language governing rights and limitations
20
 
      under the License.
21
 
    
22
 
    </legalnotice>
23
 
 
24
 
    <title>User's Guide DTDs</title>
25
 
    <prepared></prepared>
26
 
    <docno></docno>
27
 
    <date></date>
28
 
    <rev></rev>
29
 
    <file>user_guide_dtds.xml</file>
30
 
  </header>
31
 
 
32
 
  <section>
33
 
    <marker id="partDTD"></marker>
34
 
    <title>The part DTD</title>
35
 
 
36
 
    <p>The <c>part</c> DTD is intended for a "normal" document, like
37
 
      the User's Guide or Release Notes. First are some paragraphs
38
 
      introducing the main contents. After that follows chapters,
39
 
      written in separate files with
40
 
      the <seealso marker="#chapterDTD">chapter</seealso> DTD.</p>
41
 
 
42
 
    <p>Example:</p>
43
 
    <pre>
44
 
&lt;?xml version="1.0" encoding="latin1" ?>
45
 
&lt;!DOCTYPE part SYSTEM "part.dtd"&gt;
46
 
&lt;part&gt;
47
 
  &lt;header&gt;
48
 
    &lt;title&gt;The chapter title&lt;/title&gt;
49
 
    &lt;prepared&gt;The author&lt;/prepared&gt;
50
 
    &lt;docno/&gt;
51
 
    &lt;date/&gt;
52
 
    &lt;rev/&gt;
53
 
  &lt;/header&gt;
54
 
 
55
 
  &lt;description&gt;
56
 
    &lt;p&gt;Some text..&lt;/p&gt;
57
 
  &lt;/description&gt;
58
 
 
59
 
  &lt;include file="file1"&gt;&lt;/include&gt;
60
 
  &lt;include file="file2"&gt;&lt;/include&gt;
61
 
&lt;/part&gt;
62
 
    </pre>
63
 
  </section>
64
 
 
65
 
  <section>
66
 
    <marker id="partTAG"></marker>
67
 
    <title>&lt;part></title>
68
 
 
69
 
    <p>The top level tag of a <c>part</c> DTD.</p>
70
 
 
71
 
    <p>Contains a
72
 
      <seealso marker="header_tags">&lt;header&gt;</seealso>,
73
 
      an optional
74
 
      <seealso marker="#descriptionTAG">&lt;description&gt;</seealso>,
75
 
      followed by one or more
76
 
      <seealso marker="#includeTAG">&lt;include&gt;</seealso>.</p>
77
 
  </section>
78
 
 
79
 
  <section>
80
 
    <marker id="descriptionTAG"/>
81
 
    <title>&lt;description&gt;</title>
82
 
 
83
 
    <p>The introduction after the title and before the bulk of
84
 
      included chapters/manual pages.</p>
85
 
 
86
 
    <p>Contains any combination and any number
87
 
      of <seealso marker="block_tags">block tags</seealso> except
88
 
      <c><![CDATA[<image>]]></c> and <c><![CDATA[<table>]]></c>.</p>
89
 
  </section>
90
 
 
91
 
  <section>
92
 
    <marker id="includeTAG"></marker>
93
 
    <title>&lt;include&gt;</title>
94
 
 
95
 
    <p>An empty tag. The attribute <c>file</c> specifies a file to
96
 
      include. The <c>.xml</c> file extension should be omitted.</p>
97
 
 
98
 
    <p>Example:</p>
99
 
    <pre>
100
 
&lt;include file="notes">&lt;/include>
101
 
    </pre>
102
 
  </section>
103
 
 
104
 
  <section>
105
 
    <marker id="chapterDTD"></marker>
106
 
    <title>The chapter DTD</title>
107
 
 
108
 
    <p>The <c>chapter</c> DTD is intended for a chapter in a User's
109
 
      Guide or similar with text divided into sections, which can be
110
 
      nested.</p>
111
 
 
112
 
    <p>Example:</p>
113
 
    <pre>
114
 
&lt;?xml version="1.0" encoding="latin1" ?>
115
 
&lt;!DOCTYPE chapter SYSTEM "chapter.dtd">
116
 
&lt;chapter>
117
 
  &lt;header>
118
 
    &lt;title>Title on first level&lt;/title>
119
 
    &lt;prepared/>
120
 
    &lt;docno/>
121
 
    &lt;date/>
122
 
    &lt;rev/>
123
 
  &lt;/header>
124
 
  
125
 
  &lt;p>Introduction...&lt;/p>
126
 
 
127
 
  &lt;section>
128
 
    &lt;title>Title on second level&lt;/title>
129
 
 
130
 
    &lt;p>First paragraph.&lt;/p>
131
 
 
132
 
    &lt;p>Second paragraph etc.&lt;/p>
133
 
 
134
 
    &lt;section>
135
 
      &lt;title>Title on third level&lt;/title>
136
 
 
137
 
      &lt;p>...&lt;/p>
138
 
    &lt;/section>
139
 
  &lt;/section>
140
 
 
141
 
  ...
142
 
&lt;/chapter>
143
 
    </pre>
144
 
  </section>
145
 
 
146
 
  <section>
147
 
    <marker id="chapterTAG"></marker>
148
 
    <title>&lt;chapter&gt;</title>
149
 
 
150
 
    <p>The top level tag of a <c>chapter</c> DTD.</p>
151
 
 
152
 
    <p>Contains a
153
 
      <seealso marker="header_tags">&lt;header&gt;</seealso>,
154
 
      an optional introduction consisting of any combination of
155
 
      <seealso marker="block_tags">block tags</seealso>,
156
 
      followed by one or more
157
 
      <seealso marker="#sectionTAG">&lt;section&gt;</seealso>.</p>
158
 
  </section>
159
 
 
160
 
  <section>
161
 
    <marker id="sectionTAG"></marker>
162
 
    <title>&lt;section&gt;</title>
163
 
 
164
 
    <p>Subdivision of a chapter.</p>
165
 
 
166
 
    <p>Contains an optional
167
 
      <seealso marker="inline_tags#markerTAG">&lt;marker&gt;</seealso>,
168
 
      a <seealso marker="#titleTAG">&lt;title&gt;</seealso>,
169
 
      followed by any combination and any number of
170
 
      <seealso marker="block_tags">block tags</seealso> and
171
 
      <c><![CDATA[<section>]]></c>.</p>
172
 
  </section>
173
 
 
174
 
  <section>
175
 
    <marker id="titleTAG"></marker>
176
 
    <title>&lt;title&gt;</title>
177
 
 
178
 
    <p>Section title, contains plain text.</p>
179
 
  </section>
180
 
</chapter>
181