From 7248348ed7b68e68048c3075629691745e361cad Mon Sep 17 00:00:00 2001
From: "Richard W.M. Jones" <rjones@redhat.com>
Date: Thu, 29 Aug 2013 13:59:14 +0100
Subject: [PATCH] mke2fs: Document that too small blockscount will result in
 ext2 filesystem (RHBZ#1002032).

(cherry picked from commit 1c8986e45c3f1a7e2391bde2848667332495e3aa)
---
 generator/actions.ml | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/generator/actions.ml b/generator/actions.ml
index d679f1a..435411b 100644
--- a/generator/actions.ml
+++ b/generator/actions.ml
@@ -10748,11 +10748,15 @@ or C<guestfs_rm_rf> to remove directories recursively." };
             ["cat"; "/new"]], "new file contents"), []
        ]);
     shortdesc = "create an ext2/ext3/ext4 filesystem on device";
+    (* XXX document optional args properly *)
     longdesc = "\
 C<mke2fs> is used to create an ext2, ext3, or ext4 filesystem
-on C<device>.  The optional C<blockscount> is the size of the
-filesystem in blocks.  If omitted it defaults to the size of
-C<device>." (* XXX document optional args properly *) };
+on C<device>.
+
+The optional C<blockscount> is the size of the filesystem in blocks.
+If omitted it defaults to the size of C<device>.  Note if the
+filesystem is too small to contain a journal, C<mke2fs> will
+silently create an ext2 filesystem instead." };
 
   { defaults with
     name = "list_disk_labels";
-- 
1.8.3.1