Preface need update.

Tom Rhodes trhodes at FreeBSD.org
Sun Dec 14 23:51:06 UTC 2008


Hi Murray,

On Sat, 13 Dec 2008 21:46:04 -0800
"Murray Stokely" <murray at stokely.org> wrote:

> Hi Tom, I've just committed a new section to the preface with pointers
> to the Filesystems and DTrace chapters you committed, and also the
> Virtualization chapter I committed in 2007.  There are others (e.g.
> updating) but I wasn't sure if some of that content was moved from
> other chapters (cutting edge?) as if so we'd want to mention that in
> the preface item for that new chapter.  Please take a look when you
> get a chance and add a few more items to this section about some of
> the work you've done recently.
> 
> We presumably also need something about the security event auditing chapter.

Thanks for that!  I definitely slacked here, but I'll keep this
in mind for the future.  About the updating chapter, I am unable
to find any information on portsnap in my printed copy of the
Handbook (third edition).  They could have existed (I see a
2006 commit date for freebsd-update in src) but seem to have
not been documented in the handbook.

Anyway, how does this patch look to you?:


diff -u -r1.44 preface.sgml
--- preface.sgml	14 Dec 2008 05:42:48 -0000	1.44
+++ preface.sgml	14 Dec 2008 23:45:05 -0000
@@ -47,6 +47,19 @@
       </listitem>
 
       <listitem>
+	<para><xref linkend="updating">, Updating, has been added to
+	  cover various methods of keeping the system up to date with
+	  the latest in security patches and changes in the Ports
+	  Collection.</para>
+      </listitem>
+
+      <listitem>
+	<para><xref linkend="audit">, Security Event Auditing, has
+	  been added to cover the new auditing capabilities in &os;
+	  and explain its use.</para>
+      </listitem>
+
+      <listitem>
         <para><xref linkend="virtualization">, Virtualization, has
           been added with information about installing &os; on
           virtualization software.</para>


Thanks,


> 
> Thanks,
> 
>    - Murray
> 
> On Thu, Nov 13, 2008 at 3:53 PM, Tom Rhodes <trhodes at freebsd.org> wrote:
> > 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
> >
> 


-- 
Tom Rhodes



More information about the freebsd-doc mailing list