Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 06 Jan 2009 21:24:25 +0200
From:      Giorgos Keramidas <keramida@freebsd.org>
To:        Frank Shute <frank@shute.org.uk>
Cc:        Gabor PALI <pgj@freebsd.org>, freebsd-doc@freebsd.org, Rene Ladan <rene@freebsd.org>
Subject:   Re: [RFC] A Handbook Section on Updating the Documentation Set
Message-ID:  <87iqosgrva.fsf@kobe.laptop>
In-Reply-To: <20090104203631.GA24306@melon.esperance-linux.co.uk> (Frank Shute's message of "Sun, 4 Jan 2009 20:36:31 %2B0000")
References:  <4956903C.5060405@FreeBSD.org> <874p0f9dv7.fsf@kobe.laptop> <20090104203631.GA24306@melon.esperance-linux.co.uk>

next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, 4 Jan 2009 20:36:31 +0000, Frank Shute <frank@shute.org.uk> 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 <pgj@freebsd.org> 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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?87iqosgrva.fsf>