From owner-freebsd-doc@FreeBSD.ORG Sat Dec 27 21:53:12 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 40EEA1065673; Sat, 27 Dec 2008 21:53:12 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id ACB268FC13; Sat, 27 Dec 2008 21:53:11 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from kobe.laptop (adsl57-25.kln.forthnet.gr [77.49.184.25]) (authenticated bits=128) by igloo.linux.gr (8.14.3/8.14.3/Debian-5) with ESMTP id mBRLqjHv026746 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sat, 27 Dec 2008 23:52:50 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id mBRLqj1f037725; Sat, 27 Dec 2008 23:52:45 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id mBRLqjJb037724; Sat, 27 Dec 2008 23:52:45 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) From: Giorgos Keramidas To: Rene Ladan References: <4956903C.5060405@FreeBSD.org> <87sko9wda1.fsf@kobe.laptop> <495696F1.7080207@freebsd.org> <87d4fdpb46.fsf@kobe.laptop> Date: Sat, 27 Dec 2008 23:52:45 +0200 In-Reply-To: <87d4fdpb46.fsf@kobe.laptop> (Giorgos Keramidas's message of "Sat, 27 Dec 2008 23:22:01 +0200") Message-ID: <87prjdl1zm.fsf@kobe.laptop> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-MailScanner-ID: mBRLqjHv026746 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-3.867, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.53, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@ceid.upatras.gr X-Spam-Status: No Cc: Gabor PALI , freebsd-doc@freebsd.org Subject: Re: [RFC] A Handbook Section on Updating the Documentation Set X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 27 Dec 2008 21:53:12 -0000 On Sat, 27 Dec 2008 23:22:01 +0200, Giorgos Keramidas wrote: > On Sat, 27 Dec 2008 21:58:25 +0100, Rene Ladan wrote: >>>> [1] http://lists.freebsd.org/pipermail/freebsd-doc/2008-December/015099.html >>>> [2] http://people.freebsd.org/~pgj/patches/2008/12/27/updating-upgrading-documentation.patch.diff >>> >>> It goes without saying that after his patience with all my comments >>> about the patch, and the changes we made this afternoon, Gabor has my >>> full approval for the patch :) >> >> Indeed, but my tag changes seem to be lost. Maybe I am too picky :) > > I'm sorry. I will go through the tag diff and see if it's easy to merge > them into this :) Hi Rene, Looking at the 2nd level diff from the private emails, I could see the following tag changes: - &prompt.root; cvsup -h cvsup10.FreeBSD.org -g -L 2 /usr/share/examples/cvsup/doc-supfile + &prompt.root; csup -h cvsupN.country.FreeBSD.org -L 2 /usr/share/examples/cvsup/doc-supfile + + Here, N is a number indicating which copy + of the server to use, and country is the + two-letter ISO country code of a (preferably geographically + close) country. I can understand the reasoning behind this part of the changes. It is a good idea to avoid using a specific CVSup server in the docs, because users will tend to copy/paste the name of the server and won't necessarily bother picking the right one for their setup. On the other hand, having examples that one can copy and paste is nice too; it avoids the need for a lengthy explanation of what cvsup"N"."country" means, and we have servers that don't match the country-based pattern. I think I like the "cvsup10" version, since we already mention in the added text that cvsup is merely an example: so the documentation sources can be fetched from one of the CVSup servers, like cvsup10.FreeBSD.org, by typing: If we change to a template name, then we should update the text before the commands too, and we should add a link to the Handbook section that lists the CVSup servers. A pointer to: the list of CVSup mirrors should suffice for that. - &prompt.root; rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc + &prompt.root; rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc This one is ok. We don't have many docsnap servers, so is probably fine here. If we start mirroring docsnap files in multiple places, and there are several to choose, we may have to revert to the element, but for now is fine :) Are there any other tag changes that I missed?