Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 31 Mar 2003 23:08:33 +0300
From:      Giorgos Keramidas <keramida@ceid.upatras.gr>
To:        Tom Rhodes <trhodes@freebsd.org>
Cc:        Neil Blakey-Milner <nbm@mithrandr.moria.org>
Subject:   Re: Why does cvsup drop doc in /usr/doc
Message-ID:  <20030331200833.GB1704@gothmog.gr>
In-Reply-To: <20030330105300.2db1f444.trhodes@FreeBSD.org>
References:  <20030327130941.35104ed8.trhodes@FreeBSD.org> <20030327182455.GA40418@mithrandr.moria.org> <20030330105300.2db1f444.trhodes@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On 2003-03-30 10:53, Tom Rhodes <trhodes@freebsd.org> wrote:
>Neil Blakey-Milner <nbm@mithrandr.moria.org> wrote:
>>Tom Rhodes wrote:
>>>
>>> I've got an interesting or wierd question.  Why does the cvsup application
>>> drop the docs in /usr/doc instead of /usr/share/doc.
>>>
>>> Now I understand that the documentation from the release installs
>>> there, and cvsup keeps track of checked out versions.  But can't
>>> we just drop doc/ into that directory?  This way those which want
>>> to cvsup and update the doc don't get a copy in both places.
>>>
>>> Perhaps we do it for the ease of CVS, not sure.  Perhaps someone
>>> could elaborate on this.
>>
>> I imagine it's because /usr/doc is the "source" and /usr/share/doc is
>> where the /usr/doc stuff installs to?
>
> I was guessing that also, but its just `different'.

It's not very different from having the source of the entire system in
/usr/src and the installed versions scattered around the whole place:P

Besides, /usr/share/doc is just the default location.  You can always
override it with DOCDIR.  I keep a checked out copy of the docs in
/a/doc and generate daily copies of the el_GR.ISO8859-7 subdir with a
script that includes:

	cd /a/doc/el_GR.ISO8859-7
	for fmt in html html-split txt ;do
		export DOCDIR="/tmp/doc/${fmt}"
		rm -fr "${DOCDIR}"
		mkdir -p "${DOCDIR}" || break

		make FORMATS="${fmt}" clean && \
		make FORMATS="${fmt}" all && \
		make FORMATS="${fmt}" install
	done

DOCDIR makes sure that the installed versions go to a place that isn't
/usr/share/doc.  I don't like the idea of giving write permissions to
that directory to my non-root user :)

- Giorgos



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030331200833.GB1704>