From mwlucas@blackhelicopters.org  Mon Nov  5 09:57:15 2001
Return-Path: <mwlucas@blackhelicopters.org>
Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18])
	by hub.freebsd.org (Postfix) with ESMTP id A6AA537B416
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  5 Nov 2001 09:57:14 -0800 (PST)
Received: (from mwlucas@localhost)
	by blackhelicopters.org (8.9.3/8.9.3) id MAA90983;
	Mon, 5 Nov 2001 12:57:14 -0500 (EST)
	(envelope-from mwlucas)
Message-Id: <200111051757.MAA90983@blackhelicopters.org>
Date: Mon, 5 Nov 2001 12:57:14 -0500 (EST)
From: mwlucas@blackhelicopters.org
Reply-To: mwlucas@blackhelicopters.org
To: FreeBSD-gnats-submit@freebsd.org
Subject: FAQ addition: advanced topics
X-Send-Pr-Version: 3.2

>Number:         31785
>Category:       docs
>Synopsis:       FAQ addition: advanced topics
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Nov 05 10:00:01 PST 2001
>Closed-Date:    Wed Nov 7 08:34:10 PST 2001
>Last-Modified:  Wed Nov 07 08:34:24 PST 2001
>Originator:     Michael Lucas
>Release:        FreeBSD 3.5-STABLE i386
>Organization:
None
>Environment:

today's -doc tree

>Description:

People are always asking about how to learn more about FreeBSD's
internals, or for a book on FreeBSD internals.  Add an explicit answer
to this question.

>How-To-Repeat:

read -hackers, -questions, -stable...

>Fix:

*** book.sgml-dist	Mon Nov  5 10:49:36 2001
--- book.sgml	Mon Nov  5 12:54:41 2001
***************
*** 11602,11607 ****
--- 11602,11624 ----
      <title>Advanced Topics</title>
  
      <qandaset>
+ 
+       <qandaentry>
+         <question id="learn-advanced">
+           <para>How can I learn more about FreeBSD's internals?</para>
+         </question>
+ 
+         <answer>
+           <para>At this time, there is no book on FreeBSD-specific OS
+             internals.  Much general UNIX knowledge is directly
+             applicable to FreeBSD, however.  Additionally, there are
+             BSD-specific books that are still relevant.</para>
+ 
+           <para>For a list, please check the <link
+             linkend="bibliography">FAQ bibliography</link>.</para>
+         </answer>
+       </qandaentry>
+ 
        <qandaentry>
          <question id="define-snap-release">
            <para>What are SNAPs and RELEASEs?</para>
>Release-Note:
>Audit-Trail:

From: Dima Dorfman <dima@trit.org>
To: mwlucas@blackhelicopters.org
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/31785: FAQ addition: advanced topics 
Date: Wed, 07 Nov 2001 14:34:27 +0000

 mwlucas@blackhelicopters.org wrote:
 > *** book.sgml-dist	Mon Nov  5 10:49:36 2001
 > --- book.sgml	Mon Nov  5 12:54:41 2001
 > ***************
 > *** 11602,11607 ****
 > --- 11602,11624 ----
 >       <title>Advanced Topics</title>
 >   
 >       <qandaset>
 > + 
 
 This newline isn't necessary.
 
 > +       <qandaentry>
 > +         <question id="learn-advanced">
 > +           <para>How can I learn more about FreeBSD's internals?</para>
 > +         </question>
 > + 
 > +         <answer>
 > +           <para>At this time, there is no book on FreeBSD-specific OS
 > +             internals.  Much general UNIX knowledge is directly
 > +             applicable to FreeBSD, however.  Additionally, there are
 > +             BSD-specific books that are still relevant.</para>
 > + 
 > +           <para>For a list, please check the <link
 > +             linkend="bibliography">FAQ bibliography</link>.</para>
 
 Hmm, how about a link to the "Operating System Internals" section of
 the Handbook Bibliography?  There's little in the above link that
 would actually help the reader.

From: Michael Lucas <mwlucas@blackhelicopters.org>
To: Dima Dorfman <dima@trit.org>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/31785: FAQ addition: advanced topics
Date: Wed, 7 Nov 2001 11:20:52 -0500

 --vtzGhvizbBRQ85DL
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 On Wed, Nov 07, 2001 at 02:34:27PM +0000, Dima Dorfman wrote:
 > Hmm, how about a link to the "Operating System Internals" section of
 > the Handbook Bibliography?  There's little in the above link that
 > would actually help the reader.
 
 Yep, much better idea!  I recently reread the whole docproj, but still
 don't have everything down, sorry.
 
 See attached.
 
 ==ml
 
 -- 
 Michael Lucas
 mwlucas@blackhelicopters.org
 http://www.blackhelicopters.org/~mwlucas/
 Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons
 
 --vtzGhvizbBRQ85DL
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename=learnmore
 
 *** en_US.ISO8859-1/books/faq/book.sgml-dist	Mon Nov  5 10:49:36 2001
 --- en_US.ISO8859-1/books/faq/book.sgml	Wed Nov  7 11:18:42 2001
 ***************
 *** 11603,11608 ****
 --- 11603,11625 ----
   
       <qandaset>
         <qandaentry>
 +         <question id="learn-advanced">
 +           <para>How can I learn more about FreeBSD's internals?</para>
 +         </question>
 + 
 +         <answer>
 +           <para>At this time, there is no book on FreeBSD-specific OS
 +             internals.  Much general UNIX knowledge is directly
 +             applicable to FreeBSD, however.  Additionally, there are
 +             BSD-specific books that are still relevant.</para>
 + 
 +           <para>For a list, please check the Handbook's <ulink
 +             URL="../handbook/bibliography-osinternals.html">Operating
 +             System Internals Bibliography</ulink>.</para>
 +         </answer>
 +       </qandaentry>
 + 
 +       <qandaentry>
           <question id="define-snap-release">
             <para>What are SNAPs and RELEASEs?</para>
           </question>
 
 --vtzGhvizbBRQ85DL--
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Wed Nov 7 08:34:10 PST 2001 
State-Changed-Why:  
Committed, thanks! 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=31785 
>Unformatted:
