From owner-svn-doc-projects@FreeBSD.ORG Mon Nov 25 18:11:57 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 94FBDE28; Mon, 25 Nov 2013 18:11:57 +0000 (UTC) Received: from dmz-mailsec-scanner-8.mit.edu (dmz-mailsec-scanner-8.mit.edu [18.7.68.37]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 13BC32D28; Mon, 25 Nov 2013 18:11:56 +0000 (UTC) X-AuditID: 12074425-b7fd96d000000c39-4a-529392e57c27 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) (using TLS with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by dmz-mailsec-scanner-8.mit.edu (Symantec Messaging Gateway) with SMTP id 07.B0.03129.5E293925; Mon, 25 Nov 2013 13:11:49 -0500 (EST) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id rAPIBnt2018918; Mon, 25 Nov 2013 13:11:49 -0500 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id rAPIBlBQ019768 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 25 Nov 2013 13:11:48 -0500 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id rAPIBkX5010705; Mon, 25 Nov 2013 13:11:46 -0500 (EST) Date: Mon, 25 Nov 2013 13:11:46 -0500 (EST) From: Benjamin Kaduk To: Warren Block Subject: Re: svn commit: r43242 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs In-Reply-To: <201311250558.rAP5w8LT097854@svn.freebsd.org> Message-ID: References: <201311250558.rAP5w8LT097854@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrJIsWRmVeSWpSXmKPExsUixCmqrft00uQggz0PrSx+fDzEZLHwzGpm i8vvJ7I4MHvM+DSfJYAxissmJTUnsyy1SN8ugStj2vPHrAUXxCoW9Uxga2BcLNTFyMkhIWAi 8fZNGwuELSZx4d56ti5GLg4hgdlMEsuvz4FyNjJKzP/YzAThHGKSuHFwNjuE08Aosbmtix2k n0VAW+JCyw5GEJtNQEVi5puNbCC2iICqxPfuVUwgNrOAjcSEBwvA6oUFEiT+Tv8EVMPBwSlg JfGyRxEkzCvgKLHq2W6wViEBS4l9PZ1g5aICOhKr909hgagRlDg58wkLxEhLiX9rf7FOYBSc hSQ1C0lqASPTKkbZlNwq3dzEzJzi1GTd4uTEvLzUIl0LvdzMEr3UlNJNjKBQZXdR3cE44ZDS IUYBDkYlHl6JzslBQqyJZcWVuYcYJTmYlER5uSYChfiS8lMqMxKLM+KLSnNSiw8xSnAwK4nw /iwByvGmJFZWpRblw6SkOViUxHlvcdgHCQmkJ5akZqemFqQWwWRlODiUJHg/9AM1ChalpqdW pGXmlCCkmTg4QYbzAA0/D7KYt7ggMbc4Mx0if4pRl+Pfh0/fGIVY8vLzUqXEeU+DFAmAFGWU 5sHNgaWYV4ziQG8J874BqeIBpie4Sa+AljABLekyAltSkoiQkmpgnBj1Pi7zaJnyvJCzWz74 Me/pY1S/95Zz5rJdPP/YX7MK2x48Zv08JjU6otBqdl28f0HxbunnOXd25JVe/FR4T4RRqafP oD43Y1s8609pxru3z2vcludbKOMkrJl5cuGp9Tdi20U2uhY4bp1ZEiv5Lv/dcluhNzN/yU+r YWbrjPvU/Fa1siZTiaU4I9FQi7moOBEA5s5pewwDAAA= Cc: svn-doc-projects@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.16 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 25 Nov 2013 18:11:57 -0000 On Mon, 25 Nov 2013, Warren Block wrote: > Author: wblock > Date: Mon Nov 25 05:58:08 2013 > New Revision: 43242 > URL: http://svnweb.freebsd.org/changeset/doc/43242 > > Log: > Edits for clarity and simplicity. > > Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml > ============================================================================== > --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Mon Nov 25 04:36:45 2013 (r43241) > +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Mon Nov 25 05:58:08 2013 (r43242) > @@ -732,10 +732,10 @@ History for 'tank': > 2013-02-27.18:51:13 [internal create txg:55] dataset = 39 > 2013-02-27.18:51:18 zfs create tank/backup > > - The other more detailed history display can be invoked by > - using the -l command. This will show the > - log records in long format, which includes more information > - like the user name who issued the command and the hostname on > + A more-detailed history is invoked by I do not think that "invoked" is quite the right word here; we are not calling upon the history, but rather printing it. > + adding -l. > + Log records are shown in long format, including information > + like the name of the user who issued the command and the hostname on > which the change was made. > > &prompt.root; zpool history -l > @@ -842,55 +840,53 @@ data 288G 1.53T > > Creating & Destroying Datasets > > - Unlike with traditional disks and volume managers, space > - in ZFS is not preallocated, allowing > - additional file systems to be created at any time. With > - traditional file systems, once all of the space was > - partitioned and assigned to a file system, there was no way to > + Unlike traditional disks and volume managers, space > + in ZFS is not preallocated. > + Wtraditional file systems, once all of the space was typo? > + partitioned and assigned, there was no way to > add an additional file system without adding a new disk. > @@ -1209,65 +1201,59 @@ tank custom:costcenter - > When enabled, > Deduplication > uses the checksum of each block to detect duplicate blocks. > + When a new block is a duplicate of an existing block, > + ZFS writes an additional reference to > + the existing data instead of the whole duplicate block. This can offer > + tremendous space savings if the data contains many discreet s/discreet/discrete/ -Ben > + copies of the file information. Be warned: deduplication requires an