On 18.09.2009 01:02, Jeff Trawick wrote:
> On Thu, Sep 17, 2009 at 5:22 PM, William A. Rowe, Jr.
> <wr...@rowe-clan.net <mailto:wr...@rowe-clan.net>> wrote:
>
> (About <Status> I'll look at what's going on here, but I'd be mostly
> curious if your build/ subdirectory is up to date?)
>
>
> I just removed created a fresh checkout of httpd/mod_fcgid/trunk, used
> configure.apxs with APXS pointing to httpd trunk, ran "make
> generate-docs", manually created docs/man when generate-docs bombed, ran
> it again, touched mod_fcgid.xml, ran it again, yada yada yada
>
> Differences between what is committed, other than doc changes:
>
> i. it says HTTP Server Version 2.2, which I guess corresponds to the
> branch that was exported into build and style; you and Rainer get 2.3
I think the make uses build from docs-build trunk and style from httpd 2.2.
> ii. it says copyright 2009; you and Rainer get 2008
> iii. I get "Status: " instead of "Status: External".
>
> Are you guys building from within an httpd checkout?
No, I built out of tree.
Concerning the error message about the missing "man" directory: maybe I
simply overlooked it and was happy to find a freshly generated html
page. I can reproduce the message, but if I create the directory
docs/man then the message does no longer appear.
The whole man part doesn't really fit well here, because we don't have
any man pages. The man part in the ant build.xml explicitly tries to
create man pages for httpd, ab, apachectl, apxs etc. So do not wonder,
that the created directory stays empty.
If I touch
docs/manual/mod/mod_fcgid.xml
and run again "make generate-docs", I get an updated file
docs/manual/mod/mod_fcgid.html.en
So the generation of the html manual works.
If you want to temporarily get rid of the "man" directory message, you
can uncomment the man pages generation in
docs/manual/style/lang-targets.xml:
@@ -56,7 +56,9 @@
<target description="- builds English HTML files" name="en">
<html.generic lang="en"/>
+<!--
<runtarget target="man-en"/>
+-->
</target>
<target unless="-off.en.done" depends="metafiles" name="-off-en">
<dependencies.offline dir="_off" style="zip" lang="en"/>
Regards,
Rainer
