Date: Sun, 1 Jul 2007 00:08:57 +0000 From: "Ben Kaduk" <minimarmot@gmail.com> To: freebsd-doc@freebsd.org Subject: Re: docs/114176: readability improvement to handbook install chapter Message-ID: <47d0403c0706301708u597f8608o233c8d717f74a3b5@mail.gmail.com> In-Reply-To: <200706302337.l5UNb8rx001727@prolepsis.scs.uiuc.edu> References: <200706302337.l5UNb8rx001727@prolepsis.scs.uiuc.edu>
next in thread | previous in thread | raw e-mail | index | archive | help
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 <kaduk@prolepsis.scs.uiuc.edu> 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 @@ > > <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: > >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" >
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?47d0403c0706301708u597f8608o233c8d717f74a3b5>