blkid.8.in: Fix description of the -l option to be more accurate

This patch fixes the blkid.8.in description of the "-l" option.  The man
page gives the impression that the first match is the one that is returned.
However, the blkid_find_dev_with_tag() function returns the device with
the highest priority (which is good, because that is what people really want).

Signed-off-by: Andreas Dilger <adilger@clusterfs.com>

diff --git a/lib/blkid/ChangeLog b/lib/blkid/ChangeLog
index 7b8d1ed..cf46f09 100644 (file)
--- a/lib/blkid/ChangeLog
+++ b/lib/blkid/ChangeLog
@@ -1,5 +1,7 @@
 2006-08-19  Andreas Dilger <adilger@clusterfs.com>
 
+       * blkid.8.in: Make the description of the -l option more accurate.
+
        * Makefile.in (clean): Avoid removing the tst_*.c files, but
                instead list each of the tst_* binaries explicitly.
 

diff --git a/misc/blkid.8.in b/misc/blkid.8.in
index 7050037..3257826 100644 (file)
--- a/misc/blkid.8.in
+++ b/misc/blkid.8.in
@@ -64,30 +64,16 @@ scanned but not necessarily available at this time), specify
 Display a usage message and exit.
 .TP
 .B \-l
-Look up the device that matches the search parameter specified using
+Look up one device that matches the search parameter specified using
 the 
 .B \-t
-option, assuming that there is only one matching the search parameter.  
-For a system with a large number of disks, this will be more 
-efficient by avoiding the need to revalidate devices unless absolutely 
-necessary.  If this option is not specified, 
+option.  If there are multiple devices that match the specified search
+parameter, then the device with the highest priority is returned, and/or
+the first device found at a given priority.  Device types in order of
+decreasing priority are Device Mapper, EVMS, LVM, MD, and finally regular
+block devices.  If this option is not specified, 
 .B blkid
-will use a less efficient approach, which allows 
-.B blkid
-to print all of the devices that match the search parameter.
-.IP
-This option is best used for tag searches such as 
-.I LABEL=data_vol
-or
-.IR UUID=e280469a-d06f-4c0b-b068-44f3b576029e .
-If you want 
-.B blkid
-to print all of the ext3 filesystems using a search parameter 
-such as
-.IR TYPE=ext3 ,
-then this option should 
-.I not
-be used.
+will print all of the devices that match the search parameter.
 .TP
 .B \-o 
 Display