From zeising@daemonic.se  Thu Feb  9 00:02:12 2012
Return-Path: <zeising@daemonic.se>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id D1A91106564A
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  9 Feb 2012 00:02:12 +0000 (UTC)
	(envelope-from zeising@daemonic.se)
Received: from mail.lysator.liu.se (mail.lysator.liu.se [IPv6:2001:6b0:17:f0a0::3])
	by mx1.freebsd.org (Postfix) with ESMTP id 2EE2F8FC0C
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  9 Feb 2012 00:02:12 +0000 (UTC)
Received: from mail.lysator.liu.se (localhost [127.0.0.1])
	by mail.lysator.liu.se (Postfix) with ESMTP id 75EA440007
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  9 Feb 2012 01:02:11 +0100 (CET)
Received: by mail.lysator.liu.se (Postfix, from userid 1004)
	id 6BD4D40010; Thu,  9 Feb 2012 01:02:11 +0100 (CET)
Received: from mx.daemonic.se (mx.daemonic.se [IPv6:2001:470:dca9:0:1::3])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by mail.lysator.liu.se (Postfix) with ESMTPSA id BCCC640007
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  9 Feb 2012 01:02:10 +0100 (CET)
Received: from mailscanner.daemonic.se (mailscanner.daemonic.se [IPv6:2001:470:dca9:0:1::6])
	by mx.daemonic.se (Postfix) with ESMTPS id 8074E119C1B
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  9 Feb 2012 01:02:10 +0100 (CET)
Received: from mx.daemonic.se ([IPv6:2001:470:dca9:0:1::3]) (using TLS with cipher CAMELLIA256-SHA)
	by mailscanner.daemonic.se (mailscanner.daemonic.se [2001:470:dca9:0:1::6]) (amavisd-new, port 10025)
	with ESMTPS id 1Bv4I4vcAjev for <FreeBSD-gnats-submit@freebsd.org>;
	Thu,  9 Feb 2012 01:02:08 +0100 (CET)
Received: from mail.daemonic.se (mail.daemonic.se [IPv6:2001:470:dca9:0:1::4])
	by mx.daemonic.se (Postfix) with ESMTPS id EEDA8119C17
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  9 Feb 2012 01:02:07 +0100 (CET)
Received: from vincent.daemonic.se (login.daemonic.se [IPv6:2001:470:dca9:0:1::10])
	by mail.daemonic.se (Postfix) with ESMTPS id DB95B12B20D
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  9 Feb 2012 01:02:07 +0100 (CET)
Received: (from zeising@localhost)
	by vincent.daemonic.se (8.14.5/8.14.5/Submit) id q19027Qj059241;
	Thu, 9 Feb 2012 01:02:07 +0100 (CET)
	(envelope-from zeising)
Message-Id: <201202090002.q19027Qj059241@vincent.daemonic.se>
Date: Thu, 9 Feb 2012 01:02:07 +0100 (CET)
From: Niclas Zeising <zeising@daemonic.se>
Reply-To: Niclas Zeising <zeising@daemonic.se>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] changes to swap section of config chapter
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         164920
>Category:       docs
>Synopsis:       [PATCH] changes to swap section of config chapter
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    eadler
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Thu Feb 09 00:10:07 UTC 2012
>Closed-Date:    Mon Mar 26 16:58:38 UTC 2012
>Last-Modified:  Mon Mar 26 16:58:38 UTC 2012
>Originator:     Niclas Zeising
>Release:        FreeBSD 9.0-BETA2 amd64
>Organization:
>Environment:
System: FreeBSD vincent.daemonic.se 9.0-BETA2 FreeBSD 9.0-BETA2 #0 r225368: Sat Sep 3 22:13:26 CEST 2011 root@vincent.daemonic.se:/usr/obj/usr/src/sys/VINCENT amd64


	
>Description:
	The section about adding swap space on a new harddrive in the configuation and tuning chapter of the handbook is rather inadequate, and the language used is perhaps not entirely suitable for the handbook.
>How-To-Repeat:
	
>Fix:

	Attached patch rewrites this section of the handbook to add a more throughout and clear explanation on how to add more swap space using an existing or new harddrive.
	Prodded by: A friend who at first couldn't figure out how to add more swap space to a machine.

--- handbook.config.chapter.sgml.diff begins here ---
Index: en_US.ISO8859-1/books/handbook/config/chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v
retrieving revision 1.250
diff -u -d -r1.250 chapter.sgml
--- en_US.ISO8859-1/books/handbook/config/chapter.sgml	31 Jan 2012 14:14:59 -0000	1.250
+++ en_US.ISO8859-1/books/handbook/config/chapter.sgml	8 Feb 2012 23:14:35 -0000
@@ -2390,15 +2390,37 @@
       <xref linkend="swap-encrypting"> of the Handbook.</para>
 
     <sect2 id="new-drive-swap">
-      <title>Swap on a New Hard Drive</title>
+      <title>Swap on a New or Existing Hard Drive</title>
 
-      <para>The best way to add swap, of course, is to use this as an
-	excuse to add another hard drive.  You can always use another
-	hard drive, after all.  If you can do this, go reread the
-	discussion of swap space
-	in <xref linkend="configtuning-initial">
-	of the Handbook for some suggestions on how to best
-	arrange your swap.</para>
+      <para>The best way, and the way that gives most performance, is to add
+	a new swap partition on an existing or new hard drive.  How to set up
+	partitions and harddrives is explaned in <xref linkend="disks-adding">
+	and <xref linkend="configtuning-initial"> contains a discussion on
+	partition layouts and swap partition size considerations.</para>
+      <para>When a partition is prepared and selected, &man.swapon.8; is used
+	to add the partition to the system.  If the partition is
+	<filename>/dev/ada1s1p2</filename>, this will look like:</para>
+
+      <screen>&prompt.root; <userinput>swapon
+	<replaceable>/dev/ada1s1p2</replaceable></userinput></screen>
+
+      <warning>
+	<para>It is posible to use any partition not currently mounted, even
+	  if it contains a file system.  If the partition contains a file
+	  system and is mounted as swap space, the filesystem will be
+	  destroyed.  Therefore, make sure that the partition to be added as
+	  swap partition is really the intended partition, before running
+	  <command>swapon</command>.</para>
+      </warning>
+
+      <para>To make this new swap partition automatically added on boot,
+	change <filename>/etc/fstab</filename> to include an entry for the
+	partition.  This entry can look something like:</para>
+
+      <programlistning>/dev/ada1s1p1	none	swap	sw	0	0</programlistning>
+
+      <para>For an explanation of entries in <filename>/etc/fstab</filename>,
+	refer to &man.fstab.5;.</para>
     </sect2>
 
     <sect2 id="nfs-swap">
--- handbook.config.chapter.sgml.diff ends here ---


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->eadler 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Thu Feb 9 00:11:30 UTC 2012 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=164920 

From: Niclas Zeising <zeising@daemonic.se>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/164920: [PATCH] changes to swap section of config chapter
Date: Thu, 09 Feb 2012 16:33:48 +0100

 This is a multi-part message in MIME format.
 --------------040301050107050701050101
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: 7bit
 
 For some reason, the patch I attached to the PR has been mangled.  Here
 is the patch again, hopefully this time it works better.
 -- 
 Niclas
 
 --------------040301050107050701050101
 Content-Type: text/plain;
  name="handbook.config.chapter.sgml.diff"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="handbook.config.chapter.sgml.diff"
 
 Index: en_US.ISO8859-1/books/handbook/config/chapter.sgml
 ===================================================================
 RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v
 retrieving revision 1.250
 diff -u -d -r1.250 chapter.sgml
 --- en_US.ISO8859-1/books/handbook/config/chapter.sgml	31 Jan 2012 14:14:59 -0000	1.250
 +++ en_US.ISO8859-1/books/handbook/config/chapter.sgml	8 Feb 2012 23:14:35 -0000
 @@ -2390,15 +2390,37 @@
        <xref linkend="swap-encrypting"> of the Handbook.</para>
  
      <sect2 id="new-drive-swap">
 -      <title>Swap on a New Hard Drive</title>
 +      <title>Swap on a New or Existing Hard Drive</title>
  
 -      <para>The best way to add swap, of course, is to use this as an
 -	excuse to add another hard drive.  You can always use another
 -	hard drive, after all.  If you can do this, go reread the
 -	discussion of swap space
 -	in <xref linkend="configtuning-initial">
 -	of the Handbook for some suggestions on how to best
 -	arrange your swap.</para>
 +      <para>The best way, and the way that gives most performance, is to add
 +	a new swap partition on an existing or new hard drive.  How to set up
 +	partitions and harddrives is explaned in <xref linkend="disks-adding">
 +	and <xref linkend="configtuning-initial"> contains a discussion on
 +	partition layouts and swap partition size considerations.</para>
 +      <para>When a partition is prepared and selected, &man.swapon.8; is used
 +	to add the partition to the system.  If the partition is
 +	<filename>/dev/ada1s1p2</filename>, this will look like:</para>
 +
 +      <screen>&prompt.root; <userinput>swapon
 +	<replaceable>/dev/ada1s1p2</replaceable></userinput></screen>
 +
 +      <warning>
 +	<para>It is posible to use any partition not currently mounted, even
 +	  if it contains a file system.  If the partition contains a file
 +	  system and is mounted as swap space, the filesystem will be
 +	  destroyed.  Therefore, make sure that the partition to be added as
 +	  swap partition is really the intended partition, before running
 +	  <command>swapon</command>.</para>
 +      </warning>
 +
 +      <para>To make this new swap partition automatically added on boot,
 +	change <filename>/etc/fstab</filename> to include an entry for the
 +	partition.  This entry can look something like:</para>
 +
 +      <programlistning>/dev/ada1s1p1	none	swap	sw	0	0</programlistning>
 +
 +      <para>For an explanation of entries in <filename>/etc/fstab</filename>,
 +	refer to &man.fstab.5;.</para>
      </sect2>
  
      <sect2 id="nfs-swap">
 
 --------------040301050107050701050101--

From: Benedict Reuschling <bcr@FreeBSD.org>
To: bug-followup@FreeBSD.org, zeising@daemonic.se
Cc:  
Subject: Re: docs/164920: [PATCH] changes to swap section of config chapter
Date: Thu, 09 Feb 2012 17:06:18 +0100

 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA1
 
 Index: en_US.ISO8859-1/books/handbook/config/chapter.sgml
 ===================================================================
 RCS file:
 /home/ncvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v
 retrieving revision 1.250
 diff -u -d -r1.250 chapter.sgml
 - --- en_US.ISO8859-1/books/handbook/config/chapter.sgml     31 Jan 2012
 14:14:59 -0000      1.250
 +++ en_US.ISO8859-1/books/handbook/config/chapter.sgml    8 Feb 2012
 23:14:35 -0000
 @@ -2390,15 +2390,37 @@
        <xref linkend="swap-encrypting"> of the Handbook.</para>
 
      <sect2 id="new-drive-swap">
 - -      <title>Swap on a New Hard Drive</title>
 +      <title>Swap on a New or Existing Hard Drive</title>
 
 - -      <para>The best way to add swap, of course, is to use this as an
 - -   excuse to add another hard drive.  You can always use another
 - - hard drive, after all.  If you can do this, go reread the
 - -     discussion of swap space
 - -      in <xref linkend="configtuning-initial">
 - -      of the Handbook for some suggestions on how to best
 - -   arrange your swap.</para>
 +      <para>The best way, and the way that gives most performance, is
 to add
 +   a new swap partition on an existing or new hard drive.  How to set up
 + partitions and harddrives is explaned in <xref linkend="disks-adding">
 
 s/explaned/explained
 
 +        and <xref linkend="configtuning-initial"> contains a discussion on
 +    partition layouts and swap partition size considerations.</para>
 
 There must be a blank line here between the </para> and the <para> tags.
 
 +      <para>When a partition is prepared and selected, &man.swapon.8;
 is used
 +       to add the partition to the system.  If the partition is
 +      <filename>/dev/ada1s1p2</filename>, this will look like:</para>
 +
 +      <screen>&prompt.root; <userinput>swapon
 +    <replaceable>/dev/ada1s1p2</replaceable></userinput></screen>
 +
 +      <warning>
 +        <para>It is posible to use any partition not currently
 s/posible/possible
 
 mounted, even
 +      if it contains a file system.  If the partition contains a file
 +       system and is mounted as swap space, the filesystem will be
 
 You need to decide on a canonical form: it's either file system or
 filesystem, but not both in one patch. ;-)
 
 
 Other than that, I see nothing wrong with the patch.
 
 Regards
 
 Benedict Reuschling
 FreeBSD Documentation Committer
 
 The FreeBSD Documentation Project
 FreeBSD German Documentation Project - https://doc.bsdgroup.de
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.8 (Darwin)
 Comment: GPGTools - http://gpgtools.org
 Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
 
 iEYEARECAAYFAk8z7voACgkQTSZQLkqBk0iC1ACghD7tLf9+rcGyX+FhCKj0ghgQ
 3h8AoKdTMDbshO7KBuU9nvMvWfvAFnzl
 =XiwG
 -----END PGP SIGNATURE-----

From: Niclas Zeising <zeising@daemonic.se>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/164920: [PATCH] changes to swap section of config chapter
Date: Thu, 09 Feb 2012 20:02:40 +0100

 This is a multi-part message in MIME format.
 --------------010401050505060405040106
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: 7bit
 
 Here is a new patch fixing the things bcr@ found.
 Regards!
 -- 
 Niclas
 
 --------------010401050505060405040106
 Content-Type: text/plain;
  name="handbook.config.chapter.sgml.diff"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="handbook.config.chapter.sgml.diff"
 
 Index: en_US.ISO8859-1/books/handbook/config/chapter.sgml
 ===================================================================
 RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v
 retrieving revision 1.250
 diff -u -d -r1.250 chapter.sgml
 --- en_US.ISO8859-1/books/handbook/config/chapter.sgml	31 Jan 2012 14:14:59 -0000	1.250
 +++ en_US.ISO8859-1/books/handbook/config/chapter.sgml	9 Feb 2012 19:01:30 -0000
 @@ -2390,15 +2390,38 @@
        <xref linkend="swap-encrypting"> of the Handbook.</para>
  
      <sect2 id="new-drive-swap">
 -      <title>Swap on a New Hard Drive</title>
 +      <title>Swap on a New or Existing Hard Drive</title>
  
 -      <para>The best way to add swap, of course, is to use this as an
 -	excuse to add another hard drive.  You can always use another
 -	hard drive, after all.  If you can do this, go reread the
 -	discussion of swap space
 -	in <xref linkend="configtuning-initial">
 -	of the Handbook for some suggestions on how to best
 -	arrange your swap.</para>
 +      <para>The best way, and the way that gives most performance, is to add
 +	a new swap partition on an existing or new hard drive.  How to set up
 +	partitions and harddrives is explained in <xref linkend="disks-adding">
 +	and <xref linkend="configtuning-initial"> contains a discussion on
 +	partition layouts and swap partition size considerations.</para>
 +
 +      <para>When a partition is prepared and selected, &man.swapon.8; is used
 +	to add the partition to the system.  If the partition is
 +	<filename>/dev/ada1s1p2</filename>, this will look like:</para>
 +
 +      <screen>&prompt.root; <userinput>swapon
 +	<replaceable>/dev/ada1s1p2</replaceable></userinput></screen>
 +
 +      <warning>
 +	<para>It is possible to use any partition not currently mounted, even
 +	  if it contains a file system.  If the partition contains a file
 +	  system and is mounted as swap space, the file system will be
 +	  destroyed.  Therefore, make sure that the partition to be added as
 +	  swap partition is really the intended partition, before running
 +	  <command>swapon</command>.</para>
 +      </warning>
 +
 +      <para>To make this new swap partition automatically added on boot,
 +	change <filename>/etc/fstab</filename> to include an entry for the
 +	partition.  This entry can look something like:</para>
 +
 +      <programlistning>/dev/ada1s1p1	none	swap	sw	0	0</programlistning>
 +
 +      <para>For an explanation of entries in <filename>/etc/fstab</filename>,
 +	refer to &man.fstab.5;.</para>
      </sect2>
  
      <sect2 id="nfs-swap">
 
 --------------010401050505060405040106--
State-Changed-From-To: open->analyzed 
State-Changed-By: eadler 
State-Changed-When: Sat Mar 3 03:23:20 UTC 2012 
State-Changed-Why:  
awaiting review 

http://www.freebsd.org/cgi/query-pr.cgi?pr=164920 

From: Niclas Zeising <zeising@daemonic.se>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/164920: [PATCH] changes to swap section of config chapter
Date: Sat, 03 Mar 2012 14:42:13 +0100

 Where is the lastest revision, so I know what to look through?
 Regards!
 -- 
 Niclas Zeising

From: Eitan Adler <lists@eitanadler.com>
To: bug-followup@freebsd.org, zeising@daemonic.se
Cc:  
Subject: Re: docs/164920: [PATCH] changes to swap section of config chapter
Date: Sat, 17 Mar 2012 01:11:55 -0400

 --14dae9d71808f42e5204bb695e2f
 Content-Type: text/plain; charset=UTF-8
 
 What about this version?
 
 -- 
 Eitan Adler
 
 --14dae9d71808f42e5204bb695e2f
 Content-Type: text/x-patch; charset=US-ASCII; name="harmful-chemicals.diff"
 Content-Disposition: attachment; filename="harmful-chemicals.diff"
 Content-Transfer-Encoding: base64
 X-Attachment-Id: f_gzw798su0
 
 PyBjaGVjay1wbGVhc2UuZGlmZgpJbmRleDogY2hhcHRlci5zZ21sCj09PT09PT09PT09PT09PT09
 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0KUkNTIGZp
 bGU6IC9ob21lL2RjdnMvZG9jL2VuX1VTLklTTzg4NTktMS9ib29rcy9oYW5kYm9vay9jb25maWcv
 Y2hhcHRlci5zZ21sLHYKcmV0cmlldmluZyByZXZpc2lvbiAxLjI1MQpkaWZmIC11IC1yMS4yNTEg
 Y2hhcHRlci5zZ21sCi0tLSBjaGFwdGVyLnNnbWwJMTMgRmViIDIwMTIgMDQ6Mjg6MzUgLTAwMDAJ
 MS4yNTEKKysrIGNoYXB0ZXIuc2dtbAkxNyBNYXIgMjAxMiAwNTowNzo0NiAtMDAwMApAQCAtNDcz
 LDEzICs0NzMsMTQgQEAKICAgICAgIGNlcnRhaW4gdGltZXMuPC9wYXJhPgogCiAgICAgPHBhcmE+
 VGhlIDxjb21tYW5kPmNyb248L2NvbW1hbmQ+IHV0aWxpdHkgdXNlcyB0d28gZGlmZmVyZW50Ci0g
 ICAgICB0eXBlcyBvZiBjb25maWd1cmF0aW9uIGZpbGVzLCB0aGUgc3lzdGVtIGNyb250YWIgYW5k
 IHVzZXIgY3JvbnRhYnMuIFRoZQotICAgICAgb25seSBkaWZmZXJlbmNlIGJldHdlZW4gdGhlc2Ug
 dHdvIGZvcm1hdHMgaXMgdGhlIHNpeHRoIGZpZWxkLiAgSW4gdGhlCi0gICAgICBzeXN0ZW0gY3Jv
 bnRhYiwgdGhlIHNpeHRoIGZpZWxkIGlzIHRoZSBuYW1lIG9mIGEgdXNlciBmb3IgdGhlIGNvbW1h
 bmQKLSAgICAgIHRvIHJ1biBhcy4gVGhpcyBnaXZlcyB0aGUgc3lzdGVtIGNyb250YWIgdGhlIGFi
 aWxpdHkgdG8gcnVuIGNvbW1hbmRzCi0gICAgICBhcyBhbnkgdXNlci4gSW4gYSB1c2VyIGNyb250
 YWIsIHRoZSBzaXh0aCBmaWVsZCBpcyB0aGUgY29tbWFuZCB0byBydW4sCi0gICAgICBhbmQgYWxs
 IGNvbW1hbmRzIHJ1biBhcyB0aGUgdXNlciB3aG8gY3JlYXRlZCB0aGUgY3JvbnRhYjsgdGhpcyBp
 cyBhbgotICAgICAgaW1wb3J0YW50IHNlY3VyaXR5IGZlYXR1cmUuPC9wYXJhPgorICAgICAgdHlw
 ZXMgb2YgY29uZmlndXJhdGlvbiBmaWxlcywgdGhlIHN5c3RlbSBjcm9udGFiIGFuZCB1c2VyCisg
 ICAgICBjcm9udGFicy4gIFRoZXNlIGZvcm1hdHMgb25seSBkaWZmZXIgaW4gdGhlIHNpeHRoIGZp
 ZWxkIGFuZAorICAgICAgbGF0ZXIuICBJbiB0aGUgc3lzdGVtIGNyb250YWIsIDxjb21tYW5kPmNy
 b248L2NvbW1hbmQ+IHdpbGwgcnVuCisgICAgICB0aGUgY29tbWFuZCBhcyB0aGUgdXNlciBzcGVj
 aWZpZWQgaW4gdGhlIHNpeHRoIGZpZWxkLiAgSW4gYSB1c2VyCisgICAgICBjcm9udGFiLCBhbGwg
 Y29tbWFuZHMgcnVuIGFzIHRoZSB1c2VyIHdobyBjcmVhdGVkIHRoZSBjcm9udGFiLAorICAgICAg
 c28gdGhlIHNpeHRoIGZpZWxkIGlzIHRoZSBsYXN0IGZpZWxkOyB0aGlzIGlzIGFuIGltcG9ydGFu
 dAorICAgICAgc2VjdXJpdHkgZmVhdHVyZS4gIFRoZSBmaW5hbCBmaWVsZCBpcyBhbHdheXMgdGhl
 IGNvbW1hbmQKKyAgICAgIHRvIHJ1bi48L3BhcmE+CiAKICAgICA8bm90ZT4KICAgICAgIDxwYXJh
 PlVzZXIgY3JvbnRhYnMgYWxsb3cgaW5kaXZpZHVhbCB1c2VycyB0byBzY2hlZHVsZSB0YXNrcyB3
 aXRob3V0IHRoZSAKQEAgLTQ4NywxMCArNDg4LDExIEBACiAgICAgICAgIHBlcm1pc3Npb25zIG9m
 IHRoZSB1c2VyIHdobyBvd25zIHRoZSBjcm9udGFiLjwvcGFyYT4KIAogICAgICAgPHBhcmE+VGhl
 IDx1c2VybmFtZT5yb290PC91c2VybmFtZT4gdXNlciBjYW4gaGF2ZSBhIHVzZXIgY3JvbnRhYiBq
 dXN0IGxpa2UKLSAgICAgICAgYW55IG90aGVyIHVzZXIuIFRoaXMgb25lIGlzIGRpZmZlcmVudCBm
 cm9tCi0gICAgICAgIDxmaWxlbmFtZT4vZXRjL2Nyb250YWI8L2ZpbGVuYW1lPiAodGhlIHN5c3Rl
 bSBjcm9udGFiKS4gQmVjYXVzZSBvZiB0aGUKLSAgICAgICAgc3lzdGVtIGNyb250YWIsIHRoZXJl
 IGlzIHVzdWFsbHkgbm8gbmVlZCB0byBjcmVhdGUgYSB1c2VyIGNyb250YWIKLSAgICAgICAgZm9y
 IDx1c2VybmFtZT5yb290PC91c2VybmFtZT4uPC9wYXJhPgorCWFueSBvdGhlciB1c2VyLiAgVGhl
 IDx1c2VybmFtZT5yb290PC91c2VybmFtZT4gdXNlciBjcm9udGFiIGlzCisJc2VwYXJhdGUgZnJv
 bSA8ZmlsZW5hbWU+L2V0Yy9jcm9udGFiPC9maWxlbmFtZT4gKHRoZSBzeXN0ZW0KKwljcm9udGFi
 KS4gIEJlY2F1c2UgdGhlIHN5c3RlbSBjcm9udGFiIGVmZmVjdGl2ZWx5CisJaW52b2tlcyB0aGUg
 c3BlY2lmaWVkIGNvbW1hbmRzIGFzIHJvb3QgdGhlcmUgaXMgdXN1YWxseSBubyBuZWVkIHRvCisJ
 Y3JlYXRlIGEgdXNlciBjcm9udGFiIGZvciA8dXNlcm5hbWU+cm9vdDwvdXNlcm5hbWU+LjwvcGFy
 YT4KICAgICA8L25vdGU+CiAKICAgICA8cGFyYT5MZXQgdXMgdGFrZSBhIGxvb2sgYXQgdGhlIDxm
 aWxlbmFtZT4vZXRjL2Nyb250YWI8L2ZpbGVuYW1lPiBmaWxlCkBAIC01NDcsMTEgKzU0OSw4IEBA
 CiAJICBkYXkgb2YgdGhlIHdlZWsuICBBbGwgdGhlc2UgZmllbGRzIG11c3QgYmUgbnVtZXJpYyB2
 YWx1ZXMsIGFuZCBmb2xsb3cKIAkgIHRoZSB0d2VudHktZm91ciBob3VyIGNsb2NrLiAgVGhlIDxs
 aXRlcmFsPndobzwvbGl0ZXJhbD4gZmllbGQgaXMgc3BlY2lhbCwKIAkgIGFuZCBvbmx5IGV4aXN0
 cyBpbiB0aGUgPGZpbGVuYW1lPi9ldGMvY3JvbnRhYjwvZmlsZW5hbWU+IGZpbGUuCi0JICBUaGlz
 IGZpZWxkIHNwZWNpZmllcyB3aGljaCB1c2VyIHRoZSBjb21tYW5kIHNob3VsZCBiZSBydW4gYXMu
 Ci0JICBXaGVuIGEgdXNlciBpbnN0YWxscyBoaXMgb3IgaGVyIDxmaWxlbmFtZT5jcm9udGFiPC9m
 aWxlbmFtZT4gZmlsZSwgdGhleQotCSAgd2lsbCBub3QgaGF2ZSB0aGlzIG9wdGlvbi4gRmluYWxs
 eSwgdGhlIDxsaXRlcmFsPmNvbW1hbmQ8L2xpdGVyYWw+IG9wdGlvbiBpcyBsaXN0ZWQuCi0JICBU
 aGlzIGlzIHRoZSBsYXN0IGZpZWxkLCBzbyBuYXR1cmFsbHkgaXQgc2hvdWxkIGRlc2lnbmF0ZSB0
 aGUgY29tbWFuZAotCSAgdG8gYmUgZXhlY3V0ZWQuPC9wYXJhPgorCSAgVGhpcyBmaWVsZCBzcGVj
 aWZpZXMgd2hpY2ggdXNlciB0aGUgY29tbWFuZCBzaG91bGQgYmUgcnVuCisJICBhcy4gIFRoZSBs
 YXN0IGZpZWxkIGlzIHRoZSBjb21tYW5kIHRvIGJlIGV4ZWN1dGVkLjwvcGFyYT4KICAgICAgIDwv
 Y2FsbG91dD4KIAogICAgICAgPGNhbGxvdXQgYXJlYXJlZnM9ImNvLW1haW4iPgpAQCAtNTg0LDgg
 KzU4Myw5IEBACiAgICAgICA8dGl0bGU+SW5zdGFsbGluZyBhIENyb250YWI8L3RpdGxlPgogCiAg
 ICAgICA8aW1wb3J0YW50PgotICAgICAgPHBhcmE+WW91IG11c3Qgbm90IHVzZSB0aGUgcHJvY2Vk
 dXJlIGRlc2NyaWJlZCBoZXJlIHRvCi0gICAgICAgIGVkaXQvaW5zdGFsbCB0aGUgc3lzdGVtIGNy
 b250YWIuIFNpbXBseSB1c2UgeW91ciBmYXZvcml0ZQorICAgICAgPHBhcmE+RG8gbm90IHVzZSB0
 aGUgcHJvY2VkdXJlIGRlc2NyaWJlZCBoZXJlIHRvCisgICAgICAgIGVkaXQgYW5kIGluc3RhbGwg
 dGhlIHN5c3RlbSBjcm9udGFiLAorICAgICAgICA8ZmlsZW5hbWU+L2V0Yy9jcm9udGFiPC9maWxl
 bmFtZT4uICBKdXN0IHVzZSB5b3VyIGZhdm9yaXRlCiAgICAgICAgIGVkaXRvcjogdGhlIDxjb21t
 YW5kPmNyb248L2NvbW1hbmQ+IHV0aWxpdHkgd2lsbCBub3RpY2UgdGhhdCB0aGUgZmlsZQogICAg
 ICAgICBoYXMgY2hhbmdlZCBhbmQgaW1tZWRpYXRlbHkgYmVnaW4gdXNpbmcgdGhlIHVwZGF0ZWQg
 dmVyc2lvbi4gCiAgICAgICAgIFNlZQpAQCAtNjE2LDcgKzYxNiw3IEBACiAJYXV0b21hdGljYWxs
 eSBpbnN0YWxsZWQgYnkgdGhlIDxjb21tYW5kPmNyb250YWI8L2NvbW1hbmQ+IGNvbW1hbmQuCiAg
 ICAgICA8L3BhcmE+CiAgICAgICAKLSAgICAgIDxwYXJhPklmIHlvdSBsYXRlciB3YW50IHRvIHJl
 bW92ZSB5b3VyIHVzZXIgPGZpbGVuYW1lPmNyb250YWI8L2ZpbGVuYW1lPgorICAgICAgPHBhcmE+
 SW4gb3JkZXIgdG8gcmVtb3ZlIGEgdXNlciA8ZmlsZW5hbWU+Y3JvbnRhYjwvZmlsZW5hbWU+CiAJ
 Y29tcGxldGVseSwgdXNlIDxjb21tYW5kPmNyb250YWI8L2NvbW1hbmQ+IHdpdGggdGhlIDxvcHRp
 b24+LXI8L29wdGlvbj4KIAlvcHRpb24uCiAgICAgICA8L3BhcmE+CkBAIC02MzYsNyArNjM2LDcg
 QEAKICAgICAgIDwvYXV0aG9yZ3JvdXA+CiAgICAgPC9zZWN0MWluZm8+CiAKLSAgICA8dGl0bGU+
 VXNpbmcgcmMgdW5kZXIgJm9zOzwvdGl0bGU+CisgICAgPHRpdGxlPlVzaW5nICZtYW4ucmMuODsg
 VW5kZXIgJm9zOzwvdGl0bGU+CiAKICAgICA8cGFyYT5JbiAyMDAyICZvczsgaW50ZWdyYXRlZCB0
 aGUgTmV0QlNECiAgICAgICA8ZmlsZW5hbWU+cmMuZDwvZmlsZW5hbWU+IHN5c3RlbSBmb3Igc3lz
 dGVtIGluaXRpYWxpemF0aW9uLgpAQCAtMTY3NCw3ICsxNjc0LDcgQEAKICAgPC9zZWN0MT4KIAog
 ICA8c2VjdDEgaWQ9ImNvbmZpZ3R1bmluZy1zeXNjdGwiPgotICAgIDx0aXRsZT5UdW5pbmcgd2l0
 aCBzeXNjdGw8L3RpdGxlPgorICAgIDx0aXRsZT5UdW5pbmcgd2l0aCAmbWFuLnN5c2N0bC44Ozwv
 dGl0bGU+CiAKICAgICA8aW5kZXh0ZXJtPjxwcmltYXJ5PnN5c2N0bDwvcHJpbWFyeT48L2luZGV4
 dGVybT4KICAgICA8aW5kZXh0ZXJtPgpAQCAtMTk0NCw3ICsxOTQ0LDcgQEAKIAlvdXQgb2Ygc3Bh
 Y2UgYW5kIHRoZSB1cGRhdGUgdG8gZmFpbC48L3BhcmE+CiAKICAgICAgIDxzZWN0Mz4KLQk8dGl0
 bGU+TW9yZSBEZXRhaWxzIGFib3V0IFNvZnQgVXBkYXRlczwvdGl0bGU+CisJPHRpdGxlPk1vcmUg
 RGV0YWlscyBBYm91dCBTb2Z0IFVwZGF0ZXM8L3RpdGxlPgogCiAJPGluZGV4dGVybT4KIAkgIDxw
 cmltYXJ5PlNvZnQgVXBkYXRlczwvcHJpbWFyeT4KQEAgLTIzOTAsMTUgKzIzOTAsMzkgQEAKICAg
 ICAgIDx4cmVmIGxpbmtlbmQ9InN3YXAtZW5jcnlwdGluZyI+IG9mIHRoZSBIYW5kYm9vay48L3Bh
 cmE+CiAKICAgICA8c2VjdDIgaWQ9Im5ldy1kcml2ZS1zd2FwIj4KLSAgICAgIDx0aXRsZT5Td2Fw
 IG9uIGEgTmV3IEhhcmQgRHJpdmU8L3RpdGxlPgorICAgICAgPHRpdGxlPlN3YXAgb24gYSBOZXcg
 b3IgRXhpc3RpbmcgSGFyZCBEcml2ZTwvdGl0bGU+CiAKLSAgICAgIDxwYXJhPlRoZSBiZXN0IHdh
 eSB0byBhZGQgc3dhcCwgb2YgY291cnNlLCBpcyB0byB1c2UgdGhpcyBhcyBhbgotCWV4Y3VzZSB0
 byBhZGQgYW5vdGhlciBoYXJkIGRyaXZlLiAgWW91IGNhbiBhbHdheXMgdXNlIGFub3RoZXIKLQlo
 YXJkIGRyaXZlLCBhZnRlciBhbGwuICBJZiB5b3UgY2FuIGRvIHRoaXMsIGdvIHJlcmVhZCB0aGUK
 LQlkaXNjdXNzaW9uIG9mIHN3YXAgc3BhY2UKLQlpbiA8eHJlZiBsaW5rZW5kPSJjb25maWd0dW5p
 bmctaW5pdGlhbCI+Ci0Jb2YgdGhlIEhhbmRib29rIGZvciBzb21lIHN1Z2dlc3Rpb25zIG9uIGhv
 dyB0byBiZXN0Ci0JYXJyYW5nZSB5b3VyIHN3YXAuPC9wYXJhPgorICAgICAgPHBhcmE+QWRkaW5n
 IGEgbmV3IGhhcmQgZHJpdmUgZm9yIHN3YXAgZ2l2ZXMgYmV0dGVyIHBlcmZvcm1hbmNlCisJdGhh
 biBhZGRpbmcgYSBwYXJ0aXRpb24gb24gYW4gZXhpc3RpbmcgZHJpdmUuICBTZXR0aW5nIHVwCisJ
 cGFydGl0aW9ucyBhbmQgaGFyZCBkcml2ZXMgaXMgZXhwbGFpbmVkIGluCisJPHhyZWYgbGlua2Vu
 ZD0iZGlza3MtYWRkaW5nIj4uCisJPHhyZWYgbGlua2VuZD0iY29uZmlndHVuaW5nLWluaXRpYWwi
 PgorCWRpc2N1c3NlcyBwYXJ0aXRpb24gbGF5b3V0cyBhbmQgc3dhcCBwYXJ0aXRpb24gc2l6ZQor
 CWNvbnNpZGVyYXRpb25zLjwvcGFyYT4KKworICAgICAgPHBhcmE+VXNlICZtYW4uc3dhcG9uLjg7
 IHRvIGFkZCBhIHN3YXAgcGFydGl0aW9uIHRvIHRoZSBzeXN0ZW0uCisgICAgICBGb3IgZXhhbXBs
 ZTo8L3BhcmE+CisKKyAgICAgIDxzY3JlZW4+JnByb21wdC5yb290OyA8dXNlcmlucHV0PnN3YXBv
 bjxyZXBsYWNlYWJsZT4gL2Rldi9hZGExczFwMjwvcmVwbGFjZWFibGU+PC91c2VyaW5wdXQ+PC9z
 Y3JlZW4+CisKKyAgICAgIDx3YXJuaW5nPgorCTxwYXJhPkl0IGlzIHBvc3NpYmxlIHRvIHVzZSBh
 bnkgcGFydGl0aW9uIG5vdCBjdXJyZW50bHkKKwkgIG1vdW50ZWQsIGV2ZW4gaWYgaXQgYWxyZWFk
 eSBjb250YWlucyBkYXRhLiAgVXNpbmcKKwkgICZtYW4uc3dhcG9uLjg7IG9uIGEgcGFydGl0aW9u
 IHRoYXQgY29udGFpbnMgZGF0YSB3aWxsCisJICBvdmVyd3JpdGUgYW5kIGRlc3Ryb3kgdGhhdCBk
 YXRhLiAgTWFrZSBzdXJlIHRoYXQgdGhlCisJICBwYXJ0aXRpb24gdG8gYmUgYWRkZWQgYXMgc3dh
 cCBpcyByZWFsbHkgdGhlIGludGVuZGVkCisJICBwYXJ0aXRpb24gYmVmb3JlIHJ1bm5pbmcKKwkg
 ICZtYW4uc3dhcG9uLjg7LjwvcGFyYT4KKyAgICAgIDwvd2FybmluZz4KKworICAgICAgPHBhcmE+
 VG8gYXV0b21hdGljYWxseSBhZGQgdGhpcyBzd2FwIHBhcnRpdGlvbiBvbiBib290LAorCWFkZCBh
 biBlbnRyeSB0byA8ZmlsZW5hbWU+L2V0Yy9mc3RhYjwvZmlsZW5hbWU+IGZvciB0aGUKKwlwYXJ0
 aXRpb246PC9wYXJhPgorCisgICAgICA8cHJvZ3JhbWxpc3Rpbmc+PHJlcGxhY2VhYmxlPi9kZXYv
 YWRhMXMxcDE8L3JlcGxhY2VhYmxlPglub25lCXN3YXAJc3cJMAkwPC9wcm9ncmFtbGlzdGluZz4K
 KworICAgICAgPHBhcmE+U2VlICZtYW4uZnN0YWIuNTsgZm9yIGFuIGV4cGxhaW5hdGlvbiBvZiB0
 aGUgZW50cmllcworCWluIDxmaWxlbmFtZT4vZXRjL2ZzdGFiPC9maWxlbmFtZT4uPC9wYXJhPgog
 ICAgIDwvc2VjdDI+CiAKICAgICA8c2VjdDIgaWQ9Im5mcy1zd2FwIj4KQEAgLTI4NzgsNyArMjkw
 Miw3IEBACiAJICBvbiBMaW51eCwgaXQgaXMgbGlrZWx5IGEgJm9zOyBkcml2ZXIgcHJvYmxlbSBh
 bmQgbmFycm93aW5nIGRvd24KIAkgIHdoaWNoIGRyaXZlciBjYXVzZXMgdGhlIHByb2JsZW1zIHdp
 bGwgaGVscCB1cyBmaXggdGhlIHByb2JsZW0uCiAJICBOb3RlIHRoYXQgdGhlIDxhY3JvbnltPkFD
 UEk8L2Fjcm9ueW0+IG1haW50YWluZXJzIGRvIG5vdAotCSAgdXN1YWxseSBtYWludGFpbiBvdGhl
 ciBkcml2ZXJzIChlLmcgc291bmQsCisJICB1c3VhbGx5IG1haW50YWluIG90aGVyIGRyaXZlcnMg
 KGUuZy4sIHNvdW5kLAogCSAgPGFjcm9ueW0+QVRBPC9hY3JvbnltPiwgZXRjLikgc28gYW55IHdv
 cmsgZG9uZSBvbiB0cmFja2luZwogCSAgZG93biBhIGRyaXZlciBwcm9ibGVtIHNob3VsZCBwcm9i
 YWJseSBldmVudHVhbGx5IGJlIHBvc3RlZAogCSAgdG8gdGhlICZhLmN1cnJlbnQubmFtZTsgbGlz
 dCBhbmQgbWFpbGVkIHRvIHRoZSBkcml2ZXIKQEAgLTI4OTgsNyArMjkyMiw3IEBACiAgICAgICA8
 L3NlY3QzPgogCiAgICAgICA8c2VjdDM+Ci0JPHRpdGxlPlN5c3RlbSBIYW5ncyAodGVtcG9yYXJ5
 IG9yIHBlcm1hbmVudCk8L3RpdGxlPgorCTx0aXRsZT5TeXN0ZW0gSGFuZ3MgKFRlbXBvcmFyeSBv
 ciBQZXJtYW5lbnQpPC90aXRsZT4KIAogCTxwYXJhPk1vc3Qgc3lzdGVtIGhhbmdzIGFyZSBhIHJl
 c3VsdCBvZiBsb3N0IGludGVycnVwdHMgb3IgYW4KIAkgIGludGVycnVwdCBzdG9ybS4gIENoaXBz
 ZXRzIGhhdmUgYSBsb3Qgb2YgcHJvYmxlbXMgYmFzZWQgb24gaG93CkBAIC0zMDU4LDcgKzMwODIs
 NyBAQAogCWhvdyB0byBmaXggdGhlbTo8L3BhcmE+CiAKICAgICAgIDxzZWN0Mz4KLQk8dGl0bGU+
 X09TIGRlcGVuZGVuY2llczwvdGl0bGU+CisJPHRpdGxlPl9PUyBEZXBlbmRlbmNpZXM8L3RpdGxl
 PgogCiAJPHBhcmE+U29tZSA8YWNyb255bT5BTUw8L2Fjcm9ueW0+IGFzc3VtZXMgdGhlIHdvcmxk
 IGNvbnNpc3RzIG9mCiAJICB2YXJpb3VzICZ3aW5kb3dzOyB2ZXJzaW9ucy4gIFlvdSBjYW4gdGVs
 bCAmb3M7IHRvIGNsYWltIGl0IGlzCkBAIC0zMDcwLDcgKzMwOTQsNyBAQAogICAgICAgPC9zZWN0
 Mz4KIAogICAgICAgPHNlY3QzPgotCTx0aXRsZT5NaXNzaW5nIFJldHVybiBzdGF0ZW1lbnRzPC90
 aXRsZT4KKwk8dGl0bGU+TWlzc2luZyBSZXR1cm4gU3RhdGVtZW50czwvdGl0bGU+CiAKIAk8cGFy
 YT5Tb21lIG1ldGhvZHMgZG8gbm90IGV4cGxpY2l0bHkgcmV0dXJuIGEgdmFsdWUgYXMgdGhlCiAJ
 ICBzdGFuZGFyZCByZXF1aXJlcy4gIFdoaWxlIDxhY3JvbnltPkFDUEktQ0E8L2Fjcm9ueW0+CkBA
 IC0zMTEyLDcgKzMxMzYsNyBAQAogICAgIDwvc2VjdDI+CiAKICAgICA8c2VjdDIgaWQ9IkFDUEkt
 ZGVidWdvdXRwdXQiPgotICAgICAgPHRpdGxlPkdldHRpbmcgRGVidWdnaW5nIE91dHB1dCBGcm9t
 CisgICAgICA8dGl0bGU+R2V0dGluZyBEZWJ1Z2dpbmcgT3V0cHV0IGZyb20KIAk8YWNyb255bT5B
 Q1BJPC9hY3JvbnltPjwvdGl0bGU+CiAKICAgICAgIDxpbmRleHRlcm0+Cg==
 --14dae9d71808f42e5204bb695e2f--

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/164920: commit references a PR
Date: Mon, 26 Mar 2012 16:42:41 +0000 (UTC)

 eadler      2012-03-26 16:42:26 UTC
 
   FreeBSD doc repository (src,ports committer)
 
   Modified files:
     en_US.ISO8859-1/books/handbook/config chapter.sgml 
   Log:
   Rewrite the config chapter to be more clear and use professional language.
   
   PR:             docs/164920
   Submitted by:   Niclas Zeising <zeising@daemonic.se>
   Reviewed by:    gjb (older version)
   Approved by:    bcr
   
   Revision  Changes    Path
   1.252     +50 -26    doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: analyzed->closed 
State-Changed-By: eadler 
State-Changed-When: Mon Mar 26 16:58:36 UTC 2012 
State-Changed-Why:  
Committed. Thanks! 

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