Date: Fri, 28 Apr 2000 12:18:09 +0100 From: "Paul Richards.width" <paul@originative.co.uk> To: Nik Clayton <nik@freebsd.org> Cc: doc@freebsd.org Subject: Re: Default path settings Message-ID: <39097371.ADC7DD5F@originative.co.uk> References: <39004FD3.680FE08F@originative.co.uk> <20000421192030.A30157@catkin.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Nik Clayton wrote:
>
> On Fri, Apr 21, 2000 at 01:55:47PM +0100, Paul Richards wrote:
> > I'd like to suggest the following change. It makes it easier to use
> > docbook for writing your own docs without having to worry about setting
> > up lots of variables. You can still overide it if you want ot use a
> > different .dsl file.
> >
> >
> > diff -r1.10 doc.docbook.mk
> > 52,53c52,53
> > < DSLHTML?= ${.CURDIR}/../../share/sgml/freebsd.dsl
> > < DSLPRINT?= ${.CURDIR}/../../share/sgml/freebsd.dsl
> > ---
> > > DSLHTML?= ${DOC_PREFIX}/share/sgml/freebsd.dsl
> > > DSLPRINT?= ${DOC_PREFIX}/share/sgml/freebsd.dsl
>
> No. At least, not in the form above.
>
> The lines you want to replace are looking for the freebsd.dsl file in
> doc/<lang>/share/sgml/freebsd.dsl, and not doc/share/sgml/freebsd.dsl
> (which is what your patch would do).
>
> This is because each language has its own .dsl file, so that we can
> keep per-language customisations separate.
Ok, I understand what this is doing now I've looked.
Why not have each language define a variable, rather than making the
default so path specific?
Then you could do
DSLHTML?= ${DOC_PREFIX}/${LANG}/share/sgml/freebsd.dsl
DSLPRINT?= ${DOC_PREFIX}/${LANG}/share/sgml/freebsd.dsl
and if you don't define LANG then you'll pick up the defaults. It's a
small increase in the size of the foreign language makefiles but makes
it's much more straightforward to create docbook projects outside of the
doc structure. It also allows deeper directory structures for document
sources in the official docs tree, which the current model doesn't
support.
Paul.
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?39097371.ADC7DD5F>