Changeset 99513 in vbox for trunk/doc/manual/docbook-refentry-to-H-help.xsl

Timestamp:

Apr 21, 2023 9:59:02 PM (20 months ago)

Author:

vboxsync

Message:

manual,VBoxManage,isomaker/viso: Require all refsect1 and refsect2 elements to have @id attributes in manpages (refentry) to make these predictable and the split up topic files easier to handle for the docs team. Also requires these @id values to start with the refentry @id + '-'. Corrected a few bogus ones. Because 'controlvm' has too many sub-commands, HELP_SCOPE_ IDs will not be generated for 'See Also' and 'Examples' sections. bugref:10302

File:

• trunk/doc/manual/docbook-refentry-to-H-help.xsl (modified) (1 diff)

trunk/doc/manual/docbook-refentry-to-H-help.xsl

@@ -99 +99 @@
         <xsl:for-each select=".//refsect1[@id] | .//refsect2[@id]">
           <xsl:variable name="sThisId" select="@id"/>
-          <xsl:if test="not($RefEntry[@id = $sThisId]) and not($RefEntry/refsynopsisdiv/cmdsynopsis[@id = concat('synopsis-', $sThisId)])">
+          <xsl:if test="    not($RefEntry[@id = $sThisId])
+                        and not($RefEntry/refsynopsisdiv/cmdsynopsis[@id = concat('synopsis-', $sThisId)])
+                        and not(contains($sThisId, '-see-also'))
+                        and not(contains($sThisId, '-examples')) "> <!-- controlvm is too big, so skip these two -->
             <xsl:variable name="sSubNm">
               <xsl:text>HELP_SCOPE_</xsl:text>