~ubuntu-branches/ubuntu/feisty/apache2/feisty

« back to all changes in this revision

Viewing changes to docs/manual/style/latex/synopsis.xsl

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Barth
  • Date: 2006-12-09 21:05:45 UTC
  • mfrom: (0.6.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20061209210545-h70s0xaqc2v8vqr2
Tags: 2.2.3-3.2
* Non-maintainer upload.
* 043_ajp_connection_reuse: Patch from upstream Bugzilla, fixing a critical
  issue with regard to connection reuse in mod_proxy_ajp.
  Closes: #396265

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0"?>
 
2
 
 
3
<!--
 
4
 Licensed to the Apache Software Foundation (ASF) under one or more
 
5
 contributor license agreements.  See the NOTICE file distributed with
 
6
 this work for additional information regarding copyright ownership.
 
7
 The ASF licenses this file to You under the Apache License, Version 2.0
 
8
 (the "License"); you may not use this file except in compliance with
 
9
 the License.  You may obtain a copy of the License at
 
10
 
 
11
     http://www.apache.org/licenses/LICENSE-2.0
 
12
 
 
13
 Unless required by applicable law or agreed to in writing, software
 
14
 distributed under the License is distributed on an "AS IS" BASIS,
 
15
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 
16
 See the License for the specific language governing permissions and
 
17
 limitations under the License.
 
18
-->
 
19
 
 
20
<xsl:stylesheet version="1.0"
 
21
              xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 
22
                  xmlns="http://www.w3.org/1999/xhtml">
 
23
 
 
24
 
 
25
<!-- ==================================================================== -->
 
26
<!-- <modulesynopsis>                                                     -->
 
27
<!-- ==================================================================== -->
 
28
 
 
29
<xsl:template match="modulesynopsis">
 
30
 
 
31
<xsl:text>\section{</xsl:text>
 
32
<xsl:choose>
 
33
  <xsl:when test="../status='Core'">
 
34
    <xsl:value-of select="$message[@id='apachecore']" />
 
35
  </xsl:when>
 
36
  <xsl:when test=".='mpm_common'">
 
37
    <xsl:value-of select="$message[@id='apachempmcommon']" />
 
38
  </xsl:when>
 
39
  <xsl:when test="../status='MPM'">
 
40
    <xsl:value-of select="$message[@id='apachempm']" />
 
41
    <xsl:text> </xsl:text>
 
42
    <xsl:apply-templates select="name"/>
 
43
  </xsl:when>
 
44
  <xsl:otherwise>
 
45
    <xsl:value-of select="$message[@id='apachemodule']" />
 
46
    <xsl:text> </xsl:text>
 
47
    <xsl:apply-templates select="name"/>
 
48
  </xsl:otherwise>
 
49
</xsl:choose>
 
50
<xsl:text>}\label{</xsl:text>
 
51
<xsl:value-of select="concat('/mod/',name)"/>
 
52
<xsl:text>}\hypertarget{</xsl:text>
 
53
<xsl:value-of select="concat('/mod/',name)"/>
 
54
<xsl:text>}{}</xsl:text>
 
55
 
 
56
<xsl:text>
 
57
\begin{tabular}{lp{.75\linewidth}}
 
58
\hline
 
59
</xsl:text>
 
60
<xsl:value-of select="$message[@id='description']" />
 
61
<xsl:text>: &amp;</xsl:text> 
 
62
<xsl:apply-templates select="description" />
 
63
<xsl:text>\\
 
64
</xsl:text>
 
65
 
 
66
<xsl:value-of select="$message[@id='status']" />
 
67
<xsl:text>: &amp;</xsl:text>
 
68
<xsl:value-of select="status" />
 
69
<xsl:text>\\
 
70
</xsl:text>
 
71
 
 
72
<xsl:if test="identifier">
 
73
<xsl:value-of select="$message[@id='moduleidentifier']" />
 
74
<xsl:text>: &amp;</xsl:text>
 
75
<xsl:apply-templates select="identifier" />
 
76
<xsl:text>\\
 
77
</xsl:text>
 
78
</xsl:if>
 
79
 
 
80
<xsl:if test="sourcefile">
 
81
<xsl:value-of select="$message[@id='sourcefile']" />
 
82
<xsl:text>: &amp;</xsl:text>
 
83
<xsl:apply-templates select="sourcefile" />
 
84
<xsl:text>\\
 
85
</xsl:text>
 
86
</xsl:if>
 
87
 
 
88
<xsl:if test="compatibility">
 
89
<xsl:value-of select="$message[@id='compatibility']" />
 
90
<xsl:text>: &amp;</xsl:text>
 
91
<xsl:apply-templates select="compatibility" />
 
92
<xsl:text> \\
 
93
</xsl:text>
 
94
</xsl:if>
 
95
<xsl:text>\hline \end{tabular}
 
96
</xsl:text>
 
97
    <!-- Summary of module features/usage (1 to 3 paragraphs, -->
 
98
    <!-- optional)                                            -->
 
99
    <xsl:if test="summary">
 
100
      <xsl:text>\subsection*{</xsl:text>
 
101
      <xsl:value-of select="$message[@id='summary']" />
 
102
      <xsl:text>}
 
103
</xsl:text>
 
104
      <xsl:apply-templates select="summary" />
 
105
     </xsl:if>
 
106
 
 
107
     <xsl:text>
 
108
\smallskip\textbf{</xsl:text>
 
109
     <xsl:value-of select="$message[@id='directives']" />
 
110
     <xsl:text>}
 
111
</xsl:text>
 
112
 
 
113
     <xsl:choose>
 
114
     <xsl:when test="directivesynopsis">
 
115
       <xsl:text>\begin{itemize}</xsl:text>
 
116
       <xsl:for-each select="directivesynopsis">
 
117
         <xsl:sort select="name" />
 
118
         <xsl:text>\item </xsl:text>
 
119
         <xsl:if test="@type='section'">
 
120
           <xsl:text>\textless{}</xsl:text>
 
121
         </xsl:if>
 
122
         <xsl:apply-templates select="name" mode="simple"/>
 
123
         <xsl:if test="@type='section'">
 
124
           <xsl:text>\textgreater{}</xsl:text>
 
125
         </xsl:if>
 
126
         <xsl:if test="@location">
 
127
           <xsl:variable name="lowerlocation"
 
128
            select="translate(@location, $uppercase, $lowercase)" />
 
129
           <xsl:text> (p.\ \pageref{/mod/</xsl:text>
 
130
           <xsl:value-of select="concat(translate(@location,$uppercase,$lowercase),':',translate(name,$uppercase,$lowercase))"/>
 
131
           <xsl:text>}) </xsl:text>
 
132
         </xsl:if>
 
133
         <xsl:text>
 
134
</xsl:text>
 
135
       </xsl:for-each>
 
136
       <xsl:text>\end{itemize}
 
137
</xsl:text>
 
138
     </xsl:when>
 
139
     <xsl:otherwise>
 
140
       <xsl:value-of select="$message[@id='nodirectives']" />
 
141
     <xsl:text>
 
142
</xsl:text>
 
143
     </xsl:otherwise>
 
144
     </xsl:choose>
 
145
 
 
146
     <xsl:text>
 
147
</xsl:text>
 
148
 
 
149
<xsl:call-template name="seealso"/>
 
150
 
 
151
     <!-- Sections of documentation about the module as a whole -->
 
152
       <xsl:apply-templates select="section" />
 
153
 
 
154
     <!-- Directive documentation -->
 
155
       <xsl:apply-templates select="directivesynopsis">
 
156
         <xsl:sort select="name" />
 
157
       </xsl:apply-templates>
 
158
 
 
159
</xsl:template>
 
160
<!-- /modulesynopsis -->
 
161
 
 
162
 
 
163
<!-- ==================================================================== -->
 
164
<!-- Directivesynopsis                                                    -->
 
165
<!-- ==================================================================== -->
 
166
<xsl:template match="directivesynopsis/name" mode="simple" name="simpledirname">
 
167
<xsl:if test="@type='section'"><xsl:text>\textless{}</xsl:text></xsl:if>
 
168
<xsl:apply-templates/>
 
169
<xsl:if test="@type='section'"><xsl:text>\textgreater{}</xsl:text></xsl:if>
 
170
</xsl:template>
 
171
 
 
172
<xsl:template match="directivesynopsis/name">
 
173
<xsl:text>\subsection*{</xsl:text>
 
174
<xsl:call-template name="simpledirname"/>
 
175
  <xsl:choose>
 
176
  <xsl:when test="$message[@id='directive']/@replace-space-with">
 
177
    <xsl:value-of select="$message[@id='directive']/@replace-space-with"/>
 
178
  </xsl:when>
 
179
  <xsl:otherwise>
 
180
    <xsl:text> </xsl:text>
 
181
  </xsl:otherwise>
 
182
  </xsl:choose>
 
183
 
 
184
<xsl:value-of select="$message[@id='directive']" />
 
185
<xsl:text>}\label{</xsl:text>
 
186
<xsl:value-of select="concat('/mod/', //modulesynopsis/name, ':', translate(., $uppercase, $lowercase))"/>
 
187
<xsl:text>}\hypertarget{</xsl:text>
 
188
<xsl:value-of select="concat('/mod/', //modulesynopsis/name, ':', translate(., $uppercase, $lowercase))"/>
 
189
<xsl:text>}{}</xsl:text>
 
190
 
 
191
</xsl:template>
 
192
 
 
193
<xsl:template match="directivesynopsis">
 
194
<xsl:if test="not(@location)">
 
195
  <xsl:apply-templates select="name"/>
 
196
  <!-- Directive header -->
 
197
  <xsl:text>
 
198
\begin{tabular}{lp{.8\linewidth}}
 
199
\hline
 
200
</xsl:text>
 
201
<xsl:value-of select="$message[@id='description']" />
 
202
<xsl:text>: &amp; </xsl:text>
 
203
<xsl:apply-templates select="description" />
 
204
<xsl:text>\\
 
205
</xsl:text>
 
206
 
 
207
<xsl:value-of select="$message[@id='syntax']" />
 
208
<xsl:text>: &amp; {\ttfamily </xsl:text>
 
209
<xsl:apply-templates select="syntax" />
 
210
<xsl:text>}\\
 
211
</xsl:text>
 
212
 
 
213
<xsl:if test="default">
 
214
<xsl:value-of select="$message[@id='default']" />
 
215
<xsl:text>: &amp; {\ttfamily </xsl:text>
 
216
<xsl:apply-templates select="default" />
 
217
<xsl:text>} \\
 
218
</xsl:text>
 
219
</xsl:if>
 
220
 
 
221
<xsl:value-of select="$message[@id='context']" />
 
222
<xsl:text>: &amp;</xsl:text>
 
223
<xsl:apply-templates select="contextlist" />
 
224
<xsl:text> \\
 
225
</xsl:text>
 
226
 
 
227
<xsl:if test="override">
 
228
<xsl:value-of select="$message[@id='override']"/>
 
229
<xsl:text>: &amp;</xsl:text>
 
230
<xsl:apply-templates select="override" />
 
231
<xsl:text> \\
 
232
</xsl:text>
 
233
</xsl:if>
 
234
 
 
235
<xsl:value-of select="$message[@id='status']" />
 
236
<xsl:text>: &amp;</xsl:text>
 
237
<xsl:value-of select="../status" />
 
238
<xsl:text> \\
 
239
</xsl:text>
 
240
 
 
241
<xsl:value-of select="$message[@id='module']" />
 
242
<xsl:text>: &amp;</xsl:text>
 
243
<xsl:choose>
 
244
<xsl:when test="modulelist">
 
245
  <xsl:apply-templates select="modulelist" />
 
246
</xsl:when>
 
247
<xsl:otherwise>
 
248
  <xsl:apply-templates select="../name" />
 
249
</xsl:otherwise>
 
250
</xsl:choose>
 
251
<xsl:text> \\
 
252
</xsl:text>
 
253
 
 
254
<xsl:if test="compatibility">
 
255
<xsl:value-of select="$message[@id='compatibility']" />
 
256
<xsl:text>: &amp;</xsl:text>
 
257
<xsl:apply-templates select="compatibility" />
 
258
<xsl:text> \\
 
259
</xsl:text>
 
260
</xsl:if>
 
261
 
 
262
<xsl:text>\hline
 
263
\end{tabular}
 
264
 
 
265
</xsl:text>
 
266
 
 
267
<xsl:apply-templates select="usage" />
 
268
 
 
269
<xsl:call-template name="seealso"/>
 
270
 
 
271
</xsl:if> <!-- /not(@location) -->
 
272
</xsl:template>
 
273
<!-- /directivesynopsis -->
 
274
 
 
275
 
 
276
<!-- ==================================================================== -->
 
277
<!-- <contextlist>                                                        -->
 
278
<!-- ==================================================================== -->
 
279
<xsl:template match="contextlist">
 
280
<xsl:apply-templates select="context" />
 
281
</xsl:template>
 
282
<!-- /contextlist -->
 
283
 
 
284
 
 
285
<!-- ==================================================================== -->
 
286
<!-- <context>                                                            -->
 
287
<!-- Each entry is separeted with a comma                                 -->
 
288
<!-- ==================================================================== -->
 
289
<xsl:template match="context">
 
290
<xsl:choose>
 
291
<xsl:when test="normalize-space(.) = 'server config'">
 
292
    <xsl:value-of select="$message[@id='serverconfig']" />
 
293
</xsl:when>
 
294
<xsl:when test="normalize-space(.) = 'virtual host'">
 
295
    <xsl:value-of select="$message[@id='virtualhost']" />
 
296
</xsl:when>
 
297
<xsl:when test="normalize-space(.) = 'directory'">
 
298
    <xsl:value-of select="$message[@id='directory']" />
 
299
</xsl:when>
 
300
<xsl:when test="normalize-space(.) = '.htaccess'">
 
301
    <xsl:value-of select="$message[@id='htaccess']" />
 
302
</xsl:when>
 
303
<xsl:otherwise> <!-- error -->
 
304
    <xsl:message terminate="yes">
 
305
        unknown context: <xsl:value-of select="." />
 
306
    </xsl:message>
 
307
</xsl:otherwise>
 
308
</xsl:choose>
 
309
 
 
310
<xsl:if test="position() != last()">
 
311
    <xsl:text>, </xsl:text>
 
312
</xsl:if>
 
313
</xsl:template>
 
314
<!-- /context -->
 
315
 
 
316
 
 
317
<!-- ==================================================================== -->
 
318
<!-- <modulelist>                                                         -->
 
319
<!-- ==================================================================== -->
 
320
<xsl:template match="modulelist">
 
321
<xsl:for-each select="module">
 
322
    <xsl:call-template name="module" />
 
323
    <xsl:if test="position() != last()">
 
324
        <xsl:text>, </xsl:text>
 
325
    </xsl:if>
 
326
</xsl:for-each>
 
327
</xsl:template>
 
328
<!-- /modulelist -->
 
329
 
 
330
 
 
331
<!-- ==================================================================== -->
 
332
<!-- modulesynopsis/compatibility                                         -->
 
333
<!-- ==================================================================== -->
 
334
<xsl:template match="modulesynopsis/compatibility">
 
335
<xsl:apply-templates />
 
336
</xsl:template>
 
337
 
 
338
 
 
339
<!-- ==================================================================== -->
 
340
<!-- directivesynopsis/compatibility                                      -->
 
341
<!-- ==================================================================== -->
 
342
<xsl:template match="directivesynopsis/compatibility">
 
343
<xsl:apply-templates />
 
344
</xsl:template>
 
345
 
 
346
</xsl:stylesheet>