[parted-devel] [PATCH] Document the lack of support for ext3 filesystems.

[Joel Andres Granados]

- doc/C/parted.8: Add a message in the KNOWN ISSUES section that
  describes the lack of support for ext3.  Take out some references
  that were contained in the man page.
- doc/parted.texi: Do the same as above to the info page.
---
 doc/C/parted.8  |   20 +++++++++++---------
 doc/parted.texi |   14 +++++++++++---
 2 files changed, 22 insertions(+), 12 deletions(-)

diff --git a/doc/C/parted.8 b/doc/C/parted.8
index fdf3d04..7427333 100644
--- a/doc/C/parted.8
+++ b/doc/C/parted.8
@@ -7,7 +7,7 @@ GNU Parted \- a partition manipulation program
 .SH DESCRIPTION
 .B parted
 is a disk partitioning and partition resizing program.  It allows you to
-create, destroy, resize, move and copy ext2, ext3, linux-swap, FAT, FAT32, and reiserfs
+create, destroy, resize, move and copy ext2, linux-swap, FAT, FAT32, and reiserfs
 partitions.  It can create, resize, and move Macintosh HFS partitions, as well as detect jfs,
 ntfs, ufs, and xfs partitions.  It is useful for creating space for new operating systems,
 reorganising disk usage, and copying data to new hard disks.
@@ -125,16 +125,18 @@ and a human-friendly form for output).
 Display version information and a copyright message.
 .RE
 .SH KNOWN ISSUES
-ext3 filesystem resizing does not currently work, please use
-.BR resize2fs (8)
-instead.
+ext3 filesystem functionality does not currently work.  To manage ext3
+type filesystems please use tools like resize2fs (8) or mke2fs (8).
+Please note that the currently supported ext2 filesystem will be
+deprecated once ext3 support is finalized.  Further note that ext3
+support will have limited functionality that is yet to be defined.
+Tools like resize2fs (8) and mke2fs (8) are suggested for managing
+these types of filesystems.
 
-Resizing partitions with an ext3 filesystem will not generally work because
-of the above issue.  Use
-.BR resize2fs (8)
-to resize the filesystem and resize the partition manually using
+To manually resize an ext3 filesystem and/or a partition use
+.BR resize2fs (8),
 .BR fdisk (8)
-or a similar tool.  For LVM situations, you will need to use the LVM commands
+or similar tools.  For LVM situations, you will need to use the LVM commands
 to resize the LVM elements.
 .SH REPORTING BUGS
 Report bugs to <bug-parted at gnu.org>
diff --git a/doc/parted.texi b/doc/parted.texi
index 53ac874..315b020 100644
--- a/doc/parted.texi
+++ b/doc/parted.texi
@@ -461,6 +461,14 @@ create a partition starting at 10.352Mb, not 10.4Mb)
 If the calculated values differ too much, Parted will ask you for
 confirmation.
 
+Currently ext3 filesystem functionality does not work. To manage ext3 type
+filesystems please use tools like resize2fs or mke2fs.  Please note that the
+currently supported ext2 filesystem will be deprecated once ext3 support is
+finalized.  Further note that ext3 support will have limited functionality
+that is yet to be defined.  Tools like resize2fs (8) and mke2fs (8) are
+suggested for managing these types of filesystems.
+
+
 @node Invoking Parted
 @section Command Line Options
 @cindex options at invocation
@@ -560,7 +568,7 @@ specifies which device the source partition is on.
 
 Supported file systems:
 @itemize @bullet
- at item ext2, ext3
+ at item ext2
 (provided the destination partition is larger than the source partition)
 
 @item fat16, fat32
@@ -756,7 +764,7 @@ Move never changes the partition number.
 
 Supported file systems:
 @itemize @bullet
- at item ext2, ext3
+ at item ext2
 (provided the destination partition is larger than the source partition)
 
 @item fat16, fat32
@@ -921,7 +929,7 @@ using Parted.
 
 Supported file systems:
 @itemize @bullet
- at item ext2, ext3 -- restriction: the new @var{start} must be the same as
+ at item ext2 -- restriction: the new @var{start} must be the same as
 the old @var{start}.
 @item fat16, fat32
 @item hfs, hfs+, hfsx -- restriction: the new @var{start} must be the same as
-- 
1.5.4.1