complete s/foo/PL_foo/ changes (all escaped cases identified with
[p5sagit/p5-mst-13.2.git] / Porting / Glossary
index fe7e630..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.
@@ -26,11 +33,29 @@ alignbytes (alignbytes.U):
        This variable holds the number of bytes required to align a
        double. Usual values are 2, 4 and 8.
 
+ansi2knr (ansi2knr.U):
+       This variable is set if the user needs to run ansi2knr.  
+       Currently, this is not supported, so we just abort.
+
 aphostname (d_gethname.U):
        Thie variable contains the command which can be used to compute the
        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.
@@ -53,23 +78,37 @@ 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
        is most often a local directory such as /usr/local/bin. Programs using
        this variable must be prepared to deal with ~name substitution.
 
-bincompat3 (bincompat3.U):
-       This variable contains y if Perl 5.004 should be binary-compatible
-       with Perl 5.003.
-
 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'
@@ -188,6 +272,11 @@ d_archlib (archlib.U):
        of architecture-dependent library files for $package.  If
        $archlib is the same as $privlib, then this is set to undef.
 
+d_attribut (d_attribut.U):
+       This variable conditionally defines HASATTRIBUTE, which
+       indicates the C compiler can check for function attributes,
+       such as printf formats.
+
 d_bcmp (d_bcmp.U):
        This variable conditionally defines the HAS_BCMP symbol if
        the bcmp() routine is available to compare strings.
@@ -196,12 +285,6 @@ d_bcopy (d_bcopy.U):
        This variable conditionally defines the HAS_BCOPY symbol if
        the bcopy() routine is available to copy strings.
 
-d_bincompat3 (bincompat3.U):
-       This variable conditionally defines BINCOMPAT3 so that embed.h
-       can take special action if Perl 5.004 should be binary-compatible
-       with Perl 5.003.  This is impossible for 5.004_50 and later, so
-       it is always $undef for those versions.
-
 d_bsd (Guess.U):
        This symbol conditionally defines the symbol BSD when running on a
        BSD system.
@@ -210,6 +293,11 @@ d_bsdgetpgrp (d_getpgrp.U):
        This variable conditionally defines USE_BSD_GETPGRP if
        getpgrp needs one arguments whereas USG one needs none.
 
+d_bsdsetpgrp (d_setpgrp.U):
+       This variable conditionally defines USE_BSD_SETPGRP if
+       setpgrp needs two arguments whereas USG one needs none.
+       See also d_setpgid for a POSIX interface.
+
 d_bzero (d_bzero.U):
        This variable conditionally defines the HAS_BZERO symbol if
        the bzero() routine is available to set memory to 0.
@@ -299,6 +387,32 @@ 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.
+
+d_endnent (d_endnent.U):
+       This variable conditionally defines HAS_ENDNETENT if endnetent() is
+       available to close whatever was being used for network queries.
+
+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.
+
 d_eofnblk (nblock_io.U):
        This variable conditionally defines EOF_NONBLOCK if EOF can be seen
        when reading from a non-blocking I/O source.
@@ -368,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
@@ -378,6 +497,11 @@ d_gethbyaddr (d_gethbyad.U):
        indicates to the C program that the gethostbyaddr() routine is available
        to look up hosts by their IP addresses.
 
+d_gethbyname (d_gethbynm.U):
+       This variable conditionally defines the HAS_GETHOSTBYNAME symbol, which
+       indicates to the C program that the gethostbyname() routine is available
+       to look up host names in some data base or other.
+
 d_gethent (d_gethent.U):
        This variable conditionally defines HAS_GETHOSTENT if gethostent() is
        available to look up host names in some data base or another.
@@ -387,6 +511,12 @@ d_gethname (d_gethname.U):
        indicates to the C program that the gethostname() routine may be
        used to derive the host name.
 
+d_gethostprotos (d_gethostprotos.U):
+       This variable conditionally defines the HAS_GETHOST_PROTOS symbol,
+       which indicates to the C program that <netdb.h> supplies
+       prototypes for the various gethost*() functions.  
+       See also netdbtype.U for probing for various netdb types.
+
 d_getlogin (d_getlogin.U):
        This variable conditionally defines the HAS_GETLOGIN symbol, which
        indicates to the C program that the getlogin() routine is available
@@ -402,6 +532,16 @@ d_getnbyname (d_getnbynm.U):
        indicates to the C program that the getnetbyname() routine is available
        to look up networks by their names.
 
+d_getnent (d_getnent.U):
+       This variable conditionally defines HAS_GETNETENT if getnetent() is
+       available to look up network names in some data base or another.
+
+d_getnetprotos (d_getnetprotos.U):
+       This variable conditionally defines the HAS_GETNET_PROTOS symbol,
+       which indicates to the C program that <netdb.h> supplies
+       prototypes for the various getnet*() functions.  
+       See also netdbtype.U for probing for various netdb types.
+
 d_getpbyname (d_getprotby.U):
        This variable conditionally defines the HAS_GETPROTOBYNAME 
        symbol, which indicates to the C program that the 
@@ -414,6 +554,10 @@ d_getpbynumber (d_getprotby.U):
        getprotobynumber() routine is available to look up protocols
        by their number.
 
+d_getpent (d_getpent.U):
+       This variable conditionally defines HAS_GETPROTOENT if getprotoent() is
+       available to look up protocols in some data base or another.
+
 d_getpgid (d_getpgid.U):
        This variable conditionally defines the HAS_GETPGID symbol, which
        indicates to the C program that the getpgid(pid) function
@@ -437,6 +581,17 @@ d_getprior (d_getprior.U):
        This variable conditionally defines HAS_GETPRIORITY if getpriority()
        is available to get a process's priority.
 
+d_getprotoprotos (d_getprotoprotos.U):
+       This variable conditionally defines the HAS_GETPROTO_PROTOS symbol,
+       which indicates to the C program that <netdb.h> supplies
+       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 
@@ -449,6 +604,16 @@ d_getsbyport (d_getsrvby.U):
        getservbyport() routine is available to look up services
        by their port.
 
+d_getsent (d_getsent.U):
+       This variable conditionally defines HAS_GETSERVENT if getservent() is
+       available to look up network services in some data base or another.
+
+d_getservprotos (d_getservprotos.U):
+       This variable conditionally defines the HAS_GETSERV_PROTOS symbol,
+       which indicates to the C program that <netdb.h> supplies
+       prototypes for the various getserv*() functions.  
+       See also netdbtype.U for probing for various netdb types.
+
 d_gettimeod (d_ftime.U):
        This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
        indicates that the gettimeofday() system call exists (to obtain a
@@ -457,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.
@@ -479,6 +648,11 @@ d_killpg (d_killpg.U):
        indicates to the C program that the killpg() routine is available
        to kill process groups.
 
+d_lchown (d_lchown.U):
+       This variable conditionally defines the HAS_LCHOWN symbol, which
+       indicates to the C program that the lchown() routine is available
+       to operate on a symbolic link (instead of following the link).
+
 d_link (d_link.U):
        This variable conditionally defines HAS_LINK if link() is
        available to create hard links.
@@ -491,6 +665,14 @@ d_lockf (d_lockf.U):
        This variable conditionally defines HAS_LOCKF if lockf() is
        available to do file locking.
 
+d_longdbl (d_longdbl.U):
+       This variable conditionally defines HAS_LONG_DOUBLE if 
+       the long double type is supported.
+
+d_longlong (d_longlong.U):
+       This variable conditionally defines HAS_LONG_LONG if 
+       the long long type is supported.
+
 d_lstat (d_lstat.U):
        This variable conditionally defines HAS_LSTAT if lstat() is
        available to do file stats on symbolic links.
@@ -629,27 +811,35 @@ d_pthreads_created_joinable (d_pthreadj.U):
        state.
 
 d_pwage (i_pwd.U):
-       This varaible conditionally defines PWAGE, which indicates
+       This variable conditionally defines PWAGE, which indicates
        that struct passwd contains pw_age.
 
 d_pwchange (i_pwd.U):
-       This varaible conditionally defines PWCHANGE, which indicates
+       This variable conditionally defines PWCHANGE, which indicates
        that struct passwd contains pw_change.
 
 d_pwclass (i_pwd.U):
-       This varaible conditionally defines PWCLASS, which indicates
+       This variable conditionally defines PWCLASS, which indicates
        that struct passwd contains pw_class.
 
 d_pwcomment (i_pwd.U):
-       This varaible conditionally defines PWCOMMENT, which indicates
+       This variable conditionally defines PWCOMMENT, which indicates
        that struct passwd contains pw_comment.
 
 d_pwexpire (i_pwd.U):
-       This varaible conditionally defines PWEXPIRE, which indicates
+       This variable conditionally defines PWEXPIRE, which indicates
        that struct passwd contains pw_expire.
 
+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 varaible conditionally defines PWQUOTA, which indicates
+       This variable conditionally defines PWQUOTA, which indicates
        that struct passwd contains pw_quota.
 
 d_readdir (d_readdir.U):
@@ -709,6 +899,14 @@ d_semctl (d_semctl.U):
        This variable conditionally defines the HAS_SEMCTL symbol, which
        indicates to the C program that the semctl() routine is available.
 
+d_semctl_semid_ds (d_union_senum.U):
+       This variable conditionally defines USE_SEMCTL_SEMID_DS, which
+       indicates that struct semid_ds * is to be used for semctl IPC_STAT.
+
+d_semctl_semun (d_union_senum.U):
+       This variable conditionally defines USE_SEMCTL_SEMUN, which
+       indicates that union semun is to be used for semctl IPC_STAT.
+
 d_semget (d_semget.U):
        This variable conditionally defines the HAS_SEMGET symbol, which
        indicates to the C program that the semget() routine is available.
@@ -727,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
@@ -746,6 +949,14 @@ d_setlocale (d_setlocale.U):
        This variable conditionally defines HAS_SETLOCALE if setlocale() is
        available to handle locale-specific ctype implementations.
 
+d_setnent (d_setnent.U):
+       This variable conditionally defines HAS_SETNETENT if setnetent() is
+       available.
+
+d_setpent (d_setpent.U):
+       This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
+       available.
+
 d_setpgid (d_setpgid.U):
        This variable conditionally defines the HAS_SETPGID symbol if the
        setpgid(pid, gpid) function is available to set process group ID.
@@ -763,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
@@ -793,10 +1009,19 @@ d_setruid (d_setruid.U):
        indicates to the C program that the setruid() routine is available
        to change the real uid of the current program.
 
+d_setsent (d_setsent.U):
+       This variable conditionally defines HAS_SETSERVENT if setservent() is
+       available.
+
 d_setsid (d_setsid.U):
        This variable conditionally defines HAS_SETSID if setsid() is
        available to set the process group ID.
 
+d_setvbuf (d_setvbuf.U):
+       This variable conditionally defines the HAS_SETVBUF symbol, which
+       indicates to the C program that the setvbuf() routine is available
+       to change buffering on an open stdio stream.
+
 d_sfio (d_sfio.U):
        This variable conditionally defines the USE_SFIO symbol,
        and indicates whether sfio is available (and should be used).
@@ -979,6 +1204,10 @@ d_uname (d_gethname.U):
        indicates to the C program that the uname() routine may be
        used to derive the host name.
 
+d_union_semun (d_union_senum.U):
+       This variable conditionally defines HAS_UNION_SEMUN if the
+       union semun is defined by including <sys/sem.h>.
+
 d_vfork (d_vfork.U):
        This variable conditionally defines the HAS_VFORK symbol, which
        indicates the vfork() routine is available.
@@ -1030,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
@@ -1058,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):
@@ -1066,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
@@ -1074,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.
@@ -1118,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
@@ -1129,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.
@@ -1152,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
@@ -1161,6 +1443,11 @@ i_db (i_db.U):
        This variable conditionally defines the I_DB symbol, and indicates
        whether a C program may include Berkeley's DB include file <db.h>.
 
+i_dbm (i_dbm.U):
+       This variable conditionally defines the I_DBM symbol, which
+       indicates to the C program that <dbm.h> exists and should
+       be included.
+
 i_dirent (i_dirent.U):
        This variable conditionally defines I_DIRENT, which indicates
        to the C program that it should include <dirent.h>.
@@ -1184,6 +1471,11 @@ i_float (i_float.U):
        whether a C program may include <float.h> to get symbols like DBL_MAX
        or DBL_MIN, i.e. machine dependent floating point values.
 
+i_gdbm (i_gdbm.U):
+       This variable conditionally defines the I_GDBM symbol, which
+       indicates to the C program that <gdbm.h> exists and should
+       be included.
+
 i_grp (i_grp.U):
        This variable conditionally defines the I_GRP symbol, and indicates
        whether a C program should include <grp.h>.
@@ -1209,6 +1501,11 @@ i_memory (i_memory.U):
        This variable conditionally defines the I_MEMORY symbol, and indicates
        whether a C program should include <memory.h>.
 
+i_ndbm (i_ndbm.U):
+       This variable conditionally defines the I_NDBM symbol, which
+       indicates to the C program that <ndbm.h> exists and should
+       be included.
+
 i_netdb (i_netdb.U):
        This variable conditionally defines the I_NETDB symbol, and indicates
        whether a C program should include <netdb.h>.
@@ -1379,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
@@ -1426,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
@@ -1444,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.
 
@@ -1477,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
@@ -1488,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.
@@ -1498,15 +1822,51 @@ loclibpth (libpth.U):
        prepended to libpth, and is intended to be easily set from the
        command line.
 
+longdblsize (d_longdbl.U):
+       This variable contains the value of the LONG_DOUBLESIZE symbol, which
+       indicates to the C program how many bytes there are in a long double,
+       if this system supports long doubles.
+
+longlongsize (d_longlong.U):
+       This variable contains the value of the LONGLONGSIZE symbol, which
+       indicates to the C program how many bytes there are in a long long,
+       if this system supports long long.
+
 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
@@ -1515,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):
@@ -1573,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,
@@ -1583,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
@@ -1594,13 +1968,19 @@ mydomain (myhostname.U):
        The domain must be appended to myhostname to form a complete host name.
        The dot comes with mydomain, and need not be supplied by the program.
 
+myhostname (myhostname.U):
+       This variable contains the eventual value of the MYHOSTNAME symbol,
+       which is the name of the host the program is going to run on.
+       The domain is not kept with hostname, but must be gotten from mydomain.
+       The dot comes with mydomain, and need not be supplied by the program.
+
 myuname (Oldconfig.U):
        The output of 'uname -a' if available, otherwise the hostname. On Xenix,
        pseudo variables assignments in the output are stripped, thank you. The
        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".
 
@@ -1625,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.
 
@@ -1636,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
@@ -1691,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.
 
@@ -1699,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.
@@ -1714,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
@@ -1759,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
@@ -1775,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
@@ -1870,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
@@ -1880,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
@@ -1892,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
@@ -1900,6 +2348,11 @@ split (models.U):
        machines that support separation of instruction and data space.  It is
        up to the Makefile to use this.
 
+src (src.U):
+       This variable holds the path to the package source. It is up to
+       the Makefile to use this variable and set VPATH accordingly to
+       find the sources remotely.
+
 ssizetype (ssizetype.U):
        This variable defines ssizetype to be something like ssize_t, 
        long or int.  It is used by functions that return a count 
@@ -1922,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):
@@ -1959,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.
@@ -1970,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).
 
@@ -1978,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.
@@ -2040,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.
+