Why does cvsup drop doc in /usr/doc

Giorgos Keramidas keramida at ceid.upatras.gr
Mon Mar 31 20:09:13 UTC 2003

On 2003-03-30 10:53, Tom Rhodes <trhodes at freebsd.org> wrote:
>Neil Blakey-Milner <nbm at 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

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

More information about the freebsd-doc mailing list