Changeset 76704 in vbox for trunk/doc

Timestamp:

Jan 8, 2019 12:48:01 PM (6 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

128015

Message:

doc/manual: use the appropriate markup for the Preface, and make sure that the sections in it are unnumbered (a bit incomplete for the HTML/... case, but can be improved later), important fix for HTML manual as it restores the validity of the (per chapter) links to the HTML manual.

Location:

trunk/doc/manual

Files:

• common-formatcfg.xsl (modified) (1 diff)
• docbook2latex.xsl (modified) (1 diff)
• en_US/user_Preface.xml (modified) (2 diffs)

trunk/doc/manual/common-formatcfg.xsl

@@ -72 +72 @@
 
 <!--
+  Make sure that sections inside the Preface are not numbered.
+  -->
+<xsl:template match="preface/sect1" mode="object.title.template">
+  <xsl:call-template name="gentext.template">
+    <xsl:with-param name="context" select="'title-unnumbered'"/>
+    <xsl:with-param name="name">
+      <xsl:call-template name="xpath.location"/>
+    </xsl:with-param>
+  </xsl:call-template>
+</xsl:template>
+
+<!--
   refentry related layout tweaks.
 

trunk/doc/manual/docbook2latex.xsl

@@ -331 +331 @@
       <xsl:when test="name(..)='chapter'">
         <xsl:call-template name="title-wrapper"/>
+      </xsl:when>
+      <xsl:when test="name(..)='preface'">
+        <xsl:call-template name="title-wrapper">
+          <xsl:with-param name="texcmd">\chapter</xsl:with-param>
+        </xsl:call-template>
       </xsl:when>
       <xsl:when test="name(..)='sect1' and ../../@role='frontmatter'">

trunk/doc/manual/en_US/user_Preface.xml

@@ -6 +6 @@
   %all.entities;
 ]>
-<chapter id="user-preface" role="frontmatter">
+<preface id="user-preface" role="frontmatter">
 
   <title>Preface</title>
@@ -106 +106 @@
   </sect1>
 
-</chapter>
+</preface>