Update and clean up uuid man pages, including renaming libuuid.3 to
uuid.3
Eliminate empty lines at end of uuid.h
diff --git a/debian/uuid-dev.files b/debian/uuid-dev.files
index 4a8dcb7..3e29538 100644
--- a/debian/uuid-dev.files
+++ b/debian/uuid-dev.files
@@ -1,5 +1,4 @@
usr/lib/libuuid.so
usr/lib/libuuid.a
usr/include/uuid/*
-usr/share/man/man3/libuuid*
-usr/share/man/man3/uuid_*
+usr/share/man/man3/uuid*
diff --git a/e2fsprogs.spec.in b/e2fsprogs.spec.in
index b0fd0e2..23fa559 100644
--- a/e2fsprogs.spec.in
+++ b/e2fsprogs.spec.in
@@ -167,7 +167,7 @@
%{_mandir}/man1/mk_cmds.1*
%{_mandir}/man3/com_err.3*
%{_mandir}/man3/libblkid.3*
-%{_mandir}/man3/libuuid.3*
+%{_mandir}/man3/uuid.3*
%{_mandir}/man3/uuid_clear.3*
%{_mandir}/man3/uuid_compare.3*
%{_mandir}/man3/uuid_copy.3*
diff --git a/lib/uuid/ChangeLog b/lib/uuid/ChangeLog
index ba1e63c..2706bdc 100644
--- a/lib/uuid/ChangeLog
+++ b/lib/uuid/ChangeLog
@@ -1,5 +1,7 @@
2004-05-04 Theodore Ts'o <tytso@mit.edu>
+ * Update and clean up uuid man pages
+
* gen_uuid.c (uuid_generate_time): Mask off the timestamp to avoid
a Y8.8888K problem.
diff --git a/lib/uuid/Makefile.in b/lib/uuid/Makefile.in
index 3c68eb2..18b3866 100644
--- a/lib/uuid/Makefile.in
+++ b/lib/uuid/Makefile.in
@@ -12,7 +12,7 @@
all::
-SMANPAGES= libuuid.3 uuid_clear.3 uuid_compare.3 uuid_copy.3 \
+SMANPAGES= uuid.3 uuid_clear.3 uuid_compare.3 uuid_copy.3 \
uuid_generate.3 uuid_is_null.3 uuid_parse.3 \
uuid_time.3 uuid_unparse.3
@@ -93,8 +93,8 @@
$(CC) $(ALL_CFLAGS) -DDEBUG -o uuid_time $(srcdir)/uuid_time.c \
$(LIBUUID)
-libuuid.3: $(DEP_SUBSTITUTE) $(srcdir)/libuuid.3.in
- $(SUBSTITUTE_UPTIME) $(srcdir)/libuuid.3.in libuuid.3
+uuid.3: $(DEP_SUBSTITUTE) $(srcdir)/uuid.3.in
+ $(SUBSTITUTE_UPTIME) $(srcdir)/uuid.3.in uuid.3
uuid_clear.3: $(DEP_SUBSTITUTE) $(srcdir)/uuid_clear.3.in
$(SUBSTITUTE_UPTIME) $(srcdir)/uuid_clear.3.in uuid_clear.3
diff --git a/lib/uuid/libuuid.3.in b/lib/uuid/uuid.3.in
similarity index 81%
rename from lib/uuid/libuuid.3.in
rename to lib/uuid/uuid.3.in
index 1611bd6..18760fe 100644
--- a/lib/uuid/libuuid.3.in
+++ b/lib/uuid/uuid.3.in
@@ -29,21 +29,14 @@
.\" %End-Header%
.\"
.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger
-.TH LIBUUID 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
+.TH UUID 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
.SH NAME
-libuuid \- DCE compatible Universally Unique Identifier library
+uuid \- DCE compatible Universally Unique Identifier library
.SH SYNOPSIS
.B #include <uuid/uuid.h>
-.sp
-.B cc
-.I file.c
-.B \-luuid
.SH DESCRIPTION
-The
-.B libuuid
-library is used to generate unique identifiers for objects that may be
-accessible beyond the local system. The Linux implementation was created
-to uniquely identify ext2 filesystems created by a machine. This library
+The UUID library is used to generate unique identifiers for objects
+that may be accessible beyond the local system. This library
generates UUIDs compatible with those created by the Open Software
Foundation (OSF) Distributed Computing Environment (DCE) utility
.BR uuidgen .
@@ -56,15 +49,12 @@
.SH "CONFORMING TO"
OSF DCE 1.1
.SH AUTHOR
-.B libuuid
-was written by Theodore Y. Ts'o for the ext2 filesystem utilties.
+Theodore Y. Ts'o
.SH AVAILABILITY
-.B libuuid
-is part of the e2fsprogs package and is available from
+The UUID library is part of the e2fsprogs package and is available from
.UR http://e2fsprogs.sourceforge.net/
http://e2fsprogs.sourceforge.net/
.UE
-.UE
.SH "SEE ALSO"
.BR uuid_clear (3),
.BR uuid_compare (3),
diff --git a/lib/uuid/uuidP.h b/lib/uuid/uuidP.h
index d207d3a..4bf779d 100644
--- a/lib/uuid/uuidP.h
+++ b/lib/uuid/uuidP.h
@@ -61,7 +61,3 @@
*/
void uuid_pack(const struct uuid *uu, uuid_t ptr);
void uuid_unpack(const uuid_t in, struct uuid *uu);
-
-
-
-
diff --git a/lib/uuid/uuid_clear.3.in b/lib/uuid/uuid_clear.3.in
index 6e32ae3..92d2bf2 100644
--- a/lib/uuid/uuid_clear.3.in
+++ b/lib/uuid/uuid_clear.3.in
@@ -45,15 +45,16 @@
.I uu
to the NULL value.
.SH AUTHOR
-.B uuid_clear
-was written by Theodore Y. Ts'o for the ext2 filesystem utilties.
+Theodore Y. Ts'o
.SH AVAILABILITY
-.B uuid_clear
-is part of libuuid from the e2fsprogs package and is available from
-http://e2fsprogs.sourceforge.net.
+.UR http://e2fsprogs.sourceforge.net/
+http://e2fsprogs.sourceforge.net/
+.UE
.SH "SEE ALSO"
-.BR libuuid (3),
+.BR uuid (3),
.BR uuid_compare (3),
.BR uuid_copy (3),
.BR uuid_generate (3),
-.BR uuid_is_null (3)
+.BR uuid_is_null (3),
+.BR uuid_parse (3),
+.BR uuid_unparse (3)
diff --git a/lib/uuid/uuid_compare.3.in b/lib/uuid/uuid_compare.3.in
index 2317368..7f32963 100644
--- a/lib/uuid/uuid_compare.3.in
+++ b/lib/uuid/uuid_compare.3.in
@@ -51,15 +51,16 @@
greater than
.IR uu2 .
.SH AUTHOR
-.B uuid_compare
-was written by Theodore Y. Ts'o for the ext2 filesystem utilties.
+Theodore Y. Ts'o
.SH AVAILABILITY
-.B uuid_compare
-is part of libuuid from the e2fsprogs package and is available from
-http://e2fsprogs.sourceforge.net.
+.UR http://e2fsprogs.sourceforge.net/
+http://e2fsprogs.sourceforge.net/
+.UE
.SH "SEE ALSO"
-.BR libuuid (3),
+.BR uuid (3),
.BR uuid_clear (3),
.BR uuid_copy (3),
.BR uuid_generate (3),
-.BR uuid_is_null (3)
+.BR uuid_is_null (3),
+.BR uuid_parse (3),
+.BR uuid_unparse (3)
diff --git a/lib/uuid/uuid_copy.3.in b/lib/uuid/uuid_copy.3.in
index e4a5896..5f5e8c6 100644
--- a/lib/uuid/uuid_copy.3.in
+++ b/lib/uuid/uuid_copy.3.in
@@ -47,15 +47,16 @@
The copied UUID is returned in the location pointed to by
.IR dst .
.SH AUTHOR
-.B uuid_copy
-was written by Theodore Y. Ts'o for the ext2 filesystem utilties.
+Theodore Y. Ts'o
.SH AVAILABILITY
-.B uuid_copy
-is part of libuuid from the e2fsprogs package and is available from
-http://e2fsprogs.sourceforge.net.
+.UR http://e2fsprogs.sourceforge.net/
+http://e2fsprogs.sourceforge.net/
+.UE
.SH "SEE ALSO"
-.BR libuuid (3),
+.BR uuid (3),
.BR uuid_clear (3),
.BR uuid_compare (3),
.BR uuid_generate (3),
-.BR uuid_is_null (3)
+.BR uuid_is_null (3),
+.BR uuid_parse (3),
+.BR uuid_unparse (3)
diff --git a/lib/uuid/uuid_generate.3.in b/lib/uuid/uuid_generate.3.in
index 52acf72..998e042 100644
--- a/lib/uuid/uuid_generate.3.in
+++ b/lib/uuid/uuid_generate.3.in
@@ -87,18 +87,17 @@
.SH "CONFORMING TO"
OSF DCE 1.1
.SH AUTHOR
-.B uuid_generate
-was written by Theodore Y. Ts'o for the ext2 filesystem utilties.
+Theodore Y. Ts'o
.SH AVAILABILITY
-.B uuid_generate
-is part of libuuid from the e2fsprogs package and is available from
-http://e2fsprogs.sourceforge.net.
+.UR http://e2fsprogs.sourceforge.net/
+http://e2fsprogs.sourceforge.net/
+.UE
.SH "SEE ALSO"
-.BR libuuid (3),
+.BR uuid (3),
+.BR uuidgen (1),
.BR uuid_clear (3),
.BR uuid_compare (3),
.BR uuid_copy (3),
-.BR uuidgen (1),
.BR uuid_is_null (3),
.BR uuid_parse (3),
.BR uuid_time (3),
diff --git a/lib/uuid/uuid_is_null.3.in b/lib/uuid/uuid_is_null.3.in
index 59bb7af..e14288d 100644
--- a/lib/uuid/uuid_is_null.3.in
+++ b/lib/uuid/uuid_is_null.3.in
@@ -46,16 +46,17 @@
to the NULL value. If the value is equal to the NULL UUID, 1 is returned,
otherwise 0 is returned.
.SH AUTHOR
-.B uuid_is_null
-was written by Theodore Y. Ts'o for the ext2 filesystem utilties.
+Theodore Y. Ts'o
.SH AVAILABILITY
-.B uuid_is_null
-is part of libuuid from the e2fsprogs package and is available from
-http://e2fsprogs.sourceforge.net.
+.UR http://e2fsprogs.sourceforge.net/
+http://e2fsprogs.sourceforge.net/
+.UE
.SH "SEE ALSO"
-.BR libuuid (3),
+.BR uuid (3),
.BR uuid_clear (3),
.BR uuid_compare (3),
.BR uuid_copy (3),
.BR uuid_generate (3),
-.BR uuid_time (3)
+.BR uuid_time (3),
+.BR uuid_parse (3),
+.BR uuid_unparse (3)
diff --git a/lib/uuid/uuid_parse.3.in b/lib/uuid/uuid_parse.3.in
index a030397..f85acfa 100644
--- a/lib/uuid/uuid_parse.3.in
+++ b/lib/uuid/uuid_parse.3.in
@@ -55,14 +55,13 @@
.SH "CONFORMING TO"
OSF DCE 1.1
.SH AUTHOR
-.B uuid_parse
-was written by Theodore Y. Ts'o for the ext2 filesystem utilties.
+Theodore Y. Ts'o
.SH AVAILABILITY
-.B uuid_parse
-is part of libuuid from the e2fsprogs package and is available from
-http://e2fsprogs.sourceforge.net.
+.UR http://e2fsprogs.sourceforge.net/
+http://e2fsprogs.sourceforge.net/
+.UE
.SH "SEE ALSO"
-.BR libuuid (3),
+.BR uuid (3),
.BR uuid_clear (3),
.BR uuid_compare (3),
.BR uuid_copy (3),
diff --git a/lib/uuid/uuid_time.3.in b/lib/uuid/uuid_time.3.in
index d798e65..2a4c700 100644
--- a/lib/uuid/uuid_time.3.in
+++ b/lib/uuid/uuid_time.3.in
@@ -41,14 +41,13 @@
.SH DESCRIPTION
The
.B uuid_time
-function extracts the time at which the supplied UUID
+function extracts the time at which the supplied time-based UUID
.I uu
-was created. Note that the UUID creation time is encoded within the UUID,
-and this function can only reasonably expect to extract the creation time
-for UUIDs created with the
-.BR uuid_generate (3)
-function. It may or may not work with UUIDs created by OSF DCE
-.BR uuidgen .
+was created. Note that the UUID creation time is only encoded within
+certain types of UUIDs. This function can only reasonably expect to
+extract the creation time for UUIDs created with the
+.BR uuid_generate_time (3)
+function. It may or may not work with UUIDs created by other mechanisms.
.SH "RETURN VALUES"
The time at which the UUID was created, in seconds since January 1, 1970 GMT
(the epoch), is returned (see
@@ -59,14 +58,13 @@
(see
.BR gettimeofday "(2))."
.SH AUTHOR
-.B uuid_time
-was written by Theodore Y. Ts'o for the ext2 filesystem utilties.
+Theodore Y. Ts'o
.SH AVAILABILITY
-.B uuid_time
-is part of libuuid from the e2fsprogs package and is available from
-http://e2fsprogs.sourceforge.net.
+.UR http://e2fsprogs.sourceforge.net/
+http://e2fsprogs.sourceforge.net/
+.UE
.SH "SEE ALSO"
-.BR libuuid (3),
+.BR uuid (3),
.BR uuid_clear (3),
.BR uuid_compare (3),
.BR uuid_copy (3),
diff --git a/lib/uuid/uuid_unparse.3.in b/lib/uuid/uuid_unparse.3.in
index b5a5fcd..f299f43 100644
--- a/lib/uuid/uuid_unparse.3.in
+++ b/lib/uuid/uuid_unparse.3.in
@@ -60,16 +60,20 @@
and
.B uuid_unparse_lower
may be used.
+.SH "CONFORMING TO"
+OSF DCE 1.1
.SH AUTHOR
-.B uuid_unparse
-was written by Theodore Y. Ts'o for the ext2 filesystem utilties.
+Theodore Y. Ts'o
.SH AVAILABILITY
-.B uuid_unparse
-is part of libuuid from the e2fsprogs package and is available from
-http://e2fsprogs.sourceforge.net.
+.UR http://e2fsprogs.sourceforge.net/
+http://e2fsprogs.sourceforge.net/
+.UE
.SH "SEE ALSO"
-.BR libuuid (3),
+.BR uuid (3),
.BR uuid_clear (3),
+.BR uuid_compare (3),
+.BR uuid_copy (3),
.BR uuid_generate (3),
-.BR uuid_parse (3),
-.BR uuid_time (3)
+.BR uuid_time (3),
+.BR uuid_is_null (3),
+.BR uuid_parse (3)