From: Rainer Jung <rjung@apache.org>
Date: Sat, 19 Sep 2009 15:40:42 +0000 (+0000)
Subject: Add ant task to html manual and man page generation:
X-Git-Tag: 2.3.3~276
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=566a9e9101707ee0a28567f110f6b7f8cf69c8ba;p=apache

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.


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

diff --git a/docs/manual/style/lang-targets.xml b/docs/manual/style/lang-targets.xml
index 058866457a..410f4c017b 100644
--- a/docs/manual/style/lang-targets.xml
+++ b/docs/manual/style/lang-targets.xml
@@ -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>
-<target description="- builds the English nroff files" name="man-en">
+<target description="- builds the English nroff files" unless="skip-man" depends="check-man" name="man-en">
     <nroff.generic lang="en"/>
 </target>
 <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>
-<target description="- builds the Turkish nroff files" name="man-tr">
+<target description="- builds the Turkish nroff files" unless="skip-man" depends="check-man" name="man-tr">
     <nroff.generic lang="tr"/>
 </target>
 
diff --git a/docs/manual/style/xsl/language.xsl b/docs/manual/style/xsl/language.xsl
index 8ef0b4a048..946714a29b 100644
--- a/docs/manual/style/xsl/language.xsl
+++ b/docs/manual/style/xsl/language.xsl
@@ -133,6 +133,14 @@
 <project name="lang-targets">
     &lf;&lf;
 
+    <!-- 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;