docs/170764: [zfs] 2399 zfs manual page does not document use of "zfs diff"

[Marcelo Araujo]

>Number:         170764
>Category:       docs
>Synopsis:       [zfs] 2399 zfs manual page does not document use of "zfs diff"
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Sun Aug 19 08:40:04 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Marcelo Araujo
>Release:        10-CURRENT
>Organization:
FreeBSD
>Environment:
FreeBSD hostb 10.0-CURRENT FreeBSD 10.0-CURRENT #0 r233530: Tue Apr  3 02:11:40 UTC 2012     araujo at hostb:/usr/obj/usr/src/sys/HOSTB  i386
>Description:
- A small manpage update, just to document the use of "zfs diff". This patch os partially obtained from Illumos-gate, changeset: 00c2a08cf1bb
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

Index: zfs.8
===================================================================
--- zfs.8	(revision 233530)
+++ zfs.8	(working copy)
@@ -3158,6 +3158,20 @@
         group staff @pset,create,mount
 -------------------------------------------------------------
 .Ed
+.It Sy Example 22 Showing the differences between a snapshot and a ZFS Dataset
+.Pp
+The following example shows how to see what has changed between a prior
+snapshot of a ZFS Dataset and its current state.  The -F option is used
+to indicate type information for the files affected.
+.Bd -literal -offset 2n
+.Li # Ic zfs diff -F tank/test at before tank/test
+  M       /       /tank/test/
+  M       F       /tank/test/linked      (+1)
+  R       F       /tank/test/oldname -> /tank/test/newname
+  -       F       /tank/test/deleted
+  +       F       /tank/test/created
+  M       F       /tank/test/modified
+.Ed
 .El
 .Sh EXIT STATUS
 The following exit values are returned:


>Release-Note:
>Audit-Trail:
>Unformatted: