docs: mark old losetup output format as DEPRECATED

Signed-off-by: Karel Zak <kzak@redhat.com>

diff --git a/Documentation/TODO b/Documentation/TODO
index 6b4f2ad562e69f93643eb124d260a6b6f475d25e..e9faa55063ef3771968a93f4f09de6707e3ae19e 100644 (file)
--- a/Documentation/TODO
+++ b/Documentation/TODO
@@ -12,12 +12,6 @@ lscpu
   - detect more hypervisors, see 'virt-what' shell script
     http://people.redhat.com/~rjones/virt-what/
 
-losetup
--------
-  - add new option --list and --output <columns> to print details about
-    one or all (-a) devices by lib/tt.c output. For example people hate
-    the hex devno in the default output.
-
 dmesg
 -----
 

diff --git a/Documentation/deprecated.txt b/Documentation/deprecated.txt
index 8797805b605bafdccd03a03e07c6372d5b6505d2..2d43cb0aef073c8364f22cbaabcf42ead5dfdf35 100644 (file)
--- a/Documentation/deprecated.txt
+++ b/Documentation/deprecated.txt
@@ -24,6 +24,24 @@ Why: the option -s is in collision with the Loop-AES losetup dialect that is use
 
 --------------------------
 
+What:   losetup output format without --list
+
+        deprecated format"
+
+          # losetup -a
+          /dev/loop0: []: (/home/fs-images/swap.img)
+          /dev/loop1: []: (/home/fs-images/disk.img), offset 100
+
+       new format:
+
+          # losetup
+          NAME       SIZELIMIT OFFSET AUTOCLEAR RO BACK-FILE
+          /dev/loop0         0      0         0  0 /home/fs-images/swap.img
+          /dev/loop1         0    100         0  0 /home/fs-images/disk.img
+
+--------------------------
+
+
 What:  elvtune
 Why:   useless for kernel >= 2.6.9
 

diff --git a/sys-utils/losetup.8 b/sys-utils/losetup.8
index 9613e46cec2777b301ec5c84a33ba84813a628d0..bbab44bc573b86dacd266c89efe7ec08c68a4d40 100644 (file)
--- a/sys-utils/losetup.8
+++ b/sys-utils/losetup.8
@@ -67,6 +67,8 @@ to detach loop devices and to query the status of a loop device. If only the
 \fIloopdev\fP argument is given, the status of the corresponding loop
 device is shown.
 
+Note that the old output format (e.g. losetup -a) with comma delimited strings is
+deprecated in favour of the --list output format (e.g. losetup -a -l).
 .SH OPTIONS
 +The \fIsize\fR and \fIoffset\fR arguments may be followed by the multiplicative
 +suffixes KiB=1024, MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB
@@ -75,7 +77,8 @@ device is shown.
 
 .IP "\fB\-a, \-\-all\fP"
 show status of all loop devices. Note that not all information are accessible
-for non-root users. See also \fB\-\-list\fP.
+for non-root users. See also \fB\-\-list\fP. The old output format (as printed
+without --list) is deprecated.
 .IP "\fB\-c, \-\-set-capacity\fP \fIloopdev\fP
 force loop driver to reread size of the file associated with the specified loop device
 .IP "\fB\-d, \-\-detach\fP \fIloopdev\fP..."