Documentation: filesystems: update btrfs tools section

[Linux-MTD Mailing List]

Gitweb:     http://git.infradead.org/?p=mtd-2.6.git;a=commit;h=c75017961ba7df5da148b48a905c97181587d562
Commit:     c75017961ba7df5da148b48a905c97181587d562
Parent:     906c176e541f89ed3c04d0e9af1c7cf7b3cc1adb
Author:     David Sterba <dsterba at suse.cz>
AuthorDate: Wed Nov 20 15:06:08 2013 +0100
Committer:  Chris Mason <chris.mason at fusionio.com>
CommitDate: Thu Nov 21 11:51:50 2013 -0500

    Documentation: filesystems: update btrfs tools section
    
    The tools mentioned have been obsoleted long ago, replace
    with the current ones.
    
    CC: linux-doc at vger.kernel.org
    Signed-off-by: David Sterba <dsterba at suse.cz>
    Signed-off-by: Chris Mason <chris.mason at fusionio.com>
---
 Documentation/filesystems/btrfs.txt | 22 ++++++----------------
 1 file changed, 6 insertions(+), 16 deletions(-)

diff --git a/Documentation/filesystems/btrfs.txt b/Documentation/filesystems/btrfs.txt
index 4ced8be..5dd282d 100644
--- a/Documentation/filesystems/btrfs.txt
+++ b/Documentation/filesystems/btrfs.txt
@@ -244,24 +244,14 @@ available from the git repository at the following location:
 
 These include the following tools:
 
-mkfs.btrfs: create a filesystem
+* mkfs.btrfs: create a filesystem
 
-btrfsctl: control program to create snapshots and subvolumes:
+* btrfs: a single tool to manage the filesystems, refer to the manpage for more details
 
-	mount /dev/sda2 /mnt
-	btrfsctl -s new_subvol_name /mnt
-	btrfsctl -s snapshot_of_default /mnt/default
-	btrfsctl -s snapshot_of_new_subvol /mnt/new_subvol_name
-	btrfsctl -s snapshot_of_a_snapshot /mnt/snapshot_of_new_subvol
-	ls /mnt
-	default snapshot_of_a_snapshot snapshot_of_new_subvol
-	new_subvol_name snapshot_of_default
+* 'btrfsck' or 'btrfs check': do a consistency check of the filesystem
 
-	Snapshots and subvolumes cannot be deleted right now, but you can
-	rm -rf all the files and directories inside them.
+Other tools for specific tasks:
 
-btrfsck: do a limited check of the FS extent trees.
+* btrfs-convert: in-place conversion from ext2/3/4 filesystems
 
-btrfs-debug-tree: print all of the FS metadata in text form.  Example:
-
-	btrfs-debug-tree /dev/sda2 >& big_output_file
+* btrfs-image: dump filesystem metadata for debugging