From kaduk@prolepsis.scs.uiuc.edu  Sat Jun 30 23:37:51 2007
Return-Path: <kaduk@prolepsis.scs.uiuc.edu>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 8452916A421
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 30 Jun 2007 23:37:51 +0000 (UTC)
	(envelope-from kaduk@prolepsis.scs.uiuc.edu)
Received: from prolepsis.scs.uiuc.edu (74-139-211-128.dhcp.insightbb.com [74.139.211.128])
	by mx1.freebsd.org (Postfix) with ESMTP id 5053C13C4C2
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 30 Jun 2007 23:37:51 +0000 (UTC)
	(envelope-from kaduk@prolepsis.scs.uiuc.edu)
Received: from prolepsis.scs.uiuc.edu (localhost [127.0.0.1])
	by prolepsis.scs.uiuc.edu (8.13.8/8.13.8) with ESMTP id l5UNb9LY001728
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 30 Jun 2007 23:37:09 GMT
	(envelope-from kaduk@prolepsis.scs.uiuc.edu)
Received: (from kaduk@localhost)
	by prolepsis.scs.uiuc.edu (8.13.8/8.13.8/Submit) id l5UNb8rx001727;
	Sat, 30 Jun 2007 23:37:08 GMT
	(envelope-from kaduk)
Message-Id: <200706302337.l5UNb8rx001727@prolepsis.scs.uiuc.edu>
Date: Sat, 30 Jun 2007 23:37:08 GMT
From: Benjamin Kaduk <kaduk@prolepsis.scs.uiuc.edu>
Reply-To: Benjamin Kaduk <kaduk@prolepsis.scs.uiuc.edu>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: readability improvement to handbook install chapter
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         114176
>Category:       docs
>Synopsis:       readability improvement to handbook install chapter
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    murray
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jun 30 23:40:02 GMT 2007
>Closed-Date:    Sun Jul 01 01:35:25 GMT 2007
>Last-Modified:  Sun Jul 01 01:35:25 GMT 2007
>Originator:     Ben Kaduk
>Release:        FreeBSD 7.0-CURRENT i386
>Organization:
>Environment:
System: FreeBSD prolepsis.scs.uiuc.edu 7.0-CURRENT FreeBSD 7.0-CURRENT #1: Sun Apr 1 16:59:00 UTC 2007 kaduk@prolepsis.scs.uiuc.edu:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
	When viewing the handbook online, in the section on allocating disk space,
there is a table describing a partitioning scheme for installing FreeBSD.
However, in this table, the ``b'' partition is the only one which has a
multi-paragraph description.  This can cause confusion, as the vertical 
separation between rows of the table is approximatly the same as the
separation between pararaphs, and the first paragraph describing the swap
partition begins ``this partition''.  I propose to make explicit which
partition is being referred to, instead of relying on the user to 
correctly parse our table (which perhaps does not render as well as
it could).
>How-To-Repeat:
	http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/install-steps.html
>Fix:

--- chapter.sgml.orig   Sat Jun 30 17:15:48 2007
+++ chapter.sgml        Sat Jun 30 17:23:11 2007
@@ -1725,7 +1714,8 @@

              <entry>2-3 x RAM</entry>

-             <entry><para>The system's swap space is kept on this partition.
+             <entry><para>The system's swap space is kept on the
+                 <literal>b</literal>partition.
                  Choosing the right amount of swap space can be a bit of an
                  art.  A good rule of thumb is that your swap
                  space should be two or three times as much as the


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Sun Jul 1 01:34:33 UTC 2007 
State-Changed-Why:  
Submitted in r1.352 of install/chapter.sgml.  Thanks for the submission.  Website will be updated later today. 
I added a space between 'b' and 'partition' in your patch. 



Responsible-Changed-From-To: freebsd-doc->murray 
Responsible-Changed-By: murray 
Responsible-Changed-When: Sun Jul 1 01:34:33 UTC 2007 
Responsible-Changed-Why:  
Submitted in r1.352 of install/chapter.sgml.  Thanks for the submission.  Website will be updated later today. 
I added a space between 'b' and 'partition' in your patch. 


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