complete s/foo/PL_foo/ changes (all escaped cases identified with
[p5sagit/p5-mst-13.2.git] / Porting / Glossary
index fb7154d..f681679 100644 (file)
@@ -1,6 +1,13 @@
 This file contains a description of all the shell variables whose value is
 determined by the Configure script.  Variables intended for use in C
-programs (e.g. I_UNISTD) are already described in config_h.SH.
+programs (e.g. I_UNISTD) are already described in config_h.SH.  [`configpm'
+generates pod documentation for Config.pm from this file--please try to keep
+the formatting regular.]
+
+Mcc (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the Mcc program.  After Configure runs,
+       the value is reset to a plain "Mcc" and is not useful.
 
 _a (Unix.U):
        This variable defines the extension used for ordinary libraries.
@@ -35,6 +42,20 @@ aphostname (d_gethname.U):
        host name. The command is fully qualified by its absolute path, to make
        it safe when used by a process with super-user privileges.
 
+apiversion (patchlevel.U):
+       This is a number which identifies the lowest version of perl
+       to have an API (for XS extensions) compatible with the present
+       version.  For example, for 5.005_01, the apiversion should be
+       5.005, since 5.005_01 should be binary compatible with 5.005.
+       This should probably be incremented manually somehow, perhaps
+       from patchlevel.h.  For now, we'll guess maintenance subversions
+       will retain binary compatibility.
+
+ar (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the ar program.  After Configure runs,
+       the value is reset to a plain "ar" and is not useful.
+
 archlib (archlib.U):
        This variable holds the name of the directory in which the user wants
        to put architecture-dependent public library files for $package.
@@ -57,9 +78,18 @@ archobjs (Unix.U):
        or other facilities.  For perl on OS/2, for example, this would
        include os2/os2.obj.
 
+awk (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the awk program.  After Configure runs,
+       the value is reset to a plain "awk" and is not useful.
+
 baserev (baserev.U):
        The base revision level of this package, from the .package file.
 
+bash (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 bin (bin.U):
        This variable holds the name of the directory in which the user wants
        to put publicly executable images for the package in question.  It
@@ -70,6 +100,15 @@ binexp (bin.U):
        This is the same as the bin variable, but is filename expanded at
        configuration time, for use in your makefiles.
 
+bison (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+byacc (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the byacc program.  After Configure runs,
+       the value is reset to a plain "byacc" and is not useful.
+
 byteorder (byteorder.U):
        This variable holds the byte order. In the following, larger digits
        indicate more significance.  The variable byteorder is either 4321
@@ -89,20 +128,25 @@ castflags (d_castneg.U):
                2 = couldn't cast >= 0x80000000
                4 = couldn't cast in argument expression list
 
+cat (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the cat program.  After Configure runs,
+       the value is reset to a plain "cat" and is not useful.
+
 cc (cc.U):
        This variable holds the name of a command to execute a C compiler which
        can resolve multiple global references that happen to have the same
-       name.  Usual values are "cc", "Mcc", "cc -M", and "gcc".
+       name.  Usual values are 'cc', 'Mcc', 'cc -M', and 'gcc'.
 
 cccdlflags (dlsrc.U):
        This variable contains any special flags that might need to be
-       passed with cc -c to compile modules to be used to create a shared
-       library that will be used for dynamic loading.  For hpux, this 
+       passed with 'cc -c' to compile modules to be used to create a shared
+       library that will be used for dynamic loading.  For hpux, this
        should be +z.  It is up to the makefile to use it.
 
 ccdlflags (dlsrc.U):
        This variable contains any special flags that might need to be
-       passed to cc to link with a shared library for dynamic loading. 
+       passed to cc to link with a shared library for dynamic loading.
        It is up to the makefile to use it.  For sunos 4.1, it should
        be empty.
 
@@ -122,17 +166,52 @@ cf_time (cf_who.U):
        Holds the output of the "date" command when the configuration file was
        produced. This is used to tag both config.sh and config_h.SH.
 
+chgrp (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+chmod (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+chown (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 clocktype (d_times.U):
        This variable holds the type returned by times(). It can be long,
        or clock_t on BSD sites (in which case <sys/types.h> should be
        included).
 
+comm (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the comm program.  After Configure runs,
+       the value is reset to a plain "comm" and is not useful.
+
+compress (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 contains (contains.U):
        This variable holds the command to do a grep with a proper return
        status.  On most sane systems it is simply "grep".  On insane systems
        it is a grep followed by a cat followed by a test.  This variable
        is primarily for the use of other Configure units.
 
+cp (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the cp program.  After Configure runs,
+       the value is reset to a plain "cp" and is not useful.
+
+cpio (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+cpp (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the cpp program.  After Configure runs,
+       the value is reset to a plain "cpp" and is not useful.
+
 cpp_stuff (cpp_stuff.U):
        This variable contains an identification of the catenation mechanism
        used by the C preprocessor.
@@ -170,6 +249,11 @@ cryptlib (d_crypt.U):
        the crypt() function is not defined in the standard C library. It is
        up to the Makefile to use this.
 
+csh (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the csh program.  After Configure runs,
+       the value is reset to a plain "csh" and is not useful.
+
 d_Gconvert (d_gconvert.U):
        This variable holds what Gconvert is defined as to convert
        floating point numbers into strings. It could be 'gconvert'
@@ -303,6 +387,11 @@ d_dup2 (d_dup2.U):
        This variable conditionally defines HAS_DUP2 if dup2() is
        available to duplicate file descriptors.
 
+d_endgrent (d_endgrent.U):
+       This variable conditionally defines the HAS_ENDGRENT symbol, which
+       indicates to the C program that the endgrent() routine is available
+       for sequential access of the group database.
+
 d_endhent (d_endhent.U):
        This variable conditionally defines HAS_ENDHOSTENT if endhostent() is
        available to close whatever was being used for host queries.
@@ -315,6 +404,11 @@ d_endpent (d_endpent.U):
        This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is
        available to close whatever was being used for protocol queries.
 
+d_endpwent (d_endpwent.U):
+       This variable conditionally defines the HAS_ENDPWENT symbol, which
+       indicates to the C program that the endpwent() routine is available
+       for sequential access of the passwd database.
+
 d_endsent (d_endsent.U):
        This variable conditionally defines HAS_ENDSERVENT if endservent() is
        available to close whatever was being used for service queries.
@@ -388,6 +482,11 @@ d_ftime (d_ftime.U):
        that the ftime() routine exists.  The ftime() routine is basically
        a sub-second accuracy clock.
 
+d_getgrent (d_getgrent.U):
+       This variable conditionally defines the HAS_GETGRENT symbol, which
+       indicates to the C program that the getgrent() routine is available
+       for sequential access of the group database.
+
 d_getgrps (d_getgrps.U):
        This variable conditionally defines the HAS_GETGROUPS symbol, which
        indicates to the C program that the getgroups() routine is available
@@ -488,6 +587,11 @@ d_getprotoprotos (d_getprotoprotos.U):
        prototypes for the various getproto*() functions.  
        See also netdbtype.U for probing for various netdb types.
 
+d_getpwent (d_getpwent.U):
+       This variable conditionally defines the HAS_GETPWENT symbol, which
+       indicates to the C program that the getpwent() routine is available
+       for sequential access of the passwd database.
+
 d_getsbyname (d_getsrvby.U):
        This variable conditionally defines the HAS_GETSERVBYNAME 
        symbol, which indicates to the C program that the 
@@ -518,6 +622,10 @@ d_gettimeod (d_ftime.U):
 d_gnulibc (d_gnulibc.U):
        Defined if we're dealing with the GNU C Library.
 
+d_grpasswd (i_grp.U):
+       This variable conditionally defines GRPASSWD, which indicates
+       that struct group in <grp.h> contains gr_passwd.
+
 d_htonl (d_htonl.U):
        This variable conditionally defines HAS_HTONL if htonl() and its
        friends are available to do network order byte swapping.
@@ -726,6 +834,10 @@ d_pwgecos (i_pwd.U):
        This variable conditionally defines PWGECOS, which indicates
        that struct passwd contains pw_gecos.
 
+d_pwpasswd (i_pwd.U):
+       This variable conditionally defines PWPASSWD, which indicates
+       that struct passwd contains pw_passwd.
+
 d_pwquota (i_pwd.U):
        This variable conditionally defines PWQUOTA, which indicates
        that struct passwd contains pw_quota.
@@ -813,6 +925,11 @@ d_seteuid (d_seteuid.U):
        indicates to the C program that the seteuid() routine is available
        to change the effective uid of the current program.
 
+d_setgrent (d_setgrent.U):
+       This variable conditionally defines the HAS_SETGRENT symbol, which
+       indicates to the C program that the setgrent() routine is available
+       for initializing sequential access to the group database.
+
 d_setgrps (d_setgrps.U):
        This variable conditionally defines the HAS_SETGROUPS symbol, which
        indicates to the C program that the setgroups() routine is available
@@ -857,6 +974,11 @@ d_setprior (d_setprior.U):
        This variable conditionally defines HAS_SETPRIORITY if setpriority()
        is available to set a process's priority.
 
+d_setpwent (d_setpwent.U):
+       This variable conditionally defines the HAS_SETPWENT symbol, which
+       indicates to the C program that the setpwent() routine is available
+       for initializing sequential access to the passwd database.
+
 d_setregid (d_setregid.U):
        This variable conditionally defines HAS_SETREGID if setregid() is
        available to change the real and effective gid of the current
@@ -1137,6 +1259,11 @@ d_xenix (Guess.U):
        This variable conditionally defines the symbol XENIX, which alerts
        the C program that it runs under Xenix.
 
+date (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the date program.  After Configure runs,
+       the value is reset to a plain "date" and is not useful.
+
 db_hashtype (i_db.U):
        This variable contains the type of the hash structure element
        in the <db.h> header file.  In older versions of DB, it was
@@ -1165,7 +1292,7 @@ doublesize (doublesize.U):
        indicates to the C program how many bytes there are in a double.
 
 dynamic_ext (Extensions.U):
-       This variable holds a list of extension files we want to
+       This variable holds a list of XS extension files we want to
        link dynamically into the package.  It is used by Makefile.
 
 eagain (nblock_io.U):
@@ -1173,6 +1300,26 @@ eagain (nblock_io.U):
        data is present on the file and non-blocking I/O was enabled (otherwise,
        read() blocks naturally).
 
+ebcdic (ebcdic.U):
+       This variable conditionally defines EBCDIC if this
+       system uses EBCDIC encoding.  Among other things, this
+       means that the character ranges are not contiguous.
+       See trnl.U
+
+echo (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the echo program.  After Configure runs,
+       the value is reset to a plain "echo" and is not useful.
+
+egrep (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the egrep program.  After Configure runs,
+       the value is reset to a plain "egrep" and is not useful.
+
+emacs (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 eunicefix (Init.U):
        When running under Eunice this variable contains a command which will
        convert a shell script to the proper form of text file for it to be
@@ -1181,18 +1328,32 @@ eunicefix (Init.U):
 exe_ext (Unix.U):
        This is an old synonym for _exe.
 
+expr (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the expr program.  After Configure runs,
+       the value is reset to a plain "expr" and is not useful.
+
 extensions (Extensions.U):
-       This variable holds a list of all extension files
-       linked into the package.  It is propagated to Config.pm
+       This variable holds a list of all extension files (both XS and
+       non-xs linked into the package.  It is propagated to Config.pm
        and is typically used to test whether a particular extesion 
        is available.
 
+find (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the find program.  After Configure runs,
+       the value is reset to a plain "find" and is not useful.
+
 firstmakefile (Unix.U):
        This variable defines the first file searched by make.  On unix,
        it is makefile (then Makefile).  On case-insensitive systems,
        it might be something else.  This is only used to deal with
        convoluted make depend tricks.
 
+flex (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 fpostype (fpostype.U):
        This variable defines Fpos_t to be something like fpost_t, long, 
        uint, or whatever type is used to declare file positions in libc.
@@ -1225,6 +1386,11 @@ gidtype (gidtype.U):
        ushort, or whatever type is used to declare the return type
        of getgid().  Typically, it is the type of group ids in the kernel.
 
+grep (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the grep program.  After Configure runs,
+       the value is reset to a plain "grep" and is not useful.
+
 groupcat (nis.U):
        This variable contains a command that produces the text of the
        /etc/group file.  This is normally "cat /etc/group", but can be
@@ -1236,6 +1402,11 @@ groupstype (groupstype.U):
        getgroups() and setgroups().  Usually, this is the same as
        gidtype (gid_t), but sometimes it isn't.
 
+gzip (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the gzip program.  After Configure runs,
+       the value is reset to a plain "gzip" and is not useful.
+
 h_fcntl (h_fcntl.U):
        This is variable gets set in various places to tell i_fcntl that
        <fcntl.h> should be included.
@@ -1259,6 +1430,10 @@ huge (models.U):
        huge model is not supported, contains the flag to produce large
        model programs.  It is up to the Makefile to use this.
 
+i_arpainet (i_arpainet.U):
+       This variable conditionally defines the I_ARPA_INET symbol,
+       and indicates whether a C program should include <arpa/inet.h>.
+
 i_bsdioctl (i_sysioctl.U):
        This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
        indicates to the C program that <sys/bsdioctl.h> exists and should
@@ -1501,6 +1676,10 @@ incpath (usrinc.U):
        right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
        Value can be "" or "/bsd43" on mips.
 
+inews (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 installarchlib (archlib.U):
        This variable is really the same as archlibexp but may differ on
        those systems using AFS. For extra portability, only this variable
@@ -1548,9 +1727,13 @@ intsize (intsize.U):
        indicates to the C program how many bytes there are in an int.
 
 known_extensions (Extensions.U):
-       This variable holds a list of all extensions included in 
+       This variable holds a list of all XS extensions included in 
        the package.
 
+ksh (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 large (models.U):
        This variable contains a flag which will tell the C compiler and loader
        to produce a program running with a large memory model.  It is up to
@@ -1566,12 +1749,17 @@ lddlflags (dlsrc.U):
        This variable contains any special flags that might need to be
        passed to $ld to create a shared library suitable for dynamic
        loading.  It is up to the makefile to use it.  For hpux, it
-       should be -b.  For sunos 4.1, it is empty.
+       should be '-b'.  For sunos 4.1, it is empty.
 
 ldflags (ccflags.U):
        This variable contains any additional C loader flags desired by
        the user.  It is up to the Makefile to use this.
 
+less (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the less program.  After Configure runs,
+       the value is reset to a plain "less" and is not useful.
+
 lib_ext (Unix.U):
        This is an old synonym for _a.
 
@@ -1599,10 +1787,24 @@ libswanted (Myinit.U):
        search.  The order is chosen to pick up the c library
        ahead of ucb or bsd libraries for SVR4.
 
+line (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the line program.  After Configure runs,
+       the value is reset to a plain "line" and is not useful.
+
+lint (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 lkflags (ccflags.U):
        This variable contains any additional C partial linker flags desired by
        the user.  It is up to the Makefile to use this.
 
+ln (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the ln program.  After Configure runs,
+       the value is reset to a plain "ln" and is not useful.
+
 lns (lns.U):
        This variable holds the name of the command to make 
        symbolic links (if they are supported).  It can be used
@@ -1610,7 +1812,7 @@ lns (lns.U):
 
 locincpth (ccflags.U):
        This variable contains a list of additional directories to be
-       searched by the compiler.  The appropriate -I directives will
+       searched by the compiler.  The appropriate '-I' directives will
        be added to ccflags.  This is intended to simplify setting
        local directories from the Configure command line.
        It's not much, but it parallels the loclibpth stuff in libpth.U.
@@ -1634,11 +1836,37 @@ longsize (intsize.U):
        This variable contains the value of the LONGSIZE symbol, which
        indicates to the C program how many bytes there are in a long.
 
+lp (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+lpr (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+ls (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the ls program.  After Configure runs,
+       the value is reset to a plain "ls" and is not useful.
+
 lseektype (lseektype.U):
        This variable defines lseektype to be something like off_t, long, 
        or whatever type is used to declare lseek offset's type in the
        kernel (which also appears to be lseek's return type).
 
+mail (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+mailx (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+make (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the make program.  After Configure runs,
+       the value is reset to a plain "make" and is not useful.
+
 make_set_make (make.U):
        Some versions of 'make' set the variable MAKE.  Others do not.
        This variable contains the string to be included in Makefile.SH
@@ -1647,7 +1875,7 @@ make_set_make (make.U):
        make_set_make='#'               # If your make program handles this for you,
        make_set_make="MAKE=$make"      # if it doesn't.
        I used a comment character so that we can distinguish a
-       'set' value (from a previous config.sh or Configure -D option)
+       'set' value (from a previous config.sh or Configure '-D' option)
        from an uncomputed value.
 
 mallocobj (mallocsrc.U):
@@ -1705,6 +1933,11 @@ mips_type (usrinc.U):
        This variable holds the environment type for the mips system.
        Possible values are "BSD 4.3" and "System V".
 
+mkdir (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the mkdir program.  After Configure runs,
+       the value is reset to a plain "mkdir" and is not useful.
+
 models (models.U):
        This variable contains the list of memory models supported by this
        system.  Possible component values are none, split, unsplit, small,
@@ -1715,6 +1948,15 @@ modetype (modetype.U):
        int, unsigned short, or whatever type is used to declare file 
        modes for system calls.
 
+more (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the more program.  After Configure runs,
+       the value is reset to a plain "more" and is not useful.
+
+mv (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 myarchname (archname.U):
        This variable holds the architecture name computed by Configure in
        a previous run. It is not intended to be perused by any user and
@@ -1738,7 +1980,7 @@ myuname (Oldconfig.U):
        whole thing is then lower-cased.
 
 n (n.U):
-       This variable contains the -n flag if that is what causes the echo
+       This variable contains the '-n' flag if that is what causes the echo
        command to suppress newline.  Otherwise it is null.  Correct usage is
            $echo $n "prompt for a question: $c".
 
@@ -1763,6 +2005,11 @@ netdb_net_type (netdbtype.U):
        getnetbyaddr().  Usually, this is int or long.
        This is only useful if you have getnetbyaddr(), naturally.
 
+nm (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the nm program.  After Configure runs,
+       the value is reset to a plain "nm" and is not useful.
+
 nm_opt (usenm.U):
        This variable holds the options that may be necessary for nm.
 
@@ -1774,6 +2021,15 @@ nm_so_opt (usenm.U):
        has been stripped, but nm --dynamic is *fatal* on an archive library.
        Maybe Linux should just always set usenm=false.
 
+nonxs_ext (Extensions.U):
+       This variable holds a list of all non-xs extensions included
+       in the package.  All of them will be built.
+
+nroff (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the nroff program.  After Configure runs,
+       the value is reset to a plain "nroff" and is not useful.
+
 o_nonblock (nblock_io.U):
        This variable bears the symbol value to be used during open() or fcntl()
        to turn on non-blocking I/O for a file descriptor. If you wish to switch
@@ -1829,6 +2085,11 @@ path_sep (Unix.U):
        This is an old synonym for p_ in Head.U, the character
        used to separate elements in the command shell search PATH.
 
+perl (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the perl program.  After Configure runs,
+       the value is reset to a plain "perl" and is not useful.
+
 perladmin (perladmin.U):
        Electronic mail address of the perl5 administrator.
 
@@ -1837,6 +2098,11 @@ perlpath (perlpath.U):
        which contains the name of the perl interpreter to be used in
        shell scripts and in the "eval 'exec'" idiom.
 
+pg (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the pg program.  After Configure runs,
+       the value is reset to a plain "pg" and is not useful.
+
 phostname (myhostname.U):
        This variable contains the eventual value of the PHOSTNAME symbol,
        which is a command that can be fed to popen() to get the host name.
@@ -1852,6 +2118,14 @@ plibpth (libpth.U):
        Its value is prepend to libpth. This variable takes care of special
        machines, like the mips.  Usually, it should be empty.
 
+pmake (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+pr (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 prefix (prefix.U):
        This variable holds the name of the directory below which the
        user will install the package.  Usually, this is /usr/local, and
@@ -1897,6 +2171,15 @@ rd_nodata (nblock_io.U):
        used, which is a shame because you cannot make the difference between
        no data and an EOF.. Sigh!
 
+rm (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the rm program.  After Configure runs,
+       the value is reset to a plain "rm" and is not useful.
+
+rmail (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 runnm (usenm.U):
        This variable contains 'true' or 'false' depending whether the
        nm extraction should be performed or not, according to the value
@@ -1913,21 +2196,35 @@ scriptdirexp (scriptdir.U):
        This variable is the same as scriptdir, but is filename expanded
        at configuration time, for programs not wanting to bother with it.
 
+sed (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the sed program.  After Configure runs,
+       the value is reset to a plain "sed" and is not useful.
+
 selecttype (selecttype.U):
        This variable holds the type used for the 2nd, 3rd, and 4th
        arguments to select.  Usually, this is 'fd_set *', if HAS_FD_SET
        is defined, and 'int *' otherwise.  This is only useful if you 
        have select(), naturally.
 
+sendmail (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the sendmail program.  After Configure runs,
+       the value is reset to a plain "sendmail" and is not useful.
+
 sh (sh.U):
        This variable contains the full pathname of the shell used
        on this system to execute Bourne shell scripts.  Usually, this will be
        /bin/sh, though it's possible that some systems will have /bin/ksh,
        /bin/pdksh, /bin/ash, /bin/bash, or even something such as
        D:/bin/sh.exe.
-       This unit comes before Options.U, so you can't set sh with a -D
+       This unit comes before Options.U, so you can't set sh with a '-D'
        option, though you can override this (and startsh)
-       with -O -Dsh=/bin/whatever -Dstartsh=whatever
+       with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
+
+shar (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
 
 sharpbang (spitshell.U):
        This variable contains the string #! if this system supports that
@@ -2008,6 +2305,14 @@ sizetype (sizetype.U):
        unsigned long, or whatever type is used to declare length 
        parameters for string functions.
 
+sleep (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+smail (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 small (models.U):
        This variable contains a flag which will tell the C compiler and loader
        to produce a program running with a small memory model.  It is up to
@@ -2018,11 +2323,16 @@ so (so.U):
        (also known as shared objects) on the system. Usually set to 'so'.
 
 sockethdr (d_socket.U):
-       This variable has any cpp -I flags needed for socket support.
+       This variable has any cpp '-I' flags needed for socket support.
 
 socketlib (d_socket.U):
        This variable has the names of any libraries needed for socket support.
 
+sort (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the sort program.  After Configure runs,
+       the value is reset to a plain "sort" and is not useful.
+
 spackage (package.U):
        This variable contains the name of the package being constructed,
        with the first letter uppercased, i.e. suitable for starting
@@ -2030,7 +2340,7 @@ spackage (package.U):
 
 spitshell (spitshell.U):
        This variable contains the command necessary to spit out a runnable
-       shell on this system.  It is either cat or a grep -v for # comments.
+       shell on this system.  It is either cat or a grep '-v' for # comments.
 
 split (models.U):
        This variable contains a flag which will tell the C compiler and loader
@@ -2065,7 +2375,7 @@ startsh (startsh.U):
        other shell.
 
 static_ext (Extensions.U):
-       This variable holds a list of extension files we want to
+       This variable holds a list of XS extension files we want to
        link statically into the package.  It is used by Makefile.
 
 stdchar (stdchar.U):
@@ -2102,6 +2412,10 @@ strings (i_string.U):
        This variable holds the full path of the string header that will be
        used. Typically /usr/include/string.h or /usr/include/strings.h.
 
+submit (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 subversion (patchlevel.U):
        The subversion level of this package.
        The value of subversion comes from the patchlevel.h file.
@@ -2113,6 +2427,28 @@ sysman (sysman.U):
        pages. Rather it is the place where Configure may look to find manual
        for unix commands (section 1 of the manual usually). See mansrc.
 
+tail (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+tar (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+tbl (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+tee (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the tee program.  After Configure runs,
+       the value is reset to a plain "tee" and is not useful.
+
+test (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the test program.  After Configure runs,
+       the value is reset to a plain "test" and is not useful.
+
 timeincl (i_time.U):
        This variable holds the full path of the included time header(s).
 
@@ -2121,10 +2457,40 @@ timetype (d_time.U):
        or time_t on BSD sites (in which case <sys/types.h> should be
        included). Anyway, the type Time_t should be used.
 
+touch (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the touch program.  After Configure runs,
+       the value is reset to a plain "touch" and is not useful.
+
+tr (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the tr program.  After Configure runs,
+       the value is reset to a plain "tr" and is not useful.
+
+trnl (trnl.U):
+       This variable contains the value to be passed to the tr(1)
+       command to transliterate a newline.  Typical values are
+       '\012' and '\n'.  This is needed for EBCDIC systems where
+       newline is not necessarily '\012'.
+
+troff (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 uidtype (uidtype.U):
        This variable defines Uid_t to be something like uid_t, int, 
        ushort, or whatever type is used to declare user ids in the kernel.
 
+uname (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the uname program.  After Configure runs,
+       the value is reset to a plain "uname" and is not useful.
+
+uniq (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the uniq program.  After Configure runs,
+       the value is reset to a plain "uniq" and is not useful.
+
 usedl (dlsrc.U):
        This variable indicates if the the system supports dynamic
        loading of some sort.  See also dlsrc and dlobj.
@@ -2183,8 +2549,32 @@ usrinc (usrinc.U):
        This variable holds the path of the include files, which is
        usually /usr/include. It is mainly used by other Configure units.
 
+uuname (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+version (patchlevel.U):
+       The full version number of this package.  This combines
+       baserev, patchlevel, and subversion to get the full
+       version number, including any possible subversions.  Care
+       is taken to use the C locale in order to get something
+       like 5.004 instead of 5,004.  This is unique to perl.
+
+vi (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
 voidflags (voidflags.U):
        This variable contains the eventual value of the VOIDFLAGS symbol,
        which indicates how much support of the void type is given by this
        compiler.  See VOIDFLAGS for more info.
 
+zcat (Loc.U):
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
+
+zip (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the zip program.  After Configure runs,
+       the value is reset to a plain "zip" and is not useful.
+