From simon@arthur.nitro.dk  Thu Apr 10 11:35:50 2003
Return-Path: <simon@arthur.nitro.dk>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id C273C37B401
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 10 Apr 2003 11:35:50 -0700 (PDT)
Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79])
	by mx1.FreeBSD.org (Postfix) with ESMTP id B793C43F93
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 10 Apr 2003 11:35:47 -0700 (PDT)
	(envelope-from simon@arthur.nitro.dk)
Received: by arthur.nitro.dk (Postfix, from userid 1000)
	id 3A44F10BF94; Thu, 10 Apr 2003 20:35:46 +0200 (CEST)
Message-Id: <20030410183546.3A44F10BF94@arthur.nitro.dk>
Date: Thu, 10 Apr 2003 20:35:46 +0200 (CEST)
From: Simon L.Nielsen <simon@nitro.dk>
Reply-To: Simon L.Nielsen <simon@nitro.dk>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] Expand description of dumpdev use in Developers Handbook
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         50790
>Category:       docs
>Synopsis:       [patch] Expand description of dumpdev use in Developers Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Thu Apr 10 11:40:06 PDT 2003
>Closed-Date:    Sun May 04 20:41:41 PDT 2003
>Last-Modified:  Sun May 04 20:41:41 PDT 2003
>Originator:     Simon L. Nielsen
>Release:        FreeBSD 4.8-RC i386
>Organization:
>Environment:
>Description:
Document that setting dumpdev in rc.conf also automatically calls
savecore on boot.

Change a reference to /etc/rc.conf to use rc.conf(5) instead.
>How-To-Repeat:
>Fix:
--- doc-develbook-crashdump.patch begins here ---
Index: kerneldebug/chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml,v
retrieving revision 1.45
diff -u -d -r1.45 chapter.sgml
--- kerneldebug/chapter.sgml	12 Jan 2003 18:31:39 -0000	1.45
+++ kerneldebug/chapter.sgml	10 Apr 2003 18:23:14 -0000
@@ -24,7 +24,12 @@
 	(note that this will have to be done after configuring the partition in
 	question as swap space via &man.swapon.8;).  This is normally arranged
 	by setting the <varname>dumpdev</varname> variable in
-	<filename>/etc/rc.conf</filename>.</para>
+	&man.rc.conf.5;.  If you have set <varname>dumpdev</varname> variable
+	in &man.rc.conf.5; the &man.savecore.8; program will automatically be
+	called on the first multi-user boot after the crash and save the kernel
+	crash dump to the directory specified in the &man.rc.conf.5;
+	<varname>dumpdir</varname> variable (the default directory is
+	<filename>/var/crash</filename>).</para>
 
       <para>Alternatively, you can hard-code the dump device via the
 	<literal>dump</literal> clause in the <literal>config</literal> line of
--- doc-develbook-crashdump.patch ends here ---


>Release-Note:
>Audit-Trail:

From: Chris Pepper <pepper@reppep.com>
To: "Simon L.Nielsen" <simon@nitro.dk>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/50790: [patch] Expand description of dumpdev use in
 Developers 	Handbook
Date: Fri, 11 Apr 2003 12:01:44 -0400

 At 8:35 PM +0200 2003/04/10, Simon L.Nielsen wrote:
 >  >Number:         50790
 >>Category:       docs
 >  >Synopsis:       [patch] Expand description of dumpdev use in Developers
 >
 >--- doc-develbook-crashdump.patch begins here ---
 >Index: kerneldebug/chapter.sgml
 >===================================================================
 >RCS file: 
 >/home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml,v
 >retrieving revision 1.45
 >diff -u -d -r1.45 chapter.sgml
 >--- kerneldebug/chapter.sgml	12 Jan 2003 18:31:39 -0000	1.45
 >+++ kerneldebug/chapter.sgml	10 Apr 2003 18:23:14 -0000
 >@@ -24,7 +24,12 @@
 >  	(note that this will have to be done after configuring the partition in
 >  	question as swap space via &man.swapon.8;).  This is normally arranged
 >  	by setting the <varname>dumpdev</varname> variable in
 >-	<filename>/etc/rc.conf</filename>.</para>
 >+	&man.rc.conf.5;.  If you have set <varname>dumpdev</varname> variable
 
 	s/set <varname>dumpdev</varname> variable/
 	  set the <varname>dumpdev</varname> variable/
 or	s/set <varname>dumpdev</varname> variable/
 	  set <varname>dumpdev</varname>/
 
 >+	in &man.rc.conf.5; the &man.savecore.8; program will automatically be
 >+	called on the first multi-user boot after the crash and save the kernel
 >+	crash dump to the directory specified in the &man.rc.conf.5;
 >+	<varname>dumpdir</varname> variable (the default directory is
 >+	<filename>/var/crash</filename>).</para>
 
 -- 
 Chris Pepper:               <http://www.reppep.com/~pepper/>
 Rockefeller University:     <http://www.rockefeller.edu/>

From: "Simon L. Nielsen" <simon@nitro.dk>
To: Chris Pepper <pepper@reppep.com>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/50790: [patch] Expand description of dumpdev use in Developers 	Handbook
Date: Mon, 14 Apr 2003 12:05:22 +0200

 --U+BazGySraz5kW0T
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On 2003.04.11 12:01:44 -0400, Chris Pepper wrote:
 > At 8:35 PM +0200 2003/04/10, Simon L.Nielsen wrote:
 > > 	by setting the <varname>dumpdev</varname> variable in
 > >-	<filename>/etc/rc.conf</filename>.</para>
 > >+	&man.rc.conf.5;.  If you have set <varname>dumpdev</varname> variable
 >=20
 > 	s/set <varname>dumpdev</varname> variable/
 > 	  set the <varname>dumpdev</varname> variable/
 > or	s/set <varname>dumpdev</varname> variable/
 > 	  set <varname>dumpdev</varname>/
 
 Seems right. I don't really know which is best so I hope a native
 english speaker can decide which is preferable.
 
 Thanks for looking at it.
 
 --=20
 Simon L. Nielsen
 
 --U+BazGySraz5kW0T
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.1 (FreeBSD)
 
 iD8DBQE+mofh8kocFXgPTRwRAnyJAJ9U82eVVC+x8+L9oJhcB/8MC0UIBACdEq0o
 DdJER3NRhHW7ZuXnsqqo1yQ=
 =cYhU
 -----END PGP SIGNATURE-----
 
 --U+BazGySraz5kW0T--
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Sun May 4 20:40:03 PDT 2003 
State-Changed-Why:  
I've committed an update to this paragraph that takes into account 
your original change and Chris' improvement.  One thing to note is 
that it doesn't look good to use the man page entities twice in close 
proximity.  So I used &man.dumpon.8; the first time, then just used 
<command>dumpon</command> elsewhere in the paragraph. 

This chapter needs a lot of work, so if you can make any more 
extensive grammar improvements throughout this chapter it would be 
much appreciated.  Thanks. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=50790 
>Unformatted:
