doc build with .OBJDIR

[Simon L. Nielsen]

On 2003.05.24 12:17:38 +0200, Dag-Erling Smorgrav wrote:
> Marc Fonvieille <blackend at freebsd.org> writes:
> > Well, nothing is easy, our .mk files are very "hairy" cause of multiples
> > add-ons etc.  All the thing should be rewritten from the beginning, but
> > who would be enough "crazy" to take that task? :))
> 
> A rewrite is definitely needed.  That would also be a good occasion to
> transition from SGML to XML, if at all possible (XML tools are a
> couple of orders of magnitude faster than SGML tools...)

Doesn't the XML docbook have problems with including other files as done
e.g. in the handbook?

I might remember incorrectly, it is some time since I looked at XML
docbook last.

> As for images, the obvious solution (to me) is to start by recursing
> into share/images and build all images there before building the
> documents themselves.

That was actually also the solution I was thinking a bit about to avoid
having to build the images multiple times.  Perhaps with the help of
symlinks... but I havn't had a closer look at it yet.

> For the curious, I've attached my document.mk which I use for pretty
> much everything I produce outside the FreeBSD doc tree.  It's the nth
> generation of something I originally wrote for ThinkSec way back when.
> Not a doc.project.mk replacement, but a different take on a similar
> theme.

Nice, I will take a closer look at it.

-- 
Simon L. Nielsen
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20030524/7874dcd7/attachment.sig>