httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jeff Trawick <traw...@gmail.com>
Subject Re: fcgid doc build
Date Fri, 18 Sep 2009 11:29:57 GMT
On Fri, Sep 18, 2009 at 7:09 AM, Rainer Jung <rainer.jung@kippdata.de>wrote:

> On 18.09.2009 01:02, Jeff Trawick wrote:
> > On Thu, Sep 17, 2009 at 5:22 PM, William A. Rowe, Jr.
> > <wrowe@rowe-clan.net <mailto:wrowe@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.
>

...


> So the generation of the html manual works.
>

Note that I don't have any problems getting the html manual generated per
se.  I just get slightly different output from you and Bill, whether running
on Solaris or Mac.


> 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"/>
>

That's cool.  I guess there is some way to tweak the build definitions so
that fcgid can provide a properties file which disables generation of man
pages*, but I'm not the right person to do that ;)  Otherwise we should just
check in an empty man directory.

*Does this section of lang-targets.xml need an "unless" check for a new
property?

<target description="- builds the English nroff files" name="man-en">
    <nroff.generic lang="en"/>
</target>

Mime
View raw message