From owner-freebsd-doc  Fri Apr 28  4:18:16 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mailgate.originative.co.uk (mailgate.originative.co.uk [194.217.50.228])
	by hub.freebsd.org (Postfix) with ESMTP
	id 96A9737B7CF; Fri, 28 Apr 2000 04:18:13 -0700 (PDT)
	(envelope-from paul@originative.co.uk)
Received: from originative.co.uk (lobster.originative.co.uk [194.217.50.241])
	by mailgate.originative.co.uk (Postfix) with ESMTP
	id C32741D160; Fri, 28 Apr 2000 12:18:09 +0100 (BST)
Message-ID: <39097371.ADC7DD5F@originative.co.uk>
Date: Fri, 28 Apr 2000 12:18:09 +0100
From: "Paul Richards.width" <paul@originative.co.uk>
Organization: Originative Solutions Ltd
X-Mailer: Mozilla 4.7 [en] (X11; I; FreeBSD 5.0-CURRENT i386)
X-Accept-Language: en-GB, en
MIME-Version: 1.0
To: Nik Clayton <nik@freebsd.org>
Cc: doc@freebsd.org
Subject: Re: Default path settings
References: <39004FD3.680FE08F@originative.co.uk> <20000421192030.A30157@catkin.nothing-going-on.org>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

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