[RFC] A Handbook Section on Updating the Documentation Set

[Frank Shute]

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 at freebsd.org> wrote:
> > http://people.freebsd.org/~pgj/patches/2008/12/27/updating-upgrading-documentation.patch.diff
> 
> Ping...  Any news about this patch?
> 
> If there are no objections since Dec 27, it would be nice if we
> committed it to CVS.
> 

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.

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

I've made an executive decision to change mentions of cvsup to csup
where appropriate since it's in base.

I'm afraid I haven't got much to show ATM but keep your eyes peeled &
I'll post regular updates here. I'll also likely be asking some
questions!

I guess it will probably take me a few weeks of work to get it into a
state with which I'm happy but I'm not working ATM which allows me to
devote plenty of time to it.

Any suggestions gratefully received. :)


Regards,

-- 

 Frank 


 Contact info: http://www.shute.org.uk/misc/contact.html