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?
--
Francesco P. Lovergine
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
On Thu, 2006-02-02 at 11:27 +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).
A while back doxygen generated files weren't getting cleaned:
http://grass.itc.it/pipermail/grass5/2004-November/016287.html
This might still be a problem. I never looked into the cleandocs target
that Markus mentioned. Maybe that just needs to be added to
debian/rules' clean target.
Steve
Any idea about what target can be used to install all html/man pages
without building the whole beast?