httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r816938 - in /httpd/httpd/trunk/docs/manual/style: lang-targets.xml xsl/language.xsl
Date Sat, 19 Sep 2009 15:40:43 GMT
Author: rjung
Date: Sat Sep 19 15:40:42 2009
New Revision: 816938

Add ant task to html manual and man page generation:
- check-man checks for the presence of the "man"
  directory and sets an ant property skip-man in
  case the directory is missing
- all the man age generating tasks first call
  check-man as a dependency, and then only run
  if skip-man is unset.

Thats useful for unbundled modules like mod_ftp
and mod_fcgid, which do not have a man directory.
Building their docs otherwise bombs.


Modified: httpd/httpd/trunk/docs/manual/style/lang-targets.xml
--- httpd/httpd/trunk/docs/manual/style/lang-targets.xml (original)
+++ httpd/httpd/trunk/docs/manual/style/lang-targets.xml Sat Sep 19 15:40:42 2009
@@ -22,6 +22,7 @@
 <!-- ==================================================================== -->
 <project name="lang-targets">
+<target name="check-man"><if><not><available type="dir" file="../../man"/></not><then><property
value="yes" name="skip-man"/></then></if></target>
 <target description="- builds all HTML files and nroff man pages" name="all" depends="de,
en, es, fr, ja, ko, pt-br, ru, tr"/>
 <target description="- builds all zip download packages" name="zip-all" depends="zip-de,
zip-en, zip-es, zip-fr, zip-ja, zip-ko, zip-pt-br, zip-ru, zip-tr"/>
 <target description="- builds all war download packages" name="war-all" depends="war-de,
war-en, war-es, war-fr, war-ja, war-ko, war-pt-br, war-ru, war-tr"/>
@@ -72,7 +73,7 @@
 <target description="- builds the English CHM file" name="chm-en">
     <chm.generic lang="en"/>
-<target description="- builds the English nroff files" name="man-en">
+<target description="- builds the English nroff files" unless="skip-man" depends="check-man"
     <nroff.generic lang="en"/>
 <target description="- builds the English latex file" name="latex-en">
@@ -230,7 +231,7 @@
 <target description="- builds the Turkish CHM file" name="chm-tr">
     <chm.generic lang="tr"/>
-<target description="- builds the Turkish nroff files" name="man-tr">
+<target description="- builds the Turkish nroff files" unless="skip-man" depends="check-man"
     <nroff.generic lang="tr"/>

Modified: httpd/httpd/trunk/docs/manual/style/xsl/language.xsl
--- httpd/httpd/trunk/docs/manual/style/xsl/language.xsl (original)
+++ httpd/httpd/trunk/docs/manual/style/xsl/language.xsl Sat Sep 19 15:40:42 2009
@@ -133,6 +133,14 @@
 <project name="lang-targets">
+    <!-- Test for existence of man page directory -->
+    <target name="check-man">
+        <if><not><available file="../../man" type="dir" /></not><then>
+            <property name="skip-man" value="yes" />
+        </then></if>
+    </target>
+    &lf;
     <!-- build *-all targets -->
     <!-- =================== -->
     <target name="all"
@@ -237,6 +245,8 @@
             <xsl:if test="$file/man">
                 <target name="man-{.}"
+                        depends="check-man"
+                        unless="skip-man"
                         description="- builds the {$file/name} nroff files">&lf;
                     <xsl:text>    </xsl:text>
                     <nroff.generic lang="{.}" />&lf;

View raw message