Preface need update.

Tom Rhodes trhodes at FreeBSD.org
Thu Nov 13 23:53:36 UTC 2008


On Thu, 13 Nov 2008 16:29:59 +0200
Manolis Kiagias <sonic2000gr at gmail.com> wrote:

> Tom Rhodes wrote:
> > On Wed, 12 Nov 2008 16:05:55 -0800
> > "Murray Stokely" <murray at stokely.org> wrote:
> >
> >   
> >> Thanks Manolis.  Maybe we should add a comment to the Makefile so that
> >> when authors commit new chapters they remember to also update the
> >> preface summary.  Or alternatively, we could put some kind of one
> >> sentence chapter description in <chapterinfo> of each chapter and pull
> >> it out of each file dynamically when building the preface.  I'd
> >> probably recommend the low tech first suggestion as good enough.
> >>
> >>         - Murray
> >>     
> >
> > Yea, because I forget this every time I add a new chapter.  :(
> >
> >
> >   
> To take this idea one step further, I suggest we add the following 
> comment to the Makefile:
> 
> -----------------------------------------------------------------------------------------------------------------
> To add a new chapter to the Handbook:
> 
> - Update this Makefile, chapters.ent and book.sgml
> - Add a descriptive entry for the new chapter in preface/preface.sgml
> -----------------------------------------------------------------------------------------------------------------
> 
> Do you think this is good enough?

Yes.  And I need to look at the "changes since the third
edition" data as well.  :)

-- 
Tom Rhodes



More information about the freebsd-doc mailing list