[GRASS5] Re: [DebianGIS] Build-indep

[Markus Neteler]

On Thu, Feb 02, 2006 at 11:27:30AM +0100, Francesco Paolo Lovergine wrote:
> On Wed, Feb 01, 2006 at 07:38:43PM -0500, Steve Halasz wrote:
> > 
> > Note that fakeroot will still be called when building the documentation.
> > The makefiles are patched to do this since the documentation doesn't
> > seem to get built otherwise. You can remove the patch from
> > debian/patches/00list if you want to build entirely without fakeroot.
> > 
> > Steve
> > 
> 
> About that, we need to split up the documentation (and arch-indep) building and the
> binaries building in rules file. I see that 'htmldocs' target seems creating
> only the programming manual by doxygen (which needs to be added too, btw).
> Any idea about what target can be used to install all html/man pages
> without building the whole beast?

AFAIK (ok, I am co-author :-) it's impossible since the
header/module parameters + flags/footer of the HTML pages
are generated in a virtual session after compilation of
the individual module.

Thanks to the '--html-description' flag each module documents
itself. The 'description.html' files only contain additional
documentation. The motivation and advantage of this approach
is that developers no longer have to maintain the parameter
description manually which was a mess in GRASS 4.x and 5.x.

Second advantage is that, when compiling GRASS in a different
(supported) locale), the manual is partially generated translated.
We are working on integration with translated 'description.html'
files to generate multi-language manual pages.

The MAN pages are finally derived from the HTML pages.

Summary: The key issue is that the pages are constructed in
a virtual session which needs GRASS to be compiled.

Markus