docs/75865: comments on "backup-basics" in handbook

[Ben Kaduk]

The following reply was made to PR docs/75865; it has been noted by GNATS.

From: "Ben Kaduk" <minimarmot at gmail.com>
To: bug-followup at freebsd.org
Cc:  
Subject: Re: docs/75865: comments on "backup-basics" in handbook
Date: Mon, 30 Jun 2008 22:16:39 -0400

 I think the inline patch should take care of this -- the other
 programs listed on the page do
 not seem to document using /tmp or other places for intermediate files.
 
 Note that I also reworeded a couple of sentences to avoid starting
 sentences with
 (lowercase) command names, as well.
 
 If gmail mangles whitespace, the patch can also be found at
 http://stuff.mit.edu/afs/sipb.mit.edu/user/kaduk/freebsd/patches/disks.diff.2008.07.01
 
 -Ben Kaduk
 
 --- chapter.sgml.0      2008-06-30 21:11:24.000000000 -0400
 +++ chapter.sgml        2008-06-30 22:09:30.000000000 -0400
 @@ -2380,12 +2380,19 @@
         <command>dump</command> and <command>restore</command>.  They
         operate on the drive as a collection of disk blocks, below the
         abstractions of files, links and directories that are created by
 -       the file systems. <command>dump</command> backs up an entire
 +       the file systems. Unlike other backup software,
 +       <command>dump</command> backs up an entire
         file system on a device.  It is unable to backup only part of a
         file system or a directory tree that spans more than one
 -       file system.  <command>dump</command> does not write files and
 +       file system.  The <command>dump</command> command does not
 write files and
         directories to tape, but rather writes the raw data blocks that
 -       comprise files and directories.</para>
 +       comprise files and directories.  When being used to extract
 +       data, <command>restore</command> stores temporary files
 +       in <filename>/tmp/</filename> by default &emdash; if you are
 +       operating from a recovery disk with a small
 +       <filename>/tmp</filename> directory, you may need to set the
 +       <envar>TMPDIR</envar> environment variable to a directory
 +       with more free space for the restore to be successful.</para>
 
        <note><para>If you use <command>dump</command> on your root
 directory, you
          would not back up <filename>/home</filename>,