doc-el commit 1049:67fbf241a81e - Try a bit harder to explain wh...

[freebsd-doc-el at lists.hellug.gr]

changeset: 1049:67fbf241a81e
user:      keramida
date:      2008-11-13 06:53 +0200
details:   http://hg.hellug.gr/freebsd/doc-el/?cmd=changeset;node=67fbf241a81e

description:
	Try a bit harder to explain why `/var' or `/var/tmp' needs a lot of disk
	space, and reword the description of `/usr' to remove an instance of
	`Both of which' that seemed to be dangling from nowhere in particular.

diffstat:

1 file changed, 22 insertions(+), 13 deletions(-)
en_US.ISO8859-1/books/handbook/config/chapter.sgml |   35 ++++++++++++--------

diffs (59 lines):

diff -r 647c78e41726 -r 67fbf241a81e en_US.ISO8859-1/books/handbook/config/chapter.sgml
--- a/en_US.ISO8859-1/books/handbook/config/chapter.sgml	Thu Nov 13 06:34:04 2008 +0200
+++ b/en_US.ISO8859-1/books/handbook/config/chapter.sgml	Thu Nov 13 06:53:03 2008 +0200
@@ -117,25 +117,35 @@
 	  should be closer to the outside of the drive, while
 	  larger partitions like <filename>/usr</filename> should be placed
 	  toward the inner parts of the disk.  It is a good idea to create
-	  partitions in a similar order to: root, swap,
+	  partitions in an order similar to: root, swap,
 	  <filename>/var</filename>, <filename>/usr</filename>.</para>
 
-	<para>The size of <filename>/var</filename>
+	<para>The size of the <filename>/var</filename> partition
 	  reflects the intended machine usage.
-	  <filename>/var</filename> is used to hold
+	  The <filename>/var</filename> file system is used to hold
 	  mailboxes, log files, and printer spools.  Mailboxes and log
 	  files can grow to unexpected sizes depending
 	  on how many users exist and how long log
-	  files are kept.  Most users would never require a gigabyte,
-	  but remember that <filename>/var/tmp</filename>
-	  must be large enough to contain packages.
-	  </para>
+	  files are kept.  Most users will rarely need more than about a
+	  gigabyte of free disk space in <filename>/var</filename>.</para>
 
-	<para>The <filename>/usr</filename> partition holds much
-	  of the files required to support the system, the &man.ports.7;
-	  collection (recommended) and the source code (optional).  Both
-	  of which are optional at install time.
-	  At least 2 gigabytes would be recommended for this partition.</para>
+	<note>
+	  <para>There are a few times that a lot of disk space is required
+	    in <filename>/var/tmp</filename>.  When new software is installed
+	    with &man.pkg.add.1; the packaging tools extract a temporary copy
+	    of the packages under <filename>/var/tmp</filename>.  Large
+	    software packages, like <application>Firefox</application>,
+	    or <application>OpenOffice</application> may be tricky to install
+	    if there is not enough disk space
+	    under <filename>/var/tmp</filename>.</para>
+	</note>
+
+	<para>The <filename>/usr</filename> partition holds many
+	  of the files required to support the system, including the &man.ports.7;
+	  collection (recommended) and the source code (optional).  Both the
+	  ports and the sources of the base system are optional at install
+	  time, but we recommend at least 2 gigabytes for this
+	  partition.</para>
 
 	<para>When selecting partition sizes, keep the space
 	  requirements in mind.  Running out of space in
@@ -147,7 +157,6 @@
 	    sometimes select smaller than adequate <filename>/var</filename>
 	    and <filename>/</filename> partitions.  Partition wisely and
 	    generously.</para></note>
-
       </sect3>
 
       <sect3 id="swap-design">