From owner-freebsd-doc Mon Aug 23 6:44:37 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id D6A6E14E04 for ; Mon, 23 Aug 1999 06:41:03 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id OAA04594; Mon, 23 Aug 1999 14:03:32 +0100 (BST) (envelope-from nik) Date: Mon, 23 Aug 1999 14:03:32 +0100 From: Nik Clayton To: Neil Blakey-Milner Cc: doc@FreeBSD.org Subject: Re: Some proposed changes in expectation of obj'able doc makes Message-ID: <19990823140332.C2121@catkin.nothing-going-on.org> References: <19990823115900.A6290@rucus.ru.ac.za> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990823115900.A6290@rucus.ru.ac.za>; from Neil Blakey-Milner on Mon, Aug 23, 1999 at 11:59:00AM +0200 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Neil, On Mon, Aug 23, 1999 at 11:59:00AM +0200, Neil Blakey-Milner wrote: > I generated a set of patches to teach the doc building process to work > properly should we have an existant obj directory, but for the old doc > mindset, and I'm working on recreating them for the new. > > Currently, in Makefiles all around we have statements like: > > DOC_PREFIX?= ../../.. > > I propose we change all of them to: > > DOC_PREFIX?= ${.CURDIR}/../../.. I'm sure this is a good idea. At least, it looks like a good idea, and it looks similar to the mechanism used in the src/ Makefiles, and I assume it's a good idea there as well. But what does it actually do? Would you (or anyone else on the list) be able to write up a description of what the benefits are, and how they work? This can then be added to the FDP primer, so that newcomers to the project have something they can read through which explains things like this? Cheers, N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message