svn commit: r42473 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/filesystems

[Benjamin Kaduk]

On Mon, 29 Jul 2013, Warren Block wrote:

> Author: wblock
> Date: Mon Jul 29 22:28:20 2013
> New Revision: 42473
> URL: http://svnweb.freebsd.org/changeset/doc/42473
>
> Log:
>  Update the ZFS section with Allan Jude's latest diff.
>
> Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/filesystems/chapter.xml
> ==============================================================================
> --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/filesystems/chapter.xml	Mon Jul 29 21:34:24 2013	(r42472)
> +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/filesystems/chapter.xml	Mon Jul 29 22:28:20 2013	(r42473)
> @@ -402,26 +395,44 @@
[...]
> 		ZFS can also create volumes, which are block devices.
> 		Volumes have many of the same features, including
> 		copy-on-write, snapshots, clones and
> -		checksumming.</entry>
> +		checksumming.  Volumes can be useful for running other
> +		file system formats on top of ZFS, such as UFS or in
> +		the case of Virtualization or exporting
> +		<acronym>iSCSI</acronym> extents.</entry>

I'm not entirely sure what's supposed to be going on in this sentence.  Is 
"such as UFS or in the case of Virtualization or exporting iSCSI extents" 
just supposed to be a list, but commas omitted because the scope is 
already inside a comma-separated list?  (Also, I don't see a need for 
"Virtualization" to be capitalized.)  The outer list could use semicolons 
to make the different scopes clearer, but perhaps a rewrite is better.

> 	    </row>
> @@ -710,10 +720,15 @@
> 	    </row>
>
> 	    <row>
> -	      <entry valign="top"><anchor
> -		id="filesystems-zfs-term-resilver"/>Resilver</entry>
> +	      <entry valign="top"
> +		id="filesystems-zfs-term-resilver">Resilver</entry>
>
> -	      <entry></entry>
> +	      <entry>When a disk fails and must be replaced, the new
> +		disk must be filled with the data that was lost.  This
> +		process of calculating and writing the missing data
> +		(using the parity information distributed across the
> +		remaining drives) to the new drive is called
> +		Resilvering.</entry>

Likewise, does "Resilvering" need to be capitalized?

-Ben

> 	    </row>
>
> 	  </tbody>