From owner-freebsd-doc@FreeBSD.ORG Sat Dec 27 22:58:17 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 8FF54106564A; Sat, 27 Dec 2008 22:58:17 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id 0560E8FC21; Sat, 27 Dec 2008 22:58:16 +0000 (UTC) (envelope-from keramida@freebsd.org) 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 mBRMvupm030707 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 28 Dec 2008 00:58:01 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id mBRMvt2k038662; Sun, 28 Dec 2008 00:57:56 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id mBRMvta4038661; Sun, 28 Dec 2008 00:57:55 +0200 (EET) (envelope-from keramida@freebsd.org) From: Giorgos Keramidas To: Gabor PALI References: <4956903C.5060405@FreeBSD.org> <87sko9wda1.fsf@kobe.laptop> <495696F1.7080207@freebsd.org> <87d4fdpb46.fsf@kobe.laptop> <87prjdl1zm.fsf@kobe.laptop> <4956AF88.2030502@FreeBSD.org> Date: Sun, 28 Dec 2008 00:57:55 +0200 In-Reply-To: <4956AF88.2030502@FreeBSD.org> (Gabor PALI's message of "Sat, 27 Dec 2008 23:43:20 +0100") Message-ID: <87zlih5iq4.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: mBRMvupm030707 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-4.301, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.10, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: Rene Ladan , 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 22:58:17 -0000 On Sat, 27 Dec 2008 23:43:20 +0100, Gabor PALI wrote: >Giorgos Keramidas wrote: >> 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 assumed that readers are able to replace cvsup with csup and pick > a server for themselves, so there is no more explanation needed. Yes, that makes sense. >> 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. > > Yep, we can add it. Excellent. I'm off to bed, so I trust whatever you guys decide about the hostname vs. replaceable should be fine :)