Date: Sun, 28 Dec 2008 00:57:55 +0200 From: Giorgos Keramidas <keramida@freebsd.org> To: Gabor PALI <pgj@freebsd.org> Cc: Rene Ladan <rene@freebsd.org>, freebsd-doc@freebsd.org Subject: Re: [RFC] A Handbook Section on Updating the Documentation Set Message-ID: <87zlih5iq4.fsf@kobe.laptop> In-Reply-To: <4956AF88.2030502@FreeBSD.org> (Gabor PALI's message of "Sat, 27 Dec 2008 23:43:20 %2B0100") 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>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, 27 Dec 2008 23:43:20 +0100, Gabor PALI <pgj@FreeBSD.org> 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 <replaceable> 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: >> >> <link linkend="cvsup-mirrors">the list of CVSup mirrors</link> >> >> 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 :)
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?87zlih5iq4.fsf>