Add module descriptions.

diff --git a/ChangeLog b/ChangeLog
index e8292c5..9eb871d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,12 @@
 2003-01-11  Bruno Haible  <bruno@clisp.org>
 
+       * modules/*: Add a description.
+       * modules/strpbrk: Fix Makefile.am snippet.
+       * modules/strtoimax: Fix dependencies.
+       * modules/strtoumax: Likewise.
+
+2003-01-11  Bruno Haible  <bruno@clisp.org>
+
        * gnulib-tool (func_create_testdir): Substitute lib_OBJECTS.
        * modules/alloca (Makefile.am): All object files depend on alloca.h.
        * modules/stdbool (Makefile.am): All object files depend on stdbool.h.

diff --git a/modules/acl b/modules/acl
index d37a43d..d3417ca 100644 (file)
--- a/modules/acl
+++ b/modules/acl
@@ -1,4 +1,5 @@
 Description:
+Access control lists of files.  (Unportable.)
 
 Files:
 lib/acl.h

diff --git a/modules/argmatch b/modules/argmatch
index 6ab2a94..0063654 100644 (file)
--- a/modules/argmatch
+++ b/modules/argmatch
@@ -1,4 +1,5 @@
 Description:
+Search for an exact or abbreviated match of a string in an array of strings.
 
 Files:
 lib/argmatch.h

diff --git a/modules/atexit b/modules/atexit
index 0e749fa..be1f4a7 100644 (file)
--- a/modules/atexit
+++ b/modules/atexit
@@ -1,4 +1,5 @@
 Description:
+atexit() function: register a function to be called at program termination.
 
 Files:
 lib/atexit.c

diff --git a/modules/backupfile b/modules/backupfile
index 5b7ea40..fc0b8d8 100644 (file)
--- a/modules/backupfile
+++ b/modules/backupfile
@@ -1,4 +1,6 @@
 Description:
+Determination of the filename of a backup file, according to user environment
+variables.
 
 Files:
 lib/backupfile.h

diff --git a/modules/bcopy b/modules/bcopy
index 5af6cad..53de8b1 100644 (file)
--- a/modules/bcopy
+++ b/modules/bcopy
@@ -1,4 +1,5 @@
 Description:
+Old BSD bcopy() function: copy memory area.
 
 Files:
 lib/bcopy.c

diff --git a/modules/bumpalloc b/modules/bumpalloc
index 7afe781..741aee5 100644 (file)
--- a/modules/bumpalloc
+++ b/modules/bumpalloc
@@ -1,4 +1,5 @@
 Description:
+Increase table allocation by one element.
 
 Files:
 lib/bumpalloc.h

diff --git a/modules/c-stack b/modules/c-stack
index 36d24b5..ff20deb 100644 (file)
--- a/modules/c-stack
+++ b/modules/c-stack
@@ -1,4 +1,5 @@
 Description:
+Stack overflow handling, causing program exit.
 
 Files:
 lib/c-stack.h

diff --git a/modules/canon-host b/modules/canon-host
index 2880e6b..6471073 100644 (file)
--- a/modules/canon-host
+++ b/modules/canon-host
@@ -1,4 +1,6 @@
 Description:
+Canonicalize a host name: return a name other hosts can understand, i.e.
+usually the host name including FQDN.
 
 Files:
 lib/canon-host.c

diff --git a/modules/chown b/modules/chown
index 49e78c2..50d0640 100644 (file)
--- a/modules/chown
+++ b/modules/chown
@@ -1,4 +1,5 @@
 Description:
+chown() function: change ownership of a file.
 
 Files:
 lib/chown.c

diff --git a/modules/closeout b/modules/closeout
index da6483b..0e43dde 100644 (file)
--- a/modules/closeout
+++ b/modules/closeout
@@ -1,4 +1,5 @@
 Description:
+Close stdout, checking for errors.
 
 Files:
 lib/closeout.h

diff --git a/modules/diacrit b/modules/diacrit
index d4aa62b..c9cc4fd 100644 (file)
--- a/modules/diacrit
+++ b/modules/diacrit
@@ -1,4 +1,5 @@
 Description:
+Decomposition of composed ISO-8859-1 characters.
 
 Files:
 lib/diacrit.h

diff --git a/modules/dirfd b/modules/dirfd
index 39dd6c3..bb45097 100644 (file)
--- a/modules/dirfd
+++ b/modules/dirfd
@@ -1,4 +1,5 @@
 Description:
+Retrieving the file descriptor of an open directory stream.  (Unportable.)
 
 Files:
 lib/dirfd.h

diff --git a/modules/dirname b/modules/dirname
index 910eba2..126b653 100644 (file)
--- a/modules/dirname
+++ b/modules/dirname
@@ -1,4 +1,5 @@
 Description:
+Extract specific portions of filenames.
 
 Files:
 lib/dirname.h

diff --git a/modules/dup2 b/modules/dup2
index 7ad82ff..9e8891a 100644 (file)
--- a/modules/dup2
+++ b/modules/dup2
@@ -1,4 +1,5 @@
 Description:
+dup2() function: duplicate an open file descriptor.
 
 Files:
 lib/dup2.c

diff --git a/modules/error b/modules/error
index b921045..6812847 100644 (file)
--- a/modules/error
+++ b/modules/error
@@ -1,4 +1,5 @@
 Description:
+error() and error_at_line() functions: Error reporting.
 
 Files:
 lib/error.h

diff --git a/modules/euidaccess b/modules/euidaccess
index f04e820..846e85b 100644 (file)
--- a/modules/euidaccess
+++ b/modules/euidaccess
@@ -1,4 +1,5 @@
 Description:
+euidaccess() function: check effective user's permissions for a file.
 
 Files:
 lib/euidaccess.c

diff --git a/modules/exclude b/modules/exclude
index 50da07d..c5c13a0 100644 (file)
--- a/modules/exclude
+++ b/modules/exclude
@@ -1,4 +1,5 @@
 Description:
+Manage list of filenames or wildcard patterns for --exclude option processing.
 
 Files:
 lib/exclude.h

diff --git a/modules/exitfail b/modules/exitfail
index 6bb1293..68dc537 100644 (file)
--- a/modules/exitfail
+++ b/modules/exitfail
@@ -1,4 +1,5 @@
 Description:
+Set exit status for fatal signal.
 
 Files:
 lib/exitfail.h

diff --git a/modules/fatal b/modules/fatal
index 4e974e9..e85e985 100644 (file)
--- a/modules/fatal
+++ b/modules/fatal
@@ -1,4 +1,5 @@
 Description:
+Error reporting for fatal errors.
 
 Files:
 lib/fatal.h

diff --git a/modules/file-type b/modules/file-type
index e870871..54e7f6a 100644 (file)
--- a/modules/file-type
+++ b/modules/file-type
@@ -1,4 +1,5 @@
 Description:
+Return a string describing the type of a file.
 
 Files:
 lib/file-type.h

diff --git a/modules/fileblocks b/modules/fileblocks
index 5726af1..a97ed41 100644 (file)
--- a/modules/fileblocks
+++ b/modules/fileblocks
@@ -1,4 +1,5 @@
 Description:
+Estimate number of blocks of a file, if 'struct stat' doesn't have st_blocks.
 
 Files:
 lib/fileblocks.c

diff --git a/modules/filemode b/modules/filemode
index d1f6173..4628d3a 100644 (file)
--- a/modules/filemode
+++ b/modules/filemode
@@ -1,4 +1,6 @@
 Description:
+Return a string (?rwxrwxrwx format) describing the type and permissions of a
+file.
 
 Files:
 lib/filemode.h

diff --git a/modules/fnmatch b/modules/fnmatch
index 633b1b1..ff47477 100644 (file)
--- a/modules/fnmatch
+++ b/modules/fnmatch
@@ -1,4 +1,5 @@
 Description:
+GNU fnmatch() implementation.
 
 Files:
 lib/fnmatch_.h

diff --git a/modules/fnmatch-gnu b/modules/fnmatch-gnu
index 212bbf2..dc7f908 100644 (file)
--- a/modules/fnmatch-gnu
+++ b/modules/fnmatch-gnu
@@ -1,4 +1,5 @@
 Description:
+fnmatch() function: wildcard matching, with GNU extensions.
 
 Files:
 

diff --git a/modules/fnmatch-posix b/modules/fnmatch-posix
index 3751a61..0479dc2 100644 (file)
--- a/modules/fnmatch-posix
+++ b/modules/fnmatch-posix
@@ -1,4 +1,5 @@
 Description:
+fnmatch() function: wildcard matching.
 
 Files:
 

diff --git a/modules/fpending b/modules/fpending
index 5db1842..1537432 100644 (file)
--- a/modules/fpending
+++ b/modules/fpending
@@ -1,4 +1,5 @@
 Description:
+Determine the number of bytes waiting in the output buffer of a stream.
 
 Files:
 lib/__fpending.h

diff --git a/modules/fsusage b/modules/fsusage
index 4599aa8..050b7c1 100644 (file)
--- a/modules/fsusage
+++ b/modules/fsusage
@@ -1,4 +1,5 @@
 Description:
+Return filesystem space usage info.
 
 Files:
 lib/fsusage.h

diff --git a/modules/ftruncate b/modules/ftruncate
index 159b7e5..09c2ae0 100644 (file)
--- a/modules/ftruncate
+++ b/modules/ftruncate
@@ -1,4 +1,5 @@
 Description:
+ftruncate() function: truncate an open file to a specified length.
 
 Files:
 lib/ftruncate.c

diff --git a/modules/full-read b/modules/full-read
index 714017f..6b47bbd 100644 (file)
--- a/modules/full-read
+++ b/modules/full-read
@@ -1,4 +1,5 @@
 Description:
+An interface to read() that reads all it is asked to read.
 
 Files:
 lib/full-read.h

diff --git a/modules/full-write b/modules/full-write
index 357a8eb..6cc908f 100644 (file)
--- a/modules/full-write
+++ b/modules/full-write
@@ -1,4 +1,5 @@
 Description:
+An interface to write() that writes all it is asked to write.
 
 Files:
 lib/full-write.h

diff --git a/modules/gcd b/modules/gcd
index 3afcf7d..33b9352 100644 (file)
--- a/modules/gcd
+++ b/modules/gcd
@@ -1,4 +1,5 @@
 Description:
+Greatest common divisor.
 
 Files:
 lib/gcd.h

diff --git a/modules/getdate b/modules/getdate
index 3a28874..77c96a7 100644 (file)
--- a/modules/getdate
+++ b/modules/getdate
@@ -1,4 +1,5 @@
 Description:
+Convert a date/time string to linear time.
 
 Files:
 lib/getdate.h

diff --git a/modules/getgroups b/modules/getgroups
index 13e2f21..8d4972e 100644 (file)
--- a/modules/getgroups
+++ b/modules/getgroups
@@ -1,4 +1,5 @@
 Description:
+getgroups() function: return the supplementary group IDs of the current process.
 
 Files:
 lib/getgroups.c

diff --git a/modules/gethostname b/modules/gethostname
index 35a76d6..3ebcc23 100644 (file)
--- a/modules/gethostname
+++ b/modules/gethostname
@@ -1,4 +1,5 @@
 Description:
+gethostname() function: Return machine's hostname.
 
 Files:
 lib/gethostname.c

diff --git a/modules/getline b/modules/getline
index 7511bb1..e642f92 100644 (file)
--- a/modules/getline
+++ b/modules/getline
@@ -1,4 +1,5 @@
 Description:
+Read a line from a stream.
 
 Files:
 lib/getline.h

diff --git a/modules/getloadavg b/modules/getloadavg
index b4dbf3c..0a67da4 100644 (file)
--- a/modules/getloadavg
+++ b/modules/getloadavg
@@ -1,4 +1,5 @@
 Description:
+Return the current system load averages.
 
 Files:
 lib/getloadavg.c

diff --git a/modules/getopt b/modules/getopt
index 22d71db..7d9b098 100644 (file)
--- a/modules/getopt
+++ b/modules/getopt
@@ -1,4 +1,5 @@
 Description:
+Process command line arguments.
 
 Files:
 lib/getopt.h

diff --git a/modules/getpagesize b/modules/getpagesize
index 7bd68de..a0072c8 100644 (file)
--- a/modules/getpagesize
+++ b/modules/getpagesize
@@ -1,4 +1,5 @@
 Description:
+getpagesize() function: Return memory page size.
 
 Files:
 lib/getpagesize.h

diff --git a/modules/getpass b/modules/getpass
index da7abf6..891f8db 100644 (file)
--- a/modules/getpass
+++ b/modules/getpass
@@ -1,4 +1,5 @@
 Description:
+getpass() function: read a password from /dev/tty.
 
 Files:
 lib/getpass.c

diff --git a/modules/gettext b/modules/gettext
index 315f789..bd19c5e 100644 (file)
--- a/modules/gettext
+++ b/modules/gettext
@@ -1,4 +1,5 @@
 Description:
+Translate messages to user's native language.
 
 Files:
 lib/gettext.h

diff --git a/modules/gettime b/modules/gettime
index 23403c2..575e632 100644 (file)
--- a/modules/gettime
+++ b/modules/gettime
@@ -1,4 +1,5 @@
 Description:
+Return current time, with nanosecond resolution.
 
 Files:
 lib/gettime.c

diff --git a/modules/gettimeofday b/modules/gettimeofday
index f867387..5749661 100644 (file)
--- a/modules/gettimeofday
+++ b/modules/gettimeofday
@@ -1,4 +1,5 @@
 Description:
+gettimeofday() function: return current time.
 
 Files:
 lib/gettimeofday.c

diff --git a/modules/getugroups b/modules/getugroups
index efeac73..5f0c919 100644 (file)
--- a/modules/getugroups
+++ b/modules/getugroups
@@ -1,4 +1,5 @@
 Description:
+Return the group IDs of a user.
 
 Files:
 lib/getugroups.c

diff --git a/modules/getusershell b/modules/getusershell
index 0337012..67aebfe 100644 (file)
--- a/modules/getusershell
+++ b/modules/getusershell
@@ -1,4 +1,5 @@
 Description:
+Return names of valid user shells.
 
 Files:
 lib/getusershell.c

diff --git a/modules/group-member b/modules/group-member
index d6b5011..96d3436 100644 (file)
--- a/modules/group-member
+++ b/modules/group-member
@@ -1,4 +1,5 @@
 Description:
+Determine whether the current process has the permissions of a given group ID.
 
 Files:
 lib/group-member.h

diff --git a/modules/hard-locale b/modules/hard-locale
index 467d0b4..a047e5f 100644 (file)
--- a/modules/hard-locale
+++ b/modules/hard-locale
@@ -1,4 +1,5 @@
 Description:
+Determine whether the current locale is different from the "C" locale.
 
 Files:
 lib/hard-locale.h

diff --git a/modules/hash b/modules/hash
index 6c4fba4..3feaaee 100644 (file)
--- a/modules/hash
+++ b/modules/hash
@@ -1,4 +1,5 @@
 Description:
+Parametrizable hash table.
 
 Files:
 lib/hash.h

diff --git a/modules/hash-pjw b/modules/hash-pjw
index 2376eb2..a133637 100644 (file)
--- a/modules/hash-pjw
+++ b/modules/hash-pjw
@@ -1,4 +1,5 @@
 Description:
+Compute a hash value for a NUL-terminated string.
 
 Files:
 lib/hash-pjw.h

diff --git a/modules/human b/modules/human
index da354d9..5578c0c 100644 (file)
--- a/modules/human
+++ b/modules/human
@@ -1,4 +1,6 @@
 Description:
+Convert a number (usually a file size) to a human readable string, possibly
+with K/M/G suffix.
 
 Files:
 lib/human.h

diff --git a/modules/iconv b/modules/iconv
index 6abfd85..78361c6 100644 (file)
--- a/modules/iconv
+++ b/modules/iconv
@@ -1,4 +1,5 @@
 Description:
+Character set conversion.
 
 Files:
 m4/iconv.m4

diff --git a/modules/idcache b/modules/idcache
index c761bee..fa34f88 100644 (file)
--- a/modules/idcache
+++ b/modules/idcache
@@ -1,4 +1,5 @@
 Description:
+Username <--> uid and groupname <--> gid conversions, with cache for speed.
 
 Files:
 lib/idcache.c

diff --git a/modules/isdir b/modules/isdir
index d84d8b1..bc2154f 100644 (file)
--- a/modules/isdir
+++ b/modules/isdir
@@ -1,4 +1,5 @@
 Description:
+Determine whether a directory exists.
 
 Files:
 lib/isdir.c

diff --git a/modules/lchown b/modules/lchown
index 9844700..6546231 100644 (file)
--- a/modules/lchown
+++ b/modules/lchown
@@ -1,4 +1,5 @@
 Description:
+lchown() function: change ownership of a file.
 
 Files:
 lib/lchown.h

diff --git a/modules/linebuffer b/modules/linebuffer
index dfe2e60..7456d70 100644 (file)
--- a/modules/linebuffer
+++ b/modules/linebuffer
@@ -1,4 +1,5 @@
 Description:
+Read a line from a stream.
 
 Files:
 lib/linebuffer.h

diff --git a/modules/localcharset b/modules/localcharset
index f347d35..a9ed902 100644 (file)
--- a/modules/localcharset
+++ b/modules/localcharset
@@ -1,4 +1,5 @@
 Description:
+Return current locale's character encoding.
 
 Files:
 lib/localcharset.h

diff --git a/modules/long-options b/modules/long-options
index b971a39..444d67d 100644 (file)
--- a/modules/long-options
+++ b/modules/long-options
@@ -1,4 +1,5 @@
 Description:
+Handle --help and --version options.
 
 Files:
 lib/long-options.h

diff --git a/modules/lstat b/modules/lstat
index 2fac7c3..9ef350a 100644 (file)
--- a/modules/lstat
+++ b/modules/lstat
@@ -1,4 +1,5 @@
 Description:
+stat() function: return information about a file or symbolic link.
 
 Files:
 lib/lstat.c

diff --git a/modules/makepath b/modules/makepath
index 3747f03..1a894da 100644 (file)
--- a/modules/makepath
+++ b/modules/makepath
@@ -1,4 +1,5 @@
 Description:
+Ensure that a directory path exists.
 
 Files:
 lib/makepath.h

diff --git a/modules/malloc b/modules/malloc
index 824bd90..b1d496c 100644 (file)
--- a/modules/malloc
+++ b/modules/malloc
@@ -1,4 +1,5 @@
 Description:
+malloc() function that is glibc compatible.
 
 Files:
 lib/malloc.c

diff --git a/modules/mbswidth b/modules/mbswidth
index f7cd340..664e404 100644 (file)
--- a/modules/mbswidth
+++ b/modules/mbswidth
@@ -1,4 +1,5 @@
 Description:
+Determine the number of screen columns needed for a string.
 
 Files:
 lib/mbswidth.h

diff --git a/modules/md5 b/modules/md5
index ab7415f..ac5dce1 100644 (file)
--- a/modules/md5
+++ b/modules/md5
@@ -1,4 +1,5 @@
 Description:
+Compute MD5 checksum.
 
 Files:
 lib/md5.h

diff --git a/modules/memcasecmp b/modules/memcasecmp
index 7b3332b..15dbfcb 100644 (file)
--- a/modules/memcasecmp
+++ b/modules/memcasecmp
@@ -1,4 +1,5 @@
 Description:
+Case-insensitive memory area comparison.
 
 Files:
 lib/memcasecmp.h

diff --git a/modules/memchr b/modules/memchr
index 03d99bb..7b4c724 100644 (file)
--- a/modules/memchr
+++ b/modules/memchr
@@ -1,4 +1,5 @@
 Description:
+memchr() function: scan memory for a byte.
 
 Files:
 lib/memchr.c

diff --git a/modules/memcmp b/modules/memcmp
index 68d0db6..0395d7a 100644 (file)
--- a/modules/memcmp
+++ b/modules/memcmp
@@ -1,4 +1,5 @@
 Description:
+memcmp() function: compare memory areas.
 
 Files:
 lib/memcmp.c

diff --git a/modules/memcoll b/modules/memcoll
index 27388ed..58dc5e4 100644 (file)
--- a/modules/memcoll
+++ b/modules/memcoll
@@ -1,4 +1,5 @@
 Description:
+Locale dependent memory area comparison.
 
 Files:
 lib/memcoll.h

diff --git a/modules/memcpy b/modules/memcpy
index 105bcdf..fddbb03 100644 (file)
--- a/modules/memcpy
+++ b/modules/memcpy
@@ -1,4 +1,5 @@
 Description:
+memcpy() function: copy memory area.
 
 Files:
 lib/memcpy.c

diff --git a/modules/memmove b/modules/memmove
index d80282b..db619b1 100644 (file)
--- a/modules/memmove
+++ b/modules/memmove
@@ -1,4 +1,5 @@
 Description:
+memmove() function: copy memory area.
 
 Files:
 lib/memmove.c

diff --git a/modules/memrchr b/modules/memrchr
index e9bbec1..8b350d6 100644 (file)
--- a/modules/memrchr
+++ b/modules/memrchr
@@ -1,4 +1,5 @@
 Description:
+memrchr() function: scan memory for a byte, from the right end.
 
 Files:
 lib/memrchr.c

diff --git a/modules/memset b/modules/memset
index b7613b1..4800b6a 100644 (file)
--- a/modules/memset
+++ b/modules/memset
@@ -1,4 +1,5 @@
 Description:
+memset() function: fill memory with a constant byte.
 
 Files:
 lib/memset.c

diff --git a/modules/mkdir b/modules/mkdir
index 29d41b0..8a46b76 100644 (file)
--- a/modules/mkdir
+++ b/modules/mkdir
@@ -1,4 +1,5 @@
 Description:
+mkdir() function: create a directory.
 
 Files:
 lib/mkdir.c

diff --git a/modules/mkstemp b/modules/mkstemp
index 3959033..698925a 100644 (file)
--- a/modules/mkstemp
+++ b/modules/mkstemp
@@ -1,4 +1,5 @@
 Description:
+mkstemp() function: create a private temporary file.
 
 Files:
 lib/mkstemp.c

diff --git a/modules/mktime b/modules/mktime
index 94db966..5829c75 100644 (file)
--- a/modules/mktime
+++ b/modules/mktime
@@ -1,4 +1,5 @@
 Description:
+mktime() function: convert broken-down time to linear time.
 
 Files:
 lib/mktime.c

diff --git a/modules/modechange b/modules/modechange
index ebf4e50..e1ae6cd 100644 (file)
--- a/modules/modechange
+++ b/modules/modechange
@@ -1,4 +1,6 @@
 Description:
+Manipulation of mode changes specified by strings (e.g. as first argument of
+chmod utility).
 
 Files:
 lib/modechange.h

diff --git a/modules/mountlist b/modules/mountlist
index 7bfbb65..c36d49e 100644 (file)
--- a/modules/mountlist
+++ b/modules/mountlist
@@ -1,4 +1,5 @@
 Description:
+Return list of mounted filesystems.
 
 Files:
 lib/mountlist.h

diff --git a/modules/nanosleep b/modules/nanosleep
index e0fdd7c..8418279 100644 (file)
--- a/modules/nanosleep
+++ b/modules/nanosleep
@@ -1,4 +1,5 @@
 Description:
+nanosleep() function: pause execution for a specified time.
 
 Files:
 lib/nanosleep.c

diff --git a/modules/obstack b/modules/obstack
index 8fd490f..28c973e 100644 (file)
--- a/modules/obstack
+++ b/modules/obstack
@@ -1,4 +1,5 @@
 Description:
+Memory allocation, optimized for stack-like allocation patterns.
 
 Files:
 lib/obstack.h

diff --git a/modules/path-concat b/modules/path-concat
index 8700b8e..8a25890 100644 (file)
--- a/modules/path-concat
+++ b/modules/path-concat
@@ -1,4 +1,6 @@
 Description:
+Construct a full pathname by concatenating a directory name and a relative
+filename.
 
 Files:
 lib/path-concat.h

diff --git a/modules/pathmax b/modules/pathmax
index bc1120e..91de470 100644 (file)
--- a/modules/pathmax
+++ b/modules/pathmax
@@ -1,4 +1,5 @@
 Description:
+Return maximum size of reasonable pathnames.  (Unportable: Hurd has no limit.)
 
 Files:
 lib/pathmax.h

diff --git a/modules/physmem b/modules/physmem
index d7f5135..ebd9156 100644 (file)
--- a/modules/physmem
+++ b/modules/physmem
@@ -1,4 +1,5 @@
 Description:
+Return amount of total/available physical memory.
 
 Files:
 lib/physmem.h

diff --git a/modules/posixtm b/modules/posixtm
index 4af52d3..42e602f 100644 (file)
--- a/modules/posixtm
+++ b/modules/posixtm
@@ -1,4 +1,5 @@
 Description:
+Convert a date/time string (POSIX syntax) to linear time or broken-down time.
 
 Files:
 lib/posixtm.h

diff --git a/modules/posixver b/modules/posixver
index 72ffab6..e37adc7 100644 (file)
--- a/modules/posixver
+++ b/modules/posixver
@@ -1,4 +1,6 @@
 Description:
+Determine desired POSIX specification version, according to user's environment
+variables.
 
 Files:
 lib/posixver.h

diff --git a/modules/putenv b/modules/putenv
index 27f0a10..f5a0879 100644 (file)
--- a/modules/putenv
+++ b/modules/putenv
@@ -1,4 +1,5 @@
 Description:
+putenv() function: change or add an environment variable.
 
 Files:
 lib/putenv.c

diff --git a/modules/quote b/modules/quote
index d9761bb..74ff8c3 100644 (file)
--- a/modules/quote
+++ b/modules/quote
@@ -1,4 +1,5 @@
 Description:
+Quote arguments for use in error messages.
 
 Files:
 lib/quote.h

diff --git a/modules/quotearg b/modules/quotearg
index 52cac85..49987e0 100644 (file)
--- a/modules/quotearg
+++ b/modules/quotearg
@@ -1,4 +1,5 @@
 Description:
+Quote arguments for use in error messages.
 
 Files:
 lib/quotearg.h

diff --git a/modules/readtokens b/modules/readtokens
index a4023a8..295b369 100644 (file)
--- a/modules/readtokens
+++ b/modules/readtokens
@@ -1,4 +1,5 @@
 Description:
+Read tokens from a stream.
 
 Files:
 lib/readtokens.h

diff --git a/modules/readutmp b/modules/readutmp
index 11efb02..59200eb 100644 (file)
--- a/modules/readutmp
+++ b/modules/readutmp
@@ -1,4 +1,5 @@
 Description:
+Read entire utmp file into memory.
 
 Files:
 lib/readutmp.h

diff --git a/modules/realloc b/modules/realloc
index 2d0e838..56ce24d 100644 (file)
--- a/modules/realloc
+++ b/modules/realloc
@@ -1,4 +1,5 @@
 Description:
+realloc() function that is glibc compatible.
 
 Files:
 lib/realloc.c

diff --git a/modules/regex b/modules/regex
index 133fa75..b84305f 100644 (file)
--- a/modules/regex
+++ b/modules/regex
@@ -1,4 +1,5 @@
 Description:
+Regular expression matching.
 
 Files:
 lib/regex.h

diff --git a/modules/rename b/modules/rename
index 4ad44b0..ac2de11 100644 (file)
--- a/modules/rename
+++ b/modules/rename
@@ -1,4 +1,5 @@
 Description:
+rename() function: change the name or location of a file.
 
 Files:
 lib/rename.c

diff --git a/modules/rmdir b/modules/rmdir
index 3959fc7..207b547 100644 (file)
--- a/modules/rmdir
+++ b/modules/rmdir
@@ -1,4 +1,5 @@
 Description:
+rmdir() function: delete a directory.
 
 Files:
 lib/rmdir.c

diff --git a/modules/rpmatch b/modules/rpmatch
index bbb0fb2..624ec1d 100644 (file)
--- a/modules/rpmatch
+++ b/modules/rpmatch
@@ -1,4 +1,5 @@
 Description:
+Locale dependent classification of a response as matching "yes" or "no".
 
 Files:
 lib/rpmatch.c

diff --git a/modules/safe-read b/modules/safe-read
index 2007601..0e71158 100644 (file)
--- a/modules/safe-read
+++ b/modules/safe-read
@@ -1,4 +1,5 @@
 Description:
+An interface to read() that retries after interrupts.
 
 Files:
 lib/safe-read.h

diff --git a/modules/safe-write b/modules/safe-write
index e7600c2..fad0239 100644 (file)
--- a/modules/safe-write
+++ b/modules/safe-write
@@ -1,4 +1,5 @@
 Description:
+An interface to write() that retries after interrupts.
 
 Files:
 lib/safe-write.h

diff --git a/modules/same b/modules/same
index ab82cb9..5629550 100644 (file)
--- a/modules/same
+++ b/modules/same
@@ -1,4 +1,6 @@
 Description:
+Determine whether two pathnames refer to the same directory entry of the same
+directory.
 
 Files:
 lib/same.h

diff --git a/modules/save-cwd b/modules/save-cwd
index 0412259..03a0fd5 100644 (file)
--- a/modules/save-cwd
+++ b/modules/save-cwd
@@ -1,4 +1,5 @@
 Description:
+Save and restore the current working directory.
 
 Files:
 lib/save-cwd.h

diff --git a/modules/savedir b/modules/savedir
index 243382e..e6a1506 100644 (file)
--- a/modules/savedir
+++ b/modules/savedir
@@ -1,4 +1,5 @@
 Description:
+Return the entries of a directory (just the names) as an argz string.
 
 Files:
 lib/savedir.h

diff --git a/modules/setenv b/modules/setenv
index 13fb62a..507ee21 100644 (file)
--- a/modules/setenv
+++ b/modules/setenv
@@ -1,4 +1,6 @@
 Description:
+setenv() function: set an environment variable.
+unsetenv() function: remove an environment variable.
 
 Files:
 lib/setenv.h

diff --git a/modules/settime b/modules/settime
index 0c5f5ce..447dbcf 100644 (file)
--- a/modules/settime
+++ b/modules/settime
@@ -1,4 +1,5 @@
 Description:
+Set the current time, with nanosecond resolution.
 
 Files:
 lib/settime.c

diff --git a/modules/sha b/modules/sha
index f4dc2e9..8151b5f 100644 (file)
--- a/modules/sha
+++ b/modules/sha
@@ -1,4 +1,5 @@
 Description:
+Compute SHA checksum.
 
 Files:
 lib/sha.h

diff --git a/modules/sig2str b/modules/sig2str
index 6815954..312361d 100644 (file)
--- a/modules/sig2str
+++ b/modules/sig2str
@@ -1,4 +1,5 @@
 Description:
+Convert between signal names and signal numbers.
 
 Files:
 lib/sig2str.h

diff --git a/modules/stat b/modules/stat
index 6157118..7cc2617 100644 (file)
--- a/modules/stat
+++ b/modules/stat
@@ -1,4 +1,5 @@
 Description:
+stat() function: return information about a file, following symbolic links.
 
 Files:
 lib/stat.c

diff --git a/modules/stdbool b/modules/stdbool
index c3f1d30..08aa225 100644 (file)
--- a/modules/stdbool
+++ b/modules/stdbool
@@ -1,4 +1,6 @@
 Description:
+An <stdbool.h> that nearly conforms to C99.
+(Nearly: casts to bool may not work.)
 
 Files:
 lib/stdbool.h.in

diff --git a/modules/stdio-safer b/modules/stdio-safer
index c2202b1..da5a8e5 100644 (file)
--- a/modules/stdio-safer
+++ b/modules/stdio-safer
@@ -1,4 +1,5 @@
 Description:
+File stream functions that avoid clobbering std{in,out,err}.
 
 Files:
 lib/stdio-safer.h

diff --git a/modules/stpcpy b/modules/stpcpy
index b3504e3..71ca62f 100644 (file)
--- a/modules/stpcpy
+++ b/modules/stpcpy
@@ -1,4 +1,5 @@
 Description:
+stpcpy() function: copy a string, returning a pointer to its end.
 
 Files:
 lib/stpcpy.h

diff --git a/modules/strcase b/modules/strcase
index 84d832a..4754cee 100644 (file)
--- a/modules/strcase
+++ b/modules/strcase
@@ -1,4 +1,5 @@
 Description:
+Case-insensitive string comparison functions.
 
 Files:
 lib/strcase.h

diff --git a/modules/strcspn b/modules/strcspn
index 97cf584..b6fdd64 100644 (file)
--- a/modules/strcspn
+++ b/modules/strcspn
@@ -1,4 +1,5 @@
 Description:
+strcspn() function: search a string for any of a set of characters.
 
 Files:
 lib/strcspn.c

diff --git a/modules/strdup b/modules/strdup
index bf751d8..2c25863 100644 (file)
--- a/modules/strdup
+++ b/modules/strdup
@@ -1,4 +1,5 @@
 Description:
+strdup() function: duplicate a string.
 
 Files:
 lib/strdup.c

diff --git a/modules/strerror b/modules/strerror
index 23b6f16..e2b21f7 100644 (file)
--- a/modules/strerror
+++ b/modules/strerror
@@ -1,4 +1,5 @@
 Description:
+strerror() function: return string describing error code.
 
 Files:
 lib/strerror.c

diff --git a/modules/strftime b/modules/strftime
index 4984306..1dadd5f 100644 (file)
--- a/modules/strftime
+++ b/modules/strftime
@@ -1,4 +1,5 @@
 Description:
+nstrftime() function: convert date and time to string, with GNU extensions.
 
 Files:
 lib/strftime.c

diff --git a/modules/strndup b/modules/strndup
index 93b4dd5..e11f5b3 100644 (file)
--- a/modules/strndup
+++ b/modules/strndup
@@ -1,4 +1,5 @@
 Description:
+strndup() function: duplicate a size-bounded string.
 
 Files:
 lib/strndup.c

diff --git a/modules/strnlen b/modules/strnlen
index 69f2f6a..e5f7339 100644 (file)
--- a/modules/strnlen
+++ b/modules/strnlen
@@ -1,4 +1,5 @@
 Description:
+strnlen() function: determine the length of a size-bounded string.
 
 Files:
 lib/strnlen.c

diff --git a/modules/strpbrk b/modules/strpbrk
index 87e98bc..9c39580 100644 (file)
--- a/modules/strpbrk
+++ b/modules/strpbrk
@@ -1,4 +1,5 @@
 Description:
+strpbrk() function: search a string for any of a set of characters.
 
 Files:
 lib/strpbrk.h
@@ -11,6 +12,7 @@ configure.ac:
 gl_FUNC_STRPBRK
 
 Makefile.am:
+lib_SOURCES += strpbrk.h
 
 Include:
 "strpbrk.h"

diff --git a/modules/strstr b/modules/strstr
index 493a9c2..10f2fc8 100644 (file)
--- a/modules/strstr
+++ b/modules/strstr
@@ -1,4 +1,5 @@
 Description:
+strstr() function: search for a substring in a string.
 
 Files:
 lib/strstr.h

diff --git a/modules/strtod b/modules/strtod
index 7367573..4be1db6 100644 (file)
--- a/modules/strtod
+++ b/modules/strtod
@@ -1,4 +1,5 @@
 Description:
+strtod() function: convert string to 'double'.
 
 Files:
 lib/strtod.c

diff --git a/modules/strtoimax b/modules/strtoimax
index 32c0451..1c8341a 100644 (file)
--- a/modules/strtoimax
+++ b/modules/strtoimax
@@ -1,4 +1,5 @@
 Description:
+strtoimax() function: convert string to 'intmax_t'.
 
 Files:
 lib/strtoimax.c
@@ -9,6 +10,7 @@ m4/intmax_t.m4
 m4/strtoimax.m4
 
 Depends-on:
+strtoll
 
 configure.ac:
 gl_FUNC_STRTOIMAX

diff --git a/modules/strtol b/modules/strtol
index 4750b4a..2263863 100644 (file)
--- a/modules/strtol
+++ b/modules/strtol
@@ -1,4 +1,5 @@
 Description:
+strtol() function: convert string to 'long'.
 
 Files:
 lib/strtol.c

diff --git a/modules/strtoll b/modules/strtoll
index 480a30a..9cf6875 100644 (file)
--- a/modules/strtoll
+++ b/modules/strtoll
@@ -1,4 +1,5 @@
 Description:
+strtoll() function: convert string to 'long long'.
 
 Files:
 lib/strtoll.c

diff --git a/modules/strtoul b/modules/strtoul
index b8cc33e..287e734 100644 (file)
--- a/modules/strtoul
+++ b/modules/strtoul
@@ -1,4 +1,5 @@
 Description:
+strtoul() function: convert string to 'unsigned long'.
 
 Files:
 lib/strtoul.c

diff --git a/modules/strtoull b/modules/strtoull
index fc1dd32..ea650b3 100644 (file)
--- a/modules/strtoull
+++ b/modules/strtoull
@@ -1,4 +1,5 @@
 Description:
+strtoull() function: convert string to 'unsigned long long'.
 
 Files:
 lib/strtoull.c

diff --git a/modules/strtoumax b/modules/strtoumax
index 9d61c74..d6aa725 100644 (file)
--- a/modules/strtoumax
+++ b/modules/strtoumax
@@ -1,4 +1,5 @@
 Description:
+strtoumax() function: convert string to 'uintmax_t'.
 
 Files:
 lib/strtoumax.c
@@ -10,6 +11,7 @@ m4/strtoumax.m4
 
 Depends-on:
 strtoimax
+strtoull
 
 configure.ac:
 gl_FUNC_STRTOUMAX

diff --git a/modules/strverscmp b/modules/strverscmp
index 937a7be..e778174 100644 (file)
--- a/modules/strverscmp
+++ b/modules/strverscmp
@@ -1,4 +1,5 @@
 Description:
+Compare strings holding version numbers.
 
 Files:
 lib/strverscmp.h

diff --git a/modules/timespec b/modules/timespec
index 64dfe8f..14bf099 100644 (file)
--- a/modules/timespec
+++ b/modules/timespec
@@ -1,4 +1,5 @@
 Description:
+struct timespec.
 
 Files:
 lib/timespec.h

diff --git a/modules/unicodeio b/modules/unicodeio
index 7b030ba..aada360 100644 (file)
--- a/modules/unicodeio
+++ b/modules/unicodeio
@@ -1,4 +1,5 @@
 Description:
+Unicode character output to streams with locale dependent encoding.
 
 Files:
 lib/unicodeio.h

diff --git a/modules/unistd-safer b/modules/unistd-safer
index 12ff22f..a3146bc 100644 (file)
--- a/modules/unistd-safer
+++ b/modules/unistd-safer
@@ -1,4 +1,5 @@
 Description:
+File descriptor functions that avoid clobbering STD{IN,OUT,ERR}_FILENO.
 
 Files:
 lib/unistd-safer.h

diff --git a/modules/unlocked-io b/modules/unlocked-io
index 2c493fc..ac6f672 100644 (file)
--- a/modules/unlocked-io
+++ b/modules/unlocked-io
@@ -1,4 +1,5 @@
 Description:
+Enable faster, non-thread-safe stdio functions if available.
 
 Files:
 lib/unlocked-io.h

diff --git a/modules/userspec b/modules/userspec
index 293ce20..c76990e 100644 (file)
--- a/modules/userspec
+++ b/modules/userspec
@@ -1,4 +1,6 @@
 Description:
+Parse a specifying a user and/or group (e.g. as first argument of chown
+utility).
 
 Files:
 lib/userspec.c

diff --git a/modules/utime b/modules/utime
index 2efa079..db8a509 100644 (file)
--- a/modules/utime
+++ b/modules/utime
@@ -1,4 +1,5 @@
 Description:
+utime() function: change access and/or modification times of a file.
 
 Files:
 lib/utime.c

diff --git a/modules/version-etc b/modules/version-etc
index 593cf2e..3d7ea97 100644 (file)
--- a/modules/version-etc
+++ b/modules/version-etc
@@ -1,4 +1,5 @@
 Description:
+Print --version output.
 
 Files:
 lib/version-etc.h

diff --git a/modules/xalloc b/modules/xalloc
index 41dd630..58834d8 100644 (file)
--- a/modules/xalloc
+++ b/modules/xalloc
@@ -1,4 +1,5 @@
 Description:
+Memory allocation with out-of-memory checking.
 
 Files:
 lib/xalloc.h

diff --git a/modules/xgetcwd b/modules/xgetcwd
index 7d067f4..db08c87 100644 (file)
--- a/modules/xgetcwd
+++ b/modules/xgetcwd
@@ -1,4 +1,5 @@
 Description:
+Return the current working directory, without size limitations.
 
 Files:
 lib/xgetcwd.h

diff --git a/modules/xgethostname b/modules/xgethostname
index cb6aab1..0d9d2ed 100644 (file)
--- a/modules/xgethostname
+++ b/modules/xgethostname
@@ -1,4 +1,5 @@
 Description:
+Return machine's hostname, without size limitations.
 
 Files:
 lib/xgethostname.c

diff --git a/modules/xmemcoll b/modules/xmemcoll
index 53d4660..b351edf 100644 (file)
--- a/modules/xmemcoll
+++ b/modules/xmemcoll
@@ -1,4 +1,5 @@
 Description:
+Locale dependent memory area comparison, with error checking.
 
 Files:
 lib/xmemcoll.h

diff --git a/modules/xreadlink b/modules/xreadlink
index 3a88cfe..1bde1af 100644 (file)
--- a/modules/xreadlink
+++ b/modules/xreadlink
@@ -1,4 +1,5 @@
 Description:
+Return the contents of a symbolic link, without size limitations.
 
 Files:
 lib/xreadlink.h

diff --git a/modules/xstrtod b/modules/xstrtod
index 4e2ca84..09d4d43 100644 (file)
--- a/modules/xstrtod
+++ b/modules/xstrtod
@@ -1,4 +1,5 @@
 Description:
+Convert string to 'double', with error checking.
 
 Files:
 lib/xstrtod.h

diff --git a/modules/xstrtoimax b/modules/xstrtoimax
index 08285ba..57c5d6a 100644 (file)
--- a/modules/xstrtoimax
+++ b/modules/xstrtoimax
@@ -1,4 +1,5 @@
 Description:
+Convert string to 'intmax_t', with error checking.
 
 Files:
 

diff --git a/modules/xstrtol b/modules/xstrtol
index 6e2ccd2..7d3bceb 100644 (file)
--- a/modules/xstrtol
+++ b/modules/xstrtol
@@ -1,4 +1,5 @@
 Description:
+Convert string to 'long` or 'unsigned long', with error checking.
 
 Files:
 lib/xstrtol.h

diff --git a/modules/xstrtoumax b/modules/xstrtoumax
index a615aba..67ef9cc 100644 (file)
--- a/modules/xstrtoumax
+++ b/modules/xstrtoumax
@@ -1,4 +1,5 @@
 Description:
+Convert string to 'uintmax_t', with error checking.
 
 Files:
 lib/xstrtoumax.c

diff --git a/modules/yesno b/modules/yesno
index 3ef7b0c..844d80b 100644 (file)
--- a/modules/yesno
+++ b/modules/yesno
@@ -1,4 +1,6 @@
 Description:
+Read a response from the user, and its classification as matching "yes" or
+"no".
 
 Files:
 lib/yesno.c