Date: Thu, 13 May 1999 12:40:39 +0100 From: nclayton@lehman.com To: Wolfram Schneider <wosch@panke.de.freebsd.org>, Satoshi - Ports Wraith - Asami <asami@FreeBSD.ORG> Cc: doc@FreeBSD.ORG Subject: Re: Can't build handbook Message-ID: <19990513124039.N14492@lehman.com> In-Reply-To: <19990513130423.49638@panke.de.freebsd.org>; from Wolfram Schneider on Thu, May 13, 1999 at 01:04:23PM %2B0200 References: <19990508141141.A20366@holly.dyndns.org> <XFMail.990508212539.jesusr@ncsa.es> <19990508231333.45191@panke.de.freebsd.org> <19990510111306.I14492@lehman.com> <199905110749.AAA28713@silvia.hip.berkeley.edu> <19990513130423.49638@panke.de.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, May 13, 1999 at 01:04:23PM +0200, Wolfram Schneider wrote:
> On 1999-05-11 00:49:10 -0700, Satoshi - Ports Wraith - Asami wrote:
> > * From: nclayton@lehman.com
> >
> > * What should it assume it to be? I thought /usr/doc was the traditional
> > * place to put a checked out copy of the doc/ repository.
> >
> > Uh, no. That's too confusing, why would /usr/doc be the sources when
> > the actual documents go to /usr/share/doc?
> >
> > I use /usr/opt/doc myself. (Same for www.) If people agree that all
> > non-src sources should go to /usr/opt, I'm not against moving ports
> > there too.
>
> Me too. I never build the web pages in /usr/{www,doc}. I'm doing
> it in /usr/tmp or ~/tmp.
>
> The /usr/ partition is reserved for root and read-only for most users.
> I don't want login as root to build the web pages.
OK. But I'm pretty certain this is irrelevant, as all we're really
talking about is a default.
As it stands, the default supfiles for CVSup have
*default prefix=/usr
This is going to result in /usr/src, /usr/ports, /usr/doc, /usr/www,
/usr/gnats, and so on.
For the "normal" user, who just wants things to track -stable and/or
-current, this is fine, since they're going to be doing the build
as 'root' anyway.
Anyone that wants to contribute to the FDP is *strongly* advised to
maintain a local copy of the CVS repository. And if they're doing
that then the checked out location is entirely up to them (I use
~/FreeBSD-CVS, FWIW).
Yes, if they check it out anywhere other than /usr/doc they will need
to set DOC_PREFIX. As I've already explained, this is a hack that will
(eventually) go away. In the meantime we can do one of two things;
1. Keep the "DOC_PREFIX?=/usr/doc" line in docproj.docbook.mk, but
change the path from /usr/doc to something else.
I think changing the path is a bad idea, as anyone who's just
cut-n-pasted the CVSup configurations is going to be inconvenienced.
2. Stick in some code that checks for an empty DOC_PREFIX, and advises
the user on how to fix it. Or better yet, looks in DOC_PREFIX
first the make sure the appropriate files are there, and warns the
user if they aren't.
I posted code that does this earlier on in this thread.
I think option 2 is the best way to go. We can keep /usr/doc as the
default, and it will work if the user has been storing a checked out
copy in /usr/doc. If they haven't then the DOC_PREFIX test will discover
that, abort the build, and print instructions about what they should do.
N
--
--+==[ Systems Administrator, Year 2000 Test Lab, Lehman Brothers, Inc. ]==+--
--+==[ 1 Broadgate, London, EC2M 7HA 0171-601-0011 x5514 ]==+--
--+==[ Year 2000 Testing: It's about time. . . ]==+--
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?19990513124039.N14492>