Add module descriptions.

138 files changed, 153 insertions, 0 deletions

diff --git a/modules/acl b/modules/acl
index d37a43d2f1..d3417caa71 100644
--- 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 6ab2a94bdb..0063654f57 100644
--- 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 0e749fac24..be1f4a7d0b 100644
--- 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 5b7ea40ec9..fc0b8d832e 100644
--- 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 5af6cad3f2..53de8b1387 100644
--- 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 7afe781efb..741aee5ba1 100644
--- 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 36d24b53bd..ff20deba94 100644
--- 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 2880e6bcb2..64710730bd 100644
--- 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 49e78c296e..50d06400dc 100644
--- 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 da6483b06c..0e43dde8da 100644
--- 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 d4aa62b562..c9cc4fd837 100644
--- 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 39dd6c3e5f..bb450978aa 100644
--- 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 910eba24b2..126b6537cb 100644
--- 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 7ad82ff9f9..9e8891ade3 100644
--- 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 b9210450ba..6812847138 100644
--- 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 f04e82048a..846e85b078 100644
--- 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 50da07d316..c5c13a0653 100644
--- 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 6bb129358e..68dc537867 100644
--- 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 4e974e9314..e85e98581a 100644
--- 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 e870871aa5..54e7f6af50 100644
--- 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 5726af1bbc..a97ed410cf 100644
--- 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 d1f61738a8..4628d3ad10 100644
--- 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 633b1b14e6..ff47477e85 100644
--- 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 212bbf2dc8..dc7f908b0c 100644
--- 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 3751a61f32..0479dc23b8 100644
--- 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 5db18425bb..153743272c 100644
--- 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 4599aa831b..050b7c1bcc 100644
--- 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 159b7e5d6b..09c2ae0c53 100644
--- 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 714017f3b6..6b47bbd7c0 100644
--- 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 357a8eb56d..6cc908f457 100644
--- 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 3afcf7d07b..33b9352757 100644
--- 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 3a28874ad3..77c96a7209 100644
--- 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 13e2f213e9..8d4972eddd 100644
--- 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 35a76d6685..3ebcc23197 100644
--- 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 7511bb114e..e642f92646 100644
--- 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 b4dbf3c45d..0a67da4c16 100644
--- 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 22d71db6d4..7d9b0989b7 100644
--- 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 7bd68dea30..a0072c8cdb 100644
--- 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 da7abf6725..891f8dbae5 100644
--- 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 315f789090..bd19c5ebeb 100644
--- 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 23403c294f..575e632001 100644
--- 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 f867387668..574966198e 100644
--- 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 efeac73068..5f0c9196c5 100644
--- 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 0337012542..67aebfea29 100644
--- 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 d6b5011cf7..96d3436dcb 100644
--- 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 467d0b4b20..a047e5fbf5 100644
--- 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 6c4fba44d2..3feaaee416 100644
--- 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 2376eb248b..a133637bc1 100644
--- 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 da354d9bb0..5578c0c4c2 100644
--- 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 6abfd85302..78361c6fd6 100644
--- 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 c761bee44f..fa34f88a18 100644
--- 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 d84d8b1079..bc2154fa17 100644
--- 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 9844700b83..654623153b 100644
--- 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 dfe2e60590..7456d70e48 100644
--- 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 f347d35112..a9ed9024c0 100644
--- 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 b971a399dd..444d67d69d 100644
--- 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 2fac7c3793..9ef350acfe 100644
--- 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 3747f03a38..1a894da425 100644
--- 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 824bd9027f..b1d496ccc4 100644
--- 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 f7cd340b45..664e404d52 100644
--- 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 ab7415f422..ac5dce12cc 100644
--- 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 7b3332bf17..15dbfcb725 100644
--- 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 03d99bb3ae..7b4c7245f7 100644
--- 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 68d0db6f00..0395d7ac24 100644
--- 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 27388ed0cc..58dc5e4820 100644
--- 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 105bcdf6e7..fddbb03824 100644
--- 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 d80282bbe9..db619b1e5c 100644
--- 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 e9bbec1cd7..8b350d607d 100644
--- 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 b7613b1be6..4800b6a04c 100644
--- 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 29d41b0941..8a46b76759 100644
--- 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 3959033daa..698925a563 100644
--- 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 94db966e2e..5829c752a0 100644
--- 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 ebf4e505e4..e1ae6cdd2c 100644
--- 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 7bfbb65066..c36d49ee09 100644
--- 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 e0fdd7c903..841827993d 100644
--- 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 8fd490f176..28c973e20d 100644
--- 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 8700b8eda5..8a25890a43 100644
--- 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 bc1120eb83..91de470b6d 100644
--- 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 d7f51352ee..ebd91565b9 100644
--- 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 4af52d3d99..42e602f937 100644
--- 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 72ffab6c4e..e37adc7e19 100644
--- 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 27f0a104cf..f5a0879de6 100644
--- 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 d9761bb603..74ff8c34b1 100644
--- 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 52cac85dff..49987e0660 100644
--- 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 a4023a8660..295b3695c2 100644
--- 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 11efb02748..59200eba92 100644
--- 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 2d0e838b06..56ce24d620 100644
--- 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 133fa75f72..b84305f73a 100644
--- 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 4ad44b0406..ac2de1193e 100644
--- 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 3959fc76ea..207b547f3c 100644
--- 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 bbb0fb2760..624ec1d79f 100644
--- 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 2007601bca..0e71158aff 100644
--- 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 e7600c2bf5..fad0239645 100644
--- 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 ab82cb9847..5629550968 100644
--- 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 0412259cce..03a0fd5fee 100644
--- 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 243382e6c7..e6a1506bc4 100644
--- 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 13fb62ae77..507ee21c9c 100644
--- 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 0c5f5ce968..447dbcf584 100644
--- 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 f4dc2e9704..8151b5f0fb 100644
--- 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 6815954eac..312361d52f 100644
--- 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 6157118b12..7cc2617921 100644
--- 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 c3f1d30fc7..08aa225156 100644
--- 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 c2202b1a60..da5a8e5d1e 100644
--- 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 b3504e386e..71ca62f991 100644
--- 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 84d832a8b2..4754cee1ec 100644
--- 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 97cf584b68..b6fdd642d7 100644
--- 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 bf751d8068..2c258637f4 100644
--- 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 23b6f1680f..e2b21f7a73 100644
--- 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 4984306d0b..1dadd5f0a8 100644
--- 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 93b4dd5d74..e11f5b3cef 100644
--- 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 69f2f6a559..e5f7339ba3 100644
--- 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 87e98bc87e..9c395808d4 100644
--- 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 493a9c2c4c..10f2fc8d7f 100644
--- 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 7367573879..4be1db628e 100644
--- 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 32c0451643..1c8341a8ba 100644
--- 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 4750b4af36..22638636f9 100644
--- 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 480a30a5cd..9cf6875546 100644
--- 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 b8cc33e205..287e73409c 100644
--- 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 fc1dd3218b..ea650b3ce0 100644
--- 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 9d61c7426f..d6aa725a72 100644
--- 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 937a7beffc..e778174bdd 100644
--- 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 64dfe8f26a..14bf0998a3 100644
--- 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 7b030ba6aa..aada360ca1 100644
--- 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 12ff22fa29..a3146bce42 100644
--- 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 2c493fc583..ac6f67286c 100644
--- 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 293ce20067..c76990e3cf 100644
--- 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 2efa079b56..db8a509b5d 100644
--- 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 593cf2ed93..3d7ea97413 100644
--- 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 41dd630fb2..58834d8954 100644
--- 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 7d067f4383..db08c871e5 100644
--- 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 cb6aab1397..0d9d2edf03 100644
--- 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 53d466000f..b351edfb61 100644
--- 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 3a88cfe297..1bde1afa53 100644
--- 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 4e2ca840ee..09d4d43ec4 100644
--- 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 08285ba227..57c5d6adc4 100644
--- 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 6e2ccd249e..7d3bceb3f4 100644
--- 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 a615aba486..67ef9cc3f1 100644
--- 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 3ef7b0c1f7..844d80bf57 100644
--- 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