From owner-freebsd-doc@FreeBSD.ORG Mon Mar 31 12:09:12 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4D18537B401; Mon, 31 Mar 2003 12:09:11 -0800 (PST) Received: from thalia.otenet.gr (mailsrv.otenet.gr [195.170.0.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id A160D43FB1; Mon, 31 Mar 2003 12:09:05 -0800 (PST) (envelope-from keramida@ceid.upatras.gr) Received: from gothmog.gr (patr530-a001.otenet.gr [212.205.215.1]) by thalia.otenet.gr (8.12.9/8.12.9) with ESMTP id h2VK8jbR002190; Mon, 31 Mar 2003 23:08:52 +0300 (EEST) Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.8/8.12.8) with ESMTP id h2VK8gON002141; Mon, 31 Mar 2003 23:08:42 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from giorgos@localhost) by gothmog.gr (8.12.8/8.12.8/Submit) id h2VK8XPr002140; Mon, 31 Mar 2003 23:08:33 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Mon, 31 Mar 2003 23:08:33 +0300 From: Giorgos Keramidas To: Tom Rhodes Message-ID: <20030331200833.GB1704@gothmog.gr> References: <20030327130941.35104ed8.trhodes@FreeBSD.org> <20030327182455.GA40418@mithrandr.moria.org> <20030330105300.2db1f444.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030330105300.2db1f444.trhodes@FreeBSD.org> cc: FreeBSD-doc@freebsd.org cc: Neil Blakey-Milner Subject: Re: Why does cvsup drop doc in /usr/doc X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 31 Mar 2003 20:09:13 -0000 On 2003-03-30 10:53, Tom Rhodes wrote: >Neil Blakey-Milner 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