From owner-freebsd-doc@FreeBSD.ORG Sun Jul 1 00:09:04 2007 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id BC3CD16A400 for ; Sun, 1 Jul 2007 00:09:04 +0000 (UTC) (envelope-from minimarmot@gmail.com) Received: from py-out-1112.google.com (py-out-1112.google.com [64.233.166.180]) by mx1.freebsd.org (Postfix) with ESMTP id 782CB13C44C for ; Sun, 1 Jul 2007 00:09:04 +0000 (UTC) (envelope-from minimarmot@gmail.com) Received: by py-out-1112.google.com with SMTP id u77so2177279pyb for ; Sat, 30 Jun 2007 17:09:03 -0700 (PDT) DKIM-Signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=U15dyzjdvHlBNS2BgmHRXEvvyYzcQMZ9J7/qXzTND2AtPTEiTaaqRFPErukj46Jb2H72y0Noi5lFc27eyuigvyq+VpreHTR1ZhJRdAYuIStOlBd4ab45cOcnvX5uFSfJPPmbrGcY568IpqE3GBzXC2aBbGFrCeM+VIgAMRRiKS4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=Z/WlTptP19sEIJD7o4wJZoyNWio4YQZkl1w51gkMcAP/IGgkWq6D2FjiCnhUbGfAmcZPcD0ygxf8njGKyjDZfYyH8+NqdRGQffAD6KM0Kodr5BlUFhCRSiMr2PTg7YgcUpRmeYwNZf7J0XpsyvsWurV7oskGSKEo96bzgw6AgkY= Received: by 10.143.162.8 with SMTP id p8mr270141wfo.1183248542236; Sat, 30 Jun 2007 17:09:02 -0700 (PDT) Received: by 10.143.1.8 with HTTP; Sat, 30 Jun 2007 17:08:57 -0700 (PDT) Message-ID: <47d0403c0706301708u597f8608o233c8d717f74a3b5@mail.gmail.com> Date: Sun, 1 Jul 2007 00:08:57 +0000 From: "Ben Kaduk" To: freebsd-doc@freebsd.org In-Reply-To: <200706302337.l5UNb8rx001727@prolepsis.scs.uiuc.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <200706302337.l5UNb8rx001727@prolepsis.scs.uiuc.edu> Subject: Re: docs/114176: readability improvement to handbook install chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 01 Jul 2007 00:09:04 -0000 Sorry, I was in a hurry writing up the PR and forgot to change my email address Also forgot on 114177 and 114178 -Ben Kaduk On 6/30/07, Benjamin Kaduk wrote: > > >Number: 114176 > >Category: docs > >Synopsis: readability improvement to handbook install chapter > >Confidential: no > >Severity: non-critical > >Priority: low > >Responsible: freebsd-doc > >State: open > >Quarter: > >Keywords: > >Date-Required: > >Class: doc-bug > >Submitter-Id: current-users > >Arrival-Date: Sat Jun 30 23:40:02 GMT 2007 > >Closed-Date: > >Last-Modified: > >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 @@ > > 2-3 x RAM > > - The system's swap space is kept on this partition. > + The system's swap space is kept on the > + bpartition. > 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: > >Unformatted: > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" >