gfs2-utils: master - man: More updates

[Steven Whitehouse <swhiteho at fedoraproject dot org>]

Gitweb:        http://git.fedorahosted.org/git/gfs2-utils.git?p=gfs2-utils.git;a=commitdiff;h=541c621554480a4c0012488336f91aa5fdf68c8c
Commit:        541c621554480a4c0012488336f91aa5fdf68c8c
Parent:        0b0419d6cfb8d11682f4ad0822053176fd69c02f
Author:        Steven Whitehouse <swhiteho@redhat.com>
AuthorDate:    Tue May 26 13:26:42 2009 +0100
Committer:     Steven Whitehouse <swhiteho@redhat.com>
CommitterDate: Tue May 26 13:26:42 2009 +0100

man: More updates

Various missing, obsolete, or items requiring updates. This should
help make our docs a bit clearer I think.

Signed-off-by: Steven Whitehouse <swhiteho@redhat.com>
---
 gfs2/man/gfs2_convert.8 |   16 +++++++++++++++-
 gfs2/man/gfs2_grow.8    |    7 ++++++-
 gfs2/man/gfs2_quota.8   |    2 +-
 gfs2/man/mount.gfs2.8   |   16 ++++++++++++++--
 4 files changed, 36 insertions(+), 5 deletions(-)

diff --git a/gfs2/man/gfs2_convert.8 b/gfs2/man/gfs2_convert.8
index 059863b..a05a690 100644
--- a/gfs2/man/gfs2_convert.8
+++ b/gfs2/man/gfs2_convert.8
@@ -8,7 +8,21 @@ gfs2_convert - Convert a GFS1 filesystem to GFS2
 [\fIOPTION\fR]... \fIDEVICE\fR
 
 .SH DESCRIPTION
-gfs2_convert is used to convert a filesystem from GFS1 to GFS2.
+gfs2_convert is used to convert a filesystem from GFS1 to GFS2. Do not
+attempt to convert a GFS1 filesystem which is not clean - the process
+of conversion will reinitialise the journals. We highly recommend that
+.B fsck.gfs
+is run successfully before attempting to convert a filesystem. Many
+of the on-disk structures are identical between GFS1 and GFS2, so
+the conversion process updates the journals, a few items of incompatible
+metadata (mostly indirect pointers and inodes) and adds the per-node
+directories required by the gfs2meta filesystem. The conversion process
+is performed in-place and does not require any extra disk space so that
+it is possible to successfully convert a GFS1 filesystem that is
+completely full.
+
+Always ensure you have a complete backup of the data on any filesystem
+before starting the conversion process.
 
 .SH OPTIONS
 .TP
diff --git a/gfs2/man/gfs2_grow.8 b/gfs2/man/gfs2_grow.8
index bd37328..a38f471 100644
--- a/gfs2/man/gfs2_grow.8
+++ b/gfs2/man/gfs2_grow.8
@@ -5,7 +5,7 @@ gfs2_grow - Expand a GFS2 filesystem
 
 .SH SYNOPSIS
 .B gfs2_grow
-[\fIOPTION\fR]... <\fIDEVICE\fR|\fIMOINTPOINT\fR>...
+[\fIOPTION\fR]... <\fIDEVICE\fR|\fIMOUNTPOINT\fR>...
 
 .SH DESCRIPTION
 gfs2_grow is used to expand a GFS2 filesystem after the device
@@ -57,5 +57,10 @@ have done were it run without this flag.
 \fB-V\fP
 Version. Print out version information, then exit.
 
+.SH BUGS
+
+There is no way to shrink a GFS2 filesystem.
+
 .SH SEE ALSO
 mkfs.gfs2(8) gfs2_jadd(8)
+
diff --git a/gfs2/man/gfs2_quota.8 b/gfs2/man/gfs2_quota.8
index 7b1311c..04e09e8 100644
--- a/gfs2/man/gfs2_quota.8
+++ b/gfs2/man/gfs2_quota.8
@@ -11,7 +11,7 @@ gfs2_quota - Manipulate GFS2 disk quotas
 gfs2_quota is used to examine and change quota values in a GFS2 filesystem.
 This command has a number of different actions.
 
-GFS2(5.1) introduced a new linked list format for the quotas in the quota file.
+GFS2 introduced a new linked list format for the quotas in the quota file.
 This list format allows for faster \fBlist\fP, \fBcheck\fP and \fBinit\fP 
 operations. Older GFS2 quota files may be migrated to this newer format using 
 the \fBgfs2_quota reset\fP command.
diff --git a/gfs2/man/mount.gfs2.8 b/gfs2/man/mount.gfs2.8
index 125e404..fcf99c4 100644
--- a/gfs2/man/mount.gfs2.8
+++ b/gfs2/man/mount.gfs2.8
@@ -41,9 +41,9 @@ interpreted by the mount command nor by the kernel's Virtual File System.  GFS2
 and non-GFS2 options may be intermingled after the \fB-o\fP, separated by
 commas (but no spaces).
 
-The options debug, acl, quota, suiddir, and data can be
+The options debug, commit, discard, acl, quota, suiddir, and data can be
 changed after mount using the "mount -o remount,option /mountpoint" command.
-The options debug, acl, and suiddir support the "no"
+The options debug, quota, discard, acl, and suiddir support the "no"
 prefix.  For example, "noacl" turns off what "acl" turns on.
 
 If you have trouble mounting GFS2, check the syslog (e.g. /var/log/messages)
@@ -149,6 +149,18 @@ the "account" state causes the per UID/GID usage statistics to be
 correctly maintained by the filesystem, limit and warn values are
 ignored.  The default value is "off".
 .TP
+\fBdiscard\fP
+Causes GFS2 to generate "discard" I/O requests for blocks which have
+been freed. These can be used by suitable hardware to implement
+thin-provisioning and similar schemes. This feature is supported
+in kernel version 2.6.30 and above.
+.TP
+\fBcommit=\fP\fIsecs\fR
+This is similar to the ext3 \fBcommit=\fP option in that it sets
+the maximum number of seconds between journal commits if there is
+dirty data in the journal. The default is 60 seconds. This option
+is only provided in kernel versions 2.6.31 and above.
+.TP
 \fBdata=\fP\fI[ordered/writeback]\fR
 When data=ordered is set, the user data modified by a transaction is
 flushed to the disk before the transaction is committed to disk.  This