changeset 4172:5321105558d8

Add module descriptions.
author Bruno Haible <bruno@clisp.org>
date Mon, 13 Jan 2003 16:07:17 +0000
parents c2c0e7e2e7bd
children 90329592e4b4
files ChangeLog modules/acl modules/argmatch modules/atexit modules/backupfile modules/bcopy modules/bumpalloc modules/c-stack modules/canon-host modules/chown modules/closeout modules/diacrit modules/dirfd modules/dirname modules/dup2 modules/error modules/euidaccess modules/exclude modules/exitfail modules/fatal modules/file-type modules/fileblocks modules/filemode modules/fnmatch modules/fnmatch-gnu modules/fnmatch-posix modules/fpending modules/fsusage modules/ftruncate modules/full-read modules/full-write modules/gcd modules/getdate modules/getgroups modules/gethostname modules/getline modules/getloadavg modules/getopt modules/getpagesize modules/getpass modules/gettext modules/gettime modules/gettimeofday modules/getugroups modules/getusershell modules/group-member modules/hard-locale modules/hash modules/hash-pjw modules/human modules/iconv modules/idcache modules/isdir modules/lchown modules/linebuffer modules/localcharset modules/long-options modules/lstat modules/makepath modules/malloc modules/mbswidth modules/md5 modules/memcasecmp modules/memchr modules/memcmp modules/memcoll modules/memcpy modules/memmove modules/memrchr modules/memset modules/mkdir modules/mkstemp modules/mktime modules/modechange modules/mountlist modules/nanosleep modules/obstack modules/path-concat modules/pathmax modules/physmem modules/posixtm modules/posixver modules/putenv modules/quote modules/quotearg modules/readtokens modules/readutmp modules/realloc modules/regex modules/rename modules/rmdir modules/rpmatch modules/safe-read modules/safe-write modules/same modules/save-cwd modules/savedir modules/setenv modules/settime modules/sha modules/sig2str modules/stat modules/stdbool modules/stdio-safer modules/stpcpy modules/strcase modules/strcspn modules/strdup modules/strerror modules/strftime modules/strndup modules/strnlen modules/strpbrk modules/strstr modules/strtod modules/strtoimax modules/strtol modules/strtoll modules/strtoul modules/strtoull modules/strtoumax modules/strverscmp modules/timespec modules/unicodeio modules/unistd-safer modules/unlocked-io modules/userspec modules/utime modules/version-etc modules/xalloc modules/xgetcwd modules/xgethostname modules/xmemcoll modules/xreadlink modules/xstrtod modules/xstrtoimax modules/xstrtol modules/xstrtoumax modules/yesno
diffstat 139 files changed, 160 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+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.
--- a/modules/acl
+++ b/modules/acl
@@ -1,4 +1,5 @@
 Description:
+Access control lists of files.  (Unportable.)
 
 Files:
 lib/acl.h
--- 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
--- 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
--- 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
--- a/modules/bcopy
+++ b/modules/bcopy
@@ -1,4 +1,5 @@
 Description:
+Old BSD bcopy() function: copy memory area.
 
 Files:
 lib/bcopy.c
--- a/modules/bumpalloc
+++ b/modules/bumpalloc
@@ -1,4 +1,5 @@
 Description:
+Increase table allocation by one element.
 
 Files:
 lib/bumpalloc.h
--- a/modules/c-stack
+++ b/modules/c-stack
@@ -1,4 +1,5 @@
 Description:
+Stack overflow handling, causing program exit.
 
 Files:
 lib/c-stack.h
--- 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
--- a/modules/chown
+++ b/modules/chown
@@ -1,4 +1,5 @@
 Description:
+chown() function: change ownership of a file.
 
 Files:
 lib/chown.c
--- a/modules/closeout
+++ b/modules/closeout
@@ -1,4 +1,5 @@
 Description:
+Close stdout, checking for errors.
 
 Files:
 lib/closeout.h
--- a/modules/diacrit
+++ b/modules/diacrit
@@ -1,4 +1,5 @@
 Description:
+Decomposition of composed ISO-8859-1 characters.
 
 Files:
 lib/diacrit.h
--- 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
--- a/modules/dirname
+++ b/modules/dirname
@@ -1,4 +1,5 @@
 Description:
+Extract specific portions of filenames.
 
 Files:
 lib/dirname.h
--- a/modules/dup2
+++ b/modules/dup2
@@ -1,4 +1,5 @@
 Description:
+dup2() function: duplicate an open file descriptor.
 
 Files:
 lib/dup2.c
--- a/modules/error
+++ b/modules/error
@@ -1,4 +1,5 @@
 Description:
+error() and error_at_line() functions: Error reporting.
 
 Files:
 lib/error.h
--- 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
--- 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
--- a/modules/exitfail
+++ b/modules/exitfail
@@ -1,4 +1,5 @@
 Description:
+Set exit status for fatal signal.
 
 Files:
 lib/exitfail.h
--- a/modules/fatal
+++ b/modules/fatal
@@ -1,4 +1,5 @@
 Description:
+Error reporting for fatal errors.
 
 Files:
 lib/fatal.h
--- 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
--- 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
--- 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
--- a/modules/fnmatch
+++ b/modules/fnmatch
@@ -1,4 +1,5 @@
 Description:
+GNU fnmatch() implementation.
 
 Files:
 lib/fnmatch_.h
--- a/modules/fnmatch-gnu
+++ b/modules/fnmatch-gnu
@@ -1,4 +1,5 @@
 Description:
+fnmatch() function: wildcard matching, with GNU extensions.
 
 Files:
 
--- a/modules/fnmatch-posix
+++ b/modules/fnmatch-posix
@@ -1,4 +1,5 @@
 Description:
+fnmatch() function: wildcard matching.
 
 Files:
 
--- 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
--- a/modules/fsusage
+++ b/modules/fsusage
@@ -1,4 +1,5 @@
 Description:
+Return filesystem space usage info.
 
 Files:
 lib/fsusage.h
--- 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
--- 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
--- 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
--- a/modules/gcd
+++ b/modules/gcd
@@ -1,4 +1,5 @@
 Description:
+Greatest common divisor.
 
 Files:
 lib/gcd.h
--- a/modules/getdate
+++ b/modules/getdate
@@ -1,4 +1,5 @@
 Description:
+Convert a date/time string to linear time.
 
 Files:
 lib/getdate.h
--- 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
--- a/modules/gethostname
+++ b/modules/gethostname
@@ -1,4 +1,5 @@
 Description:
+gethostname() function: Return machine's hostname.
 
 Files:
 lib/gethostname.c
--- a/modules/getline
+++ b/modules/getline
@@ -1,4 +1,5 @@
 Description:
+Read a line from a stream.
 
 Files:
 lib/getline.h
--- a/modules/getloadavg
+++ b/modules/getloadavg
@@ -1,4 +1,5 @@
 Description:
+Return the current system load averages.
 
 Files:
 lib/getloadavg.c
--- a/modules/getopt
+++ b/modules/getopt
@@ -1,4 +1,5 @@
 Description:
+Process command line arguments.
 
 Files:
 lib/getopt.h
--- a/modules/getpagesize
+++ b/modules/getpagesize
@@ -1,4 +1,5 @@
 Description:
+getpagesize() function: Return memory page size.
 
 Files:
 lib/getpagesize.h
--- a/modules/getpass
+++ b/modules/getpass
@@ -1,4 +1,5 @@
 Description:
+getpass() function: read a password from /dev/tty.
 
 Files:
 lib/getpass.c
--- a/modules/gettext
+++ b/modules/gettext
@@ -1,4 +1,5 @@
 Description:
+Translate messages to user's native language.
 
 Files:
 lib/gettext.h
--- a/modules/gettime
+++ b/modules/gettime
@@ -1,4 +1,5 @@
 Description:
+Return current time, with nanosecond resolution.
 
 Files:
 lib/gettime.c
--- a/modules/gettimeofday
+++ b/modules/gettimeofday
@@ -1,4 +1,5 @@
 Description:
+gettimeofday() function: return current time.
 
 Files:
 lib/gettimeofday.c
--- a/modules/getugroups
+++ b/modules/getugroups
@@ -1,4 +1,5 @@
 Description:
+Return the group IDs of a user.
 
 Files:
 lib/getugroups.c
--- a/modules/getusershell
+++ b/modules/getusershell
@@ -1,4 +1,5 @@
 Description:
+Return names of valid user shells.
 
 Files:
 lib/getusershell.c
--- 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
--- 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
--- a/modules/hash
+++ b/modules/hash
@@ -1,4 +1,5 @@
 Description:
+Parametrizable hash table.
 
 Files:
 lib/hash.h
--- 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
--- 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
--- a/modules/iconv
+++ b/modules/iconv
@@ -1,4 +1,5 @@
 Description:
+Character set conversion.
 
 Files:
 m4/iconv.m4
--- 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
--- a/modules/isdir
+++ b/modules/isdir
@@ -1,4 +1,5 @@
 Description:
+Determine whether a directory exists.
 
 Files:
 lib/isdir.c
--- a/modules/lchown
+++ b/modules/lchown
@@ -1,4 +1,5 @@
 Description:
+lchown() function: change ownership of a file.
 
 Files:
 lib/lchown.h
--- a/modules/linebuffer
+++ b/modules/linebuffer
@@ -1,4 +1,5 @@
 Description:
+Read a line from a stream.
 
 Files:
 lib/linebuffer.h
--- a/modules/localcharset
+++ b/modules/localcharset
@@ -1,4 +1,5 @@
 Description:
+Return current locale's character encoding.
 
 Files:
 lib/localcharset.h
--- a/modules/long-options
+++ b/modules/long-options
@@ -1,4 +1,5 @@
 Description:
+Handle --help and --version options.
 
 Files:
 lib/long-options.h
--- 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
--- a/modules/makepath
+++ b/modules/makepath
@@ -1,4 +1,5 @@
 Description:
+Ensure that a directory path exists.
 
 Files:
 lib/makepath.h
--- a/modules/malloc
+++ b/modules/malloc
@@ -1,4 +1,5 @@
 Description:
+malloc() function that is glibc compatible.
 
 Files:
 lib/malloc.c
--- 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
--- a/modules/md5
+++ b/modules/md5
@@ -1,4 +1,5 @@
 Description:
+Compute MD5 checksum.
 
 Files:
 lib/md5.h
--- a/modules/memcasecmp
+++ b/modules/memcasecmp
@@ -1,4 +1,5 @@
 Description:
+Case-insensitive memory area comparison.
 
 Files:
 lib/memcasecmp.h
--- a/modules/memchr
+++ b/modules/memchr
@@ -1,4 +1,5 @@
 Description:
+memchr() function: scan memory for a byte.
 
 Files:
 lib/memchr.c
--- a/modules/memcmp
+++ b/modules/memcmp
@@ -1,4 +1,5 @@
 Description:
+memcmp() function: compare memory areas.
 
 Files:
 lib/memcmp.c
--- a/modules/memcoll
+++ b/modules/memcoll
@@ -1,4 +1,5 @@
 Description:
+Locale dependent memory area comparison.
 
 Files:
 lib/memcoll.h
--- a/modules/memcpy
+++ b/modules/memcpy
@@ -1,4 +1,5 @@
 Description:
+memcpy() function: copy memory area.
 
 Files:
 lib/memcpy.c
--- a/modules/memmove
+++ b/modules/memmove
@@ -1,4 +1,5 @@
 Description:
+memmove() function: copy memory area.
 
 Files:
 lib/memmove.c
--- 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
--- a/modules/memset
+++ b/modules/memset
@@ -1,4 +1,5 @@
 Description:
+memset() function: fill memory with a constant byte.
 
 Files:
 lib/memset.c
--- a/modules/mkdir
+++ b/modules/mkdir
@@ -1,4 +1,5 @@
 Description:
+mkdir() function: create a directory.
 
 Files:
 lib/mkdir.c
--- a/modules/mkstemp
+++ b/modules/mkstemp
@@ -1,4 +1,5 @@
 Description:
+mkstemp() function: create a private temporary file.
 
 Files:
 lib/mkstemp.c
--- a/modules/mktime
+++ b/modules/mktime
@@ -1,4 +1,5 @@
 Description:
+mktime() function: convert broken-down time to linear time.
 
 Files:
 lib/mktime.c
--- 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
--- a/modules/mountlist
+++ b/modules/mountlist
@@ -1,4 +1,5 @@
 Description:
+Return list of mounted filesystems.
 
 Files:
 lib/mountlist.h
--- a/modules/nanosleep
+++ b/modules/nanosleep
@@ -1,4 +1,5 @@
 Description:
+nanosleep() function: pause execution for a specified time.
 
 Files:
 lib/nanosleep.c
--- a/modules/obstack
+++ b/modules/obstack
@@ -1,4 +1,5 @@
 Description:
+Memory allocation, optimized for stack-like allocation patterns.
 
 Files:
 lib/obstack.h
--- 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
--- 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
--- a/modules/physmem
+++ b/modules/physmem
@@ -1,4 +1,5 @@
 Description:
+Return amount of total/available physical memory.
 
 Files:
 lib/physmem.h
--- 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
--- 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
--- a/modules/putenv
+++ b/modules/putenv
@@ -1,4 +1,5 @@
 Description:
+putenv() function: change or add an environment variable.
 
 Files:
 lib/putenv.c
--- a/modules/quote
+++ b/modules/quote
@@ -1,4 +1,5 @@
 Description:
+Quote arguments for use in error messages.
 
 Files:
 lib/quote.h
--- a/modules/quotearg
+++ b/modules/quotearg
@@ -1,4 +1,5 @@
 Description:
+Quote arguments for use in error messages.
 
 Files:
 lib/quotearg.h
--- a/modules/readtokens
+++ b/modules/readtokens
@@ -1,4 +1,5 @@
 Description:
+Read tokens from a stream.
 
 Files:
 lib/readtokens.h
--- a/modules/readutmp
+++ b/modules/readutmp
@@ -1,4 +1,5 @@
 Description:
+Read entire utmp file into memory.
 
 Files:
 lib/readutmp.h
--- a/modules/realloc
+++ b/modules/realloc
@@ -1,4 +1,5 @@
 Description:
+realloc() function that is glibc compatible.
 
 Files:
 lib/realloc.c
--- a/modules/regex
+++ b/modules/regex
@@ -1,4 +1,5 @@
 Description:
+Regular expression matching.
 
 Files:
 lib/regex.h
--- 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
--- a/modules/rmdir
+++ b/modules/rmdir
@@ -1,4 +1,5 @@
 Description:
+rmdir() function: delete a directory.
 
 Files:
 lib/rmdir.c
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- a/modules/settime
+++ b/modules/settime
@@ -1,4 +1,5 @@
 Description:
+Set the current time, with nanosecond resolution.
 
 Files:
 lib/settime.c
--- a/modules/sha
+++ b/modules/sha
@@ -1,4 +1,5 @@
 Description:
+Compute SHA checksum.
 
 Files:
 lib/sha.h
--- a/modules/sig2str
+++ b/modules/sig2str
@@ -1,4 +1,5 @@
 Description:
+Convert between signal names and signal numbers.
 
 Files:
 lib/sig2str.h
--- 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
--- 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
--- 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
--- 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
--- a/modules/strcase
+++ b/modules/strcase
@@ -1,4 +1,5 @@
 Description:
+Case-insensitive string comparison functions.
 
 Files:
 lib/strcase.h
--- 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
--- a/modules/strdup
+++ b/modules/strdup
@@ -1,4 +1,5 @@
 Description:
+strdup() function: duplicate a string.
 
 Files:
 lib/strdup.c
--- a/modules/strerror
+++ b/modules/strerror
@@ -1,4 +1,5 @@
 Description:
+strerror() function: return string describing error code.
 
 Files:
 lib/strerror.c
--- 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
--- a/modules/strndup
+++ b/modules/strndup
@@ -1,4 +1,5 @@
 Description:
+strndup() function: duplicate a size-bounded string.
 
 Files:
 lib/strndup.c
--- 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
--- 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 @@
 gl_FUNC_STRPBRK
 
 Makefile.am:
+lib_SOURCES += strpbrk.h
 
 Include:
 "strpbrk.h"
--- a/modules/strstr
+++ b/modules/strstr
@@ -1,4 +1,5 @@
 Description:
+strstr() function: search for a substring in a string.
 
 Files:
 lib/strstr.h
--- a/modules/strtod
+++ b/modules/strtod
@@ -1,4 +1,5 @@
 Description:
+strtod() function: convert string to 'double'.
 
 Files:
 lib/strtod.c
--- 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/strtoimax.m4
 
 Depends-on:
+strtoll
 
 configure.ac:
 gl_FUNC_STRTOIMAX
--- a/modules/strtol
+++ b/modules/strtol
@@ -1,4 +1,5 @@
 Description:
+strtol() function: convert string to 'long'.
 
 Files:
 lib/strtol.c
--- a/modules/strtoll
+++ b/modules/strtoll
@@ -1,4 +1,5 @@
 Description:
+strtoll() function: convert string to 'long long'.
 
 Files:
 lib/strtoll.c
--- a/modules/strtoul
+++ b/modules/strtoul
@@ -1,4 +1,5 @@
 Description:
+strtoul() function: convert string to 'unsigned long'.
 
 Files:
 lib/strtoul.c
--- a/modules/strtoull
+++ b/modules/strtoull
@@ -1,4 +1,5 @@
 Description:
+strtoull() function: convert string to 'unsigned long long'.
 
 Files:
 lib/strtoull.c
--- 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 @@
 
 Depends-on:
 strtoimax
+strtoull
 
 configure.ac:
 gl_FUNC_STRTOUMAX
--- a/modules/strverscmp
+++ b/modules/strverscmp
@@ -1,4 +1,5 @@
 Description:
+Compare strings holding version numbers.
 
 Files:
 lib/strverscmp.h
--- a/modules/timespec
+++ b/modules/timespec
@@ -1,4 +1,5 @@
 Description:
+struct timespec.
 
 Files:
 lib/timespec.h
--- a/modules/unicodeio
+++ b/modules/unicodeio
@@ -1,4 +1,5 @@
 Description:
+Unicode character output to streams with locale dependent encoding.
 
 Files:
 lib/unicodeio.h
--- 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
--- 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
--- 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
--- 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
--- a/modules/version-etc
+++ b/modules/version-etc
@@ -1,4 +1,5 @@
 Description:
+Print --version output.
 
 Files:
 lib/version-etc.h
--- a/modules/xalloc
+++ b/modules/xalloc
@@ -1,4 +1,5 @@
 Description:
+Memory allocation with out-of-memory checking.
 
 Files:
 lib/xalloc.h
--- a/modules/xgetcwd
+++ b/modules/xgetcwd
@@ -1,4 +1,5 @@
 Description:
+Return the current working directory, without size limitations.
 
 Files:
 lib/xgetcwd.h
--- a/modules/xgethostname
+++ b/modules/xgethostname
@@ -1,4 +1,5 @@
 Description:
+Return machine's hostname, without size limitations.
 
 Files:
 lib/xgethostname.c
--- a/modules/xmemcoll
+++ b/modules/xmemcoll
@@ -1,4 +1,5 @@
 Description:
+Locale dependent memory area comparison, with error checking.
 
 Files:
 lib/xmemcoll.h
--- 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
--- a/modules/xstrtod
+++ b/modules/xstrtod
@@ -1,4 +1,5 @@
 Description:
+Convert string to 'double', with error checking.
 
 Files:
 lib/xstrtod.h
--- a/modules/xstrtoimax
+++ b/modules/xstrtoimax
@@ -1,4 +1,5 @@
 Description:
+Convert string to 'intmax_t', with error checking.
 
 Files:
 
--- 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
--- a/modules/xstrtoumax
+++ b/modules/xstrtoumax
@@ -1,4 +1,5 @@
 Description:
+Convert string to 'uintmax_t', with error checking.
 
 Files:
 lib/xstrtoumax.c
--- 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