svn commit: r1853615 - /httpd/httpd/trunk/docs/manual/style/xsl/quickreference.xsl

[ja...@apache.org]

Author: jailletc36
Date: Fri Feb 15 07:25:54 2019
New Revision: 1853615

URL: http://svn.apache.org/viewvc?rev=1853615&view=rev
Log:
Add some additional tests to report badly formatted synopsis.
Comment-out these tests because of the noise it generates, but leave it there, if useful for s.o.

Modified:
    httpd/httpd/trunk/docs/manual/style/xsl/quickreference.xsl

Modified: httpd/httpd/trunk/docs/manual/style/xsl/quickreference.xsl
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/style/xsl/quickreference.xsl?rev=1853615&r1=1853614&r2=1853615&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/style/xsl/quickreference.xsl (original)
+++ httpd/httpd/trunk/docs/manual/style/xsl/quickreference.xsl Fri Feb 15 07:25:54 2019
@@ -319,14 +319,28 @@
             </xsl:choose>
         </xsl:variable>
 
-        <!-- Check if the default string really starts with the directive -->
-        <!-- name, in order to avoid typo, or unexpected formatting.      -->
-        <!-- Below, we skip the directive name, so, for it to work, it    -->
-        <!-- must be there.                                               -->
+        <!-- Check if the syntax and the default strings really start with -->
+        <!-- the directive name, in order to avoid typo, or unexpected     -->
+        <!-- formatting.                                                   -->
+        <!-- Un-comment these lines if you want to perform this additional -->
+        <!-- tests.  They are not run by default, because of the false     -->
+        <!-- positives and the noise they generate.                        -->
+<!--
+        <xsl:if test="string-length(syntax) = 0 or
+                         (syntax != name and
+                          substring-before(syntax, ' ') != name and
+                          substring-before(syntax, ' ') != concat ('&lt;', name) and
+                          substring-before(syntax, ' ') != concat ('&lt;', name, '&gt;')
+                         )" >
+                      
+            <xsl:message>Spurious syntax string for <xsl:value-of select="name"/>: '<xsl:value-of select="syntax"/>'</xsl:message>
+        </xsl:if>
+
         <xsl:if test="string-length($default) &gt; 0
                       and substring-before($default, ' ') != name">
-            <xsl:message>Spurious default string: <xsl:value-of select="$default"/> (Directive <xsl:value-of select="name"/> omitted or misspelled)</xsl:message>
+            <xsl:message>Spurious default string for <xsl:value-of select="name"/>: <xsl:value-of select="$default"/></xsl:message>
         </xsl:if>
+-->
 
         <!-- Now. If the default output is empty, the xslt processor emits -->
         <!-- <td />. In order to avoid this, we simply emit <td></td>      -->