From owner-freebsd-doc@FreeBSD.ORG Tue Jan 6 19:24:39 2009 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 0D421106564A; Tue, 6 Jan 2009 19:24:39 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from mx-out.forthnet.gr (mx-out.forthnet.gr [193.92.150.104]) by mx1.freebsd.org (Postfix) with ESMTP id 4622D8FC18; Tue, 6 Jan 2009 19:24:37 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from mx-av-06.forthnet.gr (mx-av.forthnet.gr [193.92.150.27]) by mx-out-01.forthnet.gr (8.14.3/8.14.3) with ESMTP id n06JOaSj028104; Tue, 6 Jan 2009 21:24:36 +0200 Received: from MX-IN-01.forthnet.gr (mx-in-01.forthnet.gr [193.92.150.23]) by mx-av-06.forthnet.gr (8.14.3/8.14.3) with ESMTP id n06JOarW007028; Tue, 6 Jan 2009 21:24:36 +0200 Received: from kobe.laptop (ppp160-148.adsl.forthnet.gr [194.219.40.148]) by MX-IN-01.forthnet.gr (8.14.3/8.14.3) with ESMTP id n06JOR3V009335; Tue, 6 Jan 2009 21:24:29 +0200 Authentication-Results: MX-IN-01.forthnet.gr smtp.mail=keramida@freebsd.org; spf=permerror Authentication-Results: MX-IN-01.forthnet.gr header.from=keramida@freebsd.org; sender-id=permerror Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id n06JORx6079011; Tue, 6 Jan 2009 21:24:27 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id n06JOPIc079010; Tue, 6 Jan 2009 21:24:25 +0200 (EET) (envelope-from keramida@freebsd.org) From: Giorgos Keramidas To: Frank Shute References: <4956903C.5060405@FreeBSD.org> <874p0f9dv7.fsf@kobe.laptop> <20090104203631.GA24306@melon.esperance-linux.co.uk> Date: Tue, 06 Jan 2009 21:24:25 +0200 In-Reply-To: <20090104203631.GA24306@melon.esperance-linux.co.uk> (Frank Shute's message of "Sun, 4 Jan 2009 20:36:31 +0000") Message-ID: <87iqosgrva.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 Cc: Gabor PALI , freebsd-doc@freebsd.org, Rene Ladan 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: Tue, 06 Jan 2009 19:24:39 -0000 On Sun, 4 Jan 2009 20:36:31 +0000, Frank Shute wrote: >On Sun, Jan 04, 2009 at 07:31:56PM +0200, Giorgos Keramidas wrote: >>On Sat, 27 Dec 2008 21:29:48 +0100, Gabor PALI wrote: >>> http://people.freebsd.org/~pgj/patches/2008/12/27/updating-upgrading-documentation.patch.diff >> >> Ping... Any news about this patch? > > Hi Giorgos, > > If you remember, you asked me if I could get the page I wrote about > using csup to update the docs: > > http://www.shute.org.uk/misc/freebsd_uptodate.html > > into some sort of state to be incorporated into the updating section > of the handbook. Hi Frank, "Yes", and if you can review the existing patch by Gabor Pali :) > I've built the docs with Gabor's above patch applied & have started > work on rejigging that section. > > You can see how far I've got. I've only done one page (which is bound > to change) & largely worked on the css, so it's easier to mark-up into > sgml: > > http://www.shute.org.uk/freebsd/synopsis.html Don't spend too much time tweaking the CSS style. We don't often make changes in that area. > I've made an executive decision to change mentions of cvsup to csup > where appropriate since it's in base. Rene Ladan (added to the Cc: list) wanted to write about csup too, if my memory does not fool me. Gabor and Rene had a discussion about this, so before you spend a lot of time writing a long description of csup, maybe it would be a good idea to talk to Gabor and Rene. I'm glad that you are willing to help with the doc updating section. We can always use a bit of help with the documentation :-) Cheers, Giorgos