A bunch of little latex-related updates:

- Increase the inter-list-item spacing a little.

- Decrease the font-size used in examples by one notch (\small).

- Use regular paragraph formatting in the directive synopsis
table cells rather than a minipage.

- Add links to <directive> and <module> (online only, not page numbers)

- Fix the space missing in the directive titles.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@100206 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/style/latex/common.xsl b/docs/manual/style/latex/common.xsl
index 47070da7cfb7bd1a49837b6fc6d865ce88597d5c..8a6d09792e9929d2e3cc4d14c8642b75710d47bb 100644 (file)
--- a/docs/manual/style/latex/common.xsl
+++ b/docs/manual/style/latex/common.xsl
@@ -63,7 +63,7 @@ select="$metafile/basename"/>
 <xsl:if test="not(pre)"><xsl:text>\fbox{</xsl:text></xsl:if>
 <xsl:text>\begin{minipage}{.8\textwidth}\begin{flushleft}</xsl:text>
 <xsl:apply-templates select="title" mode="print" />
-<xsl:if test="not(pre)"><xsl:text>{\ttfamily </xsl:text></xsl:if>
+<xsl:if test="not(pre)"><xsl:text>{\ttfamily\small </xsl:text></xsl:if>
 <xsl:text>\noindent </xsl:text><xsl:apply-templates/>
 <xsl:if test="not(pre)"><xsl:text>}</xsl:text></xsl:if>
 <xsl:text>\end{flushleft}\end{minipage}</xsl:text>
@@ -114,9 +114,15 @@ select="$metafile/basename"/>
 <!-- ==================================================================== -->
 <xsl:template match="directive" name="directive">
 <xsl:text>\textsc{</xsl:text>
-        <xsl:if test="@type='section'">\textless{}</xsl:if>
+   <xsl:if test="@type='section'"><xsl:text>\textless{}</xsl:text></xsl:if>
+   <xsl:text>\hyperlink{/mod/</xsl:text>
+   <xsl:value-of select="@module"/>
+   <xsl:text>:</xsl:text>
+   <xsl:value-of select="translate(.,$uppercase,$lowercase)"/>
+   <xsl:text>}{</xsl:text>
         <xsl:apply-templates/>
-        <xsl:if test="@type='section'">\textgreater{}</xsl:if>
+   <xsl:text>}</xsl:text>
+   <xsl:if test="@type='section'"><xsl:text>\textgreater{}</xsl:text></xsl:if>
 <xsl:text>}</xsl:text>
 </xsl:template>
 <!-- /directive -->
@@ -126,8 +132,11 @@ select="$metafile/basename"/>
 <!-- Inserts a link to refereed module                                    -->
 <!-- ==================================================================== -->
 <xsl:template match="module" name="module">
-<xsl:text>\textsc{</xsl:text>
+<xsl:text>\textsc{\hyperlink{/mod/</xsl:text>
+  <xsl:value-of select="."/>
+  <xsl:text>}{</xsl:text>
     <xsl:apply-templates/>
+  <xsl:text>}</xsl:text>
 <xsl:text>}</xsl:text>
 </xsl:template>
 <!-- /module -->

diff --git a/docs/manual/style/latex/latex.xsl b/docs/manual/style/latex/latex.xsl
index 574669c109e694b7825aaa549b483c2706ed67fc..59fe4753bcc884d6517de945dc83e9e95d46d67e 100644 (file)
--- a/docs/manual/style/latex/latex.xsl
+++ b/docs/manual/style/latex/latex.xsl
@@ -35,7 +35,7 @@
 \addtolength{\parskip}{1.2ex}
 
 % Shrink the inter-item spaces
-\AfterBegin{itemize}{\addtolength{\itemsep}{-.8\baselineskip}}
+\AfterBegin{itemize}{\addtolength{\itemsep}{-.6\baselineskip}}
 
 \pagestyle{headings}
 

diff --git a/docs/manual/style/latex/synopsis.xsl b/docs/manual/style/latex/synopsis.xsl
index 255d87b3107fb5b9e5e65fb05b569220dea43583..395f5291e9958c5d809a4a79939dc968c4144556 100644 (file)
--- a/docs/manual/style/latex/synopsis.xsl
+++ b/docs/manual/style/latex/synopsis.xsl
@@ -31,8 +31,9 @@
 </xsl:choose>
 <xsl:text>}\label{</xsl:text>
 <xsl:value-of select="concat('/mod/',name)"/>
-<xsl:text>}
-</xsl:text>
+<xsl:text>}\hypertarget{</xsl:text>
+<xsl:value-of select="concat('/mod/',name)"/>
+<xsl:text>}{}</xsl:text>
 
 <xsl:text>
 \begin{tabular}{lp{.75\linewidth}}
@@ -164,13 +165,24 @@
 <xsl:template match="directivesynopsis/name">
 <xsl:text>\subsection*{</xsl:text>
 <xsl:call-template name="simpledirname"/>
-  <xsl:value-of select="$messages/message
-    [@name='directive']/@replace-space-with"/>
+  <xsl:choose>
+  <xsl:when test="$messages/message
+      [@name='directive']/@replace-space-with">
+    <xsl:value-of select="$messages/message
+        [@name='directive']/@replace-space-with"/>
+  </xsl:when>
+  <xsl:otherwise>
+    <xsl:text> </xsl:text>
+  </xsl:otherwise>
+  </xsl:choose>
+
 <xsl:value-of select="$messages/message[@name='directive']" />
 <xsl:text>}\label{</xsl:text>
 <xsl:value-of select="concat('/mod/', //modulesynopsis/name, ':', translate(., $uppercase, $lowercase))"/>
-<xsl:text>}
-</xsl:text>
+<xsl:text>}\hypertarget{</xsl:text>
+<xsl:value-of select="concat('/mod/', //modulesynopsis/name, ':', translate(., $uppercase, $lowercase))"/>
+<xsl:text>}{}</xsl:text>
+
 </xsl:template>
 
 <xsl:template match="directivesynopsis">
@@ -182,22 +194,22 @@
 \hline
 </xsl:text>
 <xsl:value-of select="$messages/message [@name='description']" />
-<xsl:text>: &amp; \begin{minipage}{.8\linewidth}</xsl:text>
+<xsl:text>: &amp; </xsl:text>
 <xsl:apply-templates select="description" />
-<xsl:text>\end{minipage} \\
+<xsl:text>\\
 </xsl:text>
 
 <xsl:value-of select="$messages/message[@name='syntax']" />
-<xsl:text>: &amp; \begin{minipage}{.8\linewidth}{\ttfamily </xsl:text>
+<xsl:text>: &amp; {\ttfamily </xsl:text>
 <xsl:apply-templates select="syntax" />
-<xsl:text>}\end{minipage} \\
+<xsl:text>}\\
 </xsl:text>
 
 <xsl:if test="default">
 <xsl:value-of select="$messages/message[@name='default']" />
-<xsl:text>: &amp; \begin{minipage}{.8\linewidth}{\ttfamily </xsl:text>
+<xsl:text>: &amp; {\ttfamily </xsl:text>
 <xsl:apply-templates select="default" />
-<xsl:text>}\end{minipage} \\
+<xsl:text>} \\
 </xsl:text>
 </xsl:if>
 
@@ -253,7 +265,6 @@
 <xsl:text>\textbf{</xsl:text>
 <xsl:value-of select="$messages/message[@name='seealso']" />
 <xsl:text>}
-
 \begin{itemize}
 </xsl:text>
 <xsl:for-each select="seealso">