Date: Sun, 14 Dec 2008 18:50:58 -0500 From: Tom Rhodes <trhodes@FreeBSD.org> To: "Murray Stokely" <murray@stokely.org> Cc: freebsd-doc@FreeBSD.org Subject: Re: Preface need update. Message-ID: <20081214185058.48a7c2c2.trhodes@FreeBSD.org> In-Reply-To: <2a7894eb0812132146w42722ce5n809cd5d0a9c451eb@mail.gmail.com> References: <1226494693.1809.10.camel@localhost> <491B4F01.9020403@gmail.com> <2a7894eb0811121605k1310bf8avf7a69363fc504905@mail.gmail.com> <20081112200755.66c52a48.trhodes@FreeBSD.org> <491C39E7.7040609@gmail.com> <20081113185333.25a73ebf.trhodes@FreeBSD.org> <2a7894eb0812132146w42722ce5n809cd5d0a9c451eb@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
Hi Murray,
On Sat, 13 Dec 2008 21:46:04 -0800
"Murray Stokely" <murray@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@freebsd.org> wrote:
> > On Thu, 13 Nov 2008 16:29:59 +0200
> > Manolis Kiagias <sonic2000gr@gmail.com> wrote:
> >
> >> Tom Rhodes wrote:
> >> > On Wed, 12 Nov 2008 16:05:55 -0800
> >> > "Murray Stokely" <murray@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20081214185058.48a7c2c2.trhodes>