mount: better describe UUIDs usage in man pages

Addresses: http://bugzilla.redhat.com/show_bug.cgi?id=632373
Signed-off-by: Karel Zak <kzak@redhat.com>

diff --git a/mount/fstab.5 b/mount/fstab.5
index c10490a42b62776a8e61673390c044e641f86e47..99557194e86c4b11d5499aa7f9102f21857e751e 100644 (file)
--- a/mount/fstab.5
+++ b/mount/fstab.5
@@ -87,6 +87,11 @@ writing LABEL=<label> or UUID=<uuid>,
 e.g., `LABEL=Boot' or `UUID=3e6be9de\%-8139\%-11d1\%-9106\%-a43f08d823a6'.
 This will make the system more robust: adding or removing a SCSI disk
 changes the disk device name but not the filesystem volume label.
+.LP
+Note that
+.BR mount (8)
+uses UUIDs as strings. The string representation of the UUID should be based on
+lower case characters.
 .RE
 
 .B The second field

diff --git a/mount/mount.8 b/mount/mount.8
index 0147e71db436e05b4176f060a7c932696829682b..79a55f24a91abff0413d05b41333ad1ea27c8356 100644 (file)
--- a/mount/mount.8
+++ b/mount/mount.8
@@ -136,9 +136,19 @@ or
 The recommended setup is to use LABEL=<label> or UUID=<uuid> tags rather than
 .B /dev/disk/by-{label,uuid}
 udev symlinks in the /etc/fstab file. The tags are
-more readable, robust and portable. The mount(8) command internally uses udev
+more readable, robust and portable. The
+.BR mount (8)
+command internally uses udev
 symlinks, so use the symlinks in /etc/fstab is not advantage over LABEL=/UUID=.
-For more details see libblkid(3).
+For more details see
+.BR libblkid (3).
+
+Note that
+.BR mount (8)
+uses UUIDs as strings. The UUIDs from command line or
+.BR fstab (5)
+are not converted to internal binary representation. The string representation
+of the UUID should be based on lower case characters.
 
 The
 .I proc