The first steps towards cross-compilation.
[p5sagit/p5-mst-13.2.git] / Porting / Glossary
index 30c75b6..26e6e4c 100644 (file)
@@ -24,9 +24,16 @@ afs (afs.U):
        with a hint value or command line option, but you'd better know
        what you are doing.
 
+afsroot (afs.U):
+       This variable is by default set to '/afs'. In the unlikely case
+       this is not the correct root, it is possible to override this with
+       a hint value or command line option.  This will be used in subsequent
+       tests for AFSness in the Perl configure and test process. 
+
 alignbytes (alignbytes.U):
        This variable holds the number of bytes required to align a
-       double. Usual values are 2, 4 and 8.
+       double-- or a long double when applicable. Usual values are
+       2, 4 and 8.  The default is eight, for safety.
 
 ansi2knr (ansi2knr.U):
        This variable is set if the user needs to run ansi2knr.  
@@ -37,17 +44,52 @@ 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.
+api_revision (patchlevel.U):
+       The three variables, api_revision, api_version, and
+       api_subversion, specify the version of the oldest perl binary
+       compatible with the present perl.  In a full version string
+       such as '5.6.1', api_revision is the '5'.
+       Prior to 5.5.640, the format was a floating point number,
+       like 5.00563.
+               perl.c:incpush() and lib/lib.pm will automatically search in
+       $sitelib/.. for older directories back to the limit specified
+       by these api_ variables.  This is only useful if you have a
+       perl library directory tree structured like the default one.
+       See INSTALL for how this works.  The versioned site_perl
+       directory was introduced in 5.005, so that is the lowest
+       possible value.  The version list appropriate for the current
+       system is determined in inc_version_list.U.
+               XXX To do:  Since compatibility can depend on compile time
+       options (such as bincompat, longlong, etc.) it should
+       (perhaps) be set by Configure, but currently it isn't.
+       Currently, we read a hard-wired value from patchlevel.h.
+       Perhaps what we ought to do is take the hard-wired value from
+       patchlevel.h but then modify it if the current Configure
+       options warrant.  patchlevel.h then would use an #ifdef guard.
+
+api_subversion (patchlevel.U):
+       The three variables, api_revision, api_version, and
+       api_subversion, specify the version of the oldest perl binary
+       compatible with the present perl.  In a full version string
+       such as '5.6.1', api_subversion is the '1'.  See api_revision for
+       full details.
+
+api_version (patchlevel.U):
+       The three variables, api_revision, api_version, and
+       api_subversion, specify the version of the oldest perl binary
+       compatible with the present perl.  In a full version string
+       such as '5.6.1', api_version is the '6'.  See api_revision for
+       full details.  As a special case, 5.5.0 is rendered in the
+       old-style as 5.005.  (In the 5.005_0x maintenance series,
+       this was the only versioned directory in $sitelib.)
+
+api_versionstring (patchlevel.U):
+       This variable combines api_revision, api_version, and
+       api_subversion in a format such as 5.6.1 (or 5_6_1) suitable
+       for use as a directory name.  This is filesystem dependent.
 
 ar (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -77,7 +119,7 @@ archobjs (Unix.U):
        include os2/os2.obj.
 
 awk (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -95,19 +137,20 @@ bin (bin.U):
        this variable must be prepared to deal with ~name substitution.
 
 bincompat5005 (bincompat5005.U):
-       This variable contains y if Perl 5.006 should be binary-compatible
-       with Perl 5.005.
+       This variable contains y if this version of Perl should be
+       binary-compatible with Perl 5.005.
 
 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.
+       This variable is used internally by Configure to determine the
+       full pathname (if any) of the bison program.  After Configure runs,
+       the value is reset to a plain "bison" and is not useful.
 
 byacc (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -131,14 +174,15 @@ castflags (d_castneg.U):
        4 = couldn't cast in argument expression list
 
 cat (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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' and 'gcc'.
+       Fervent ANSI compilers may be called 'c89'.  AIX has xlc.
 
 cccdlflags (dlsrc.U):
        This variable contains any special flags that might need to be
@@ -156,12 +200,28 @@ ccflags (ccflags.U):
        This variable contains any additional C compiler flags desired by
        the user.  It is up to the Makefile to use this.
 
+ccflags_uselargefiles (uselfs.U):
+       This variable contains the compiler flags needed by large file builds
+       and added to ccflags by hints files.
+
+ccname (Checkcc.U):
+       This can set either by hints files or by Configure.  If using
+       gcc, this is gcc, and if not, usually equal to cc, unimpressive, no?
+       Some platforms, however, make good use of this by storing the
+       flavor of the C compiler being used here.  For example if using
+       the Sun WorkShop suite, ccname will be 'workshop'.
+
 ccsymbols (Cppsym.U):
        The variable contains the symbols defined by the C compiler alone.
        The symbols defined by cpp or by cc when it calls cpp are not in
        this list, see cppsymbols and cppccsymbols.
        The list is a space-separated list of symbol=value tokens.
 
+ccversion (Checkcc.U):
+       This can set either by hints files or by Configure.  If using
+       a (non-gcc) vendor cc, this variable may contain a version for
+       the compiler.
+
 cf_by (cf_who.U):
        Login name of the person who ran the Configure script and answered the
        questions. This is used to tag both config.sh and config_h.SH.
@@ -174,6 +234,10 @@ 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.
 
+charsize (charsize.U):
+       This variable contains the value of the CHARSIZE symbol, which
+       indicates to the C program how many bytes there are in a character.
+
 chgrp (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
@@ -192,7 +256,7 @@ clocktype (d_times.U):
        included).
 
 comm (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -207,7 +271,7 @@ contains (contains.U):
        is primarily for the use of other Configure units.
 
 cp (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -216,7 +280,7 @@ cpio (Loc.U):
        The value is a plain '' and is not useful.
 
 cpp (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -225,7 +289,7 @@ cpp_stuff (cpp_stuff.U):
        used by the C preprocessor.
 
 cppccsymbols (Cppsym.U):
-       The variable contains the symbols defined by the C compiler when
+       The variable contains the symbols defined by the C compiler
        when it calls cpp.  The symbols defined by the cc alone or cpp
        alone are not in this list, see ccsymbols and cppsymbols.
        The list is a space-separated list of symbol=value tokens.
@@ -264,21 +328,20 @@ cppsymbols (Cppsym.U):
        not in this list, see ccsymbols and cppccsymbols.
        The list is a space-separated list of symbol=value tokens.
 
-crosscompile (crosscompile.U):
-       This variable conditionally defines the CROSSCOMPILE symbol
-       which signifies that the build process is be a cross-compilation.
-       This is normally set by hints files or from Configure command line.
-
 cryptlib (d_crypt.U):
        This variable holds -lcrypt or the path to a libcrypt.a archive if
        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
+       This variable is 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__fwalk (d__fwalk.U):
+       This variable conditionally defines HAS__FWALK if _fwalk() is
+       available to apply a function to all the file handles.
+
 d_access (d_access.U):
        This variable conditionally defines HAS_ACCESS if the access() system
        call is available to check for access permissions using real IDs.
@@ -319,9 +382,10 @@ d_bcopy (d_bcopy.U):
 
 d_bincompat5005 (bincompat5005.U):
        This variable conditionally defines BINCOMPAT5005 so that embed.h
-       can take special action if Perl 5.006 should be binary-compatible
-       with Perl 5.005.  This is impossible for builds that use features
-       like threads and multiplicity it is always $undef for those versions.
+       can take special action if this version of Perl should be
+       binary-compatible with Perl 5.005.  This is impossible for builds
+       that use features like threads and multiplicity it is always $undef
+       for those versions.
 
 d_bsd (Guess.U):
        This symbol conditionally defines the symbol BSD when running on a
@@ -370,9 +434,9 @@ d_closedir (d_closedir.U):
        This variable conditionally defines HAS_CLOSEDIR if closedir() is
        available.
 
-d_cmsghdr_s (d_socket.U):
+d_cmsghdr_s (d_cmsghdr_s.U):
        This variable conditionally defines the HAS_STRUCT_CMSGHDR symbol,
-       which indicates that the the struct cmsghdr is supported.
+       which indicates that the struct cmsghdr is supported.
 
 d_const (d_const.U):
        This variable conditionally defines the HASCONST symbol, which
@@ -398,6 +462,12 @@ d_dbl_dig (d_dbl_dig.U):
        header files provide DBL_DIG, which is the number of significant
        digits in a double precision number.
 
+d_dbminitproto (d_dbminitproto.U):
+       This variable conditionally defines the HAS_DBMINIT_PROTO symbol,
+       which indicates to the C program that the system provides
+       a prototype for the dbminit() function.  Otherwise, it is
+       up to the program to supply one.
+
 d_difftime (d_difftime.U):
        This variable conditionally defines the HAS_DIFFTIME symbol, which
        indicates to the C program that the difftime() routine is available.
@@ -465,10 +535,6 @@ 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_endspent (d_endspent.U):
-       This variable conditionally defines HAS_ENDSPENT if endspent() is
-       available to finalize the scan of SysV shadow password entries.
-
 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.
@@ -491,6 +557,10 @@ d_fcntl (d_fcntl.U):
        This variable conditionally defines the HAS_FCNTL symbol, and indicates
        whether the fcntl() function exists
 
+d_fcntl_can_lock (d_fcntl_can_lock.U):
+       This variable conditionally defines the FCNTL_CAN_LOCK symbol
+       and indicates whether file locking with fcntl() works.
+
 d_fd_macros (d_fd_set.U):
        This variable contains the eventual value of the HAS_FD_MACROS symbol,
        which indicates if your C compiler knows about the macros which
@@ -519,6 +589,12 @@ d_flock (d_flock.U):
        This variable conditionally defines HAS_FLOCK if flock() is
        available to do file locking.
 
+d_flockproto (d_flockproto.U):
+       This variable conditionally defines the HAS_FLOCK_PROTO symbol,
+       which indicates to the C program that the system provides
+       a prototype for the flock() function.  Otherwise, it is
+       up to the program to supply one.
+
 d_fork (d_fork.U):
        This variable conditionally defines the HAS_FORK symbol, which
        indicates to the C program that the fork() routine is available.
@@ -529,9 +605,17 @@ d_fpathconf (d_pathconf.U):
        to determine file-system related limits and options associated
        with a given open file descriptor.
 
-d_fpos64_t (io64.U):
+d_fpos64_t (d_fpos64_t.U):
        This symbol will be defined if the C compiler supports fpos64_t.
 
+d_frexpl (d_frexpl.U):
+       This variable conditionally defines the HAS_FREXPL symbol, which
+       indicates to the C program that the frexpl() routine is available.
+
+d_fs_data_s (d_fs_data_s.U):
+       This variable conditionally defines the HAS_STRUCT_FS_DATA symbol,
+       which indicates that the struct fs_data is supported.
+
 d_fseeko (d_fseeko.U):
        This variable conditionally defines the HAS_FSEEKO symbol, which
        indicates to the C program that the fseeko() routine is available.
@@ -540,7 +624,7 @@ d_fsetpos (d_fsetpos.U):
        This variable conditionally defines HAS_FSETPOS if fsetpos() is
        available to set the file position indicator.
 
-d_fstatfs (d_statfs.U):
+d_fstatfs (d_fstatfs.U):
        This variable conditionally defines the HAS_FSTATFS symbol, which
        indicates to the C program that the fstatfs() routine is available.
 
@@ -548,6 +632,10 @@ d_fstatvfs (d_statvfs.U):
        This variable conditionally defines the HAS_FSTATVFS symbol, which
        indicates to the C program that the fstatvfs() routine is available.
 
+d_fsync (d_fsync.U):
+       This variable conditionally defines the HAS_FSYNC symbol, which
+       indicates to the C program that the fsync() routine is available.
+
 d_ftello (d_ftello.U):
        This variable conditionally defines the HAS_FTELLO symbol, which
        indicates to the C program that the ftello() routine is available.
@@ -566,6 +654,19 @@ d_Gconvert (d_gconvert.U):
        d_Gconvert='gcvt((x),(n),(b))'
        d_Gconvert='sprintf((b),"%.*g",(n),(x))'
 
+d_getcwd (d_getcwd.U):
+       This variable conditionally defines the HAS_GETCWD symbol, which
+       indicates to the C program that the getcwd() routine is available
+       to get the current working directory.
+
+d_getespwnam (d_getespwnam.U):
+       This variable conditionally defines HAS_GETESPWNAM if getespwnam() is
+       available to retrieve enchanced (shadow) password entries by name.
+
+d_getfsstat (d_getfsstat.U):
+       This variable conditionally defines the HAS_GETFSSTAT symbol, which
+       indicates to the C program that the getfsstat() routine is available.
+
 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
@@ -601,15 +702,24 @@ d_gethostprotos (d_gethostprotos.U):
        prototypes for the various gethost*() functions.  
        See also netdbtype.U for probing for various netdb types.
 
+d_getitimer (d_getitimer.U):
+       This variable conditionally defines the HAS_GETITIMER symbol, which
+       indicates to the C program that the getitimer() routine is available.
+
 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
        to get the login name.
 
+d_getmnt (d_getmnt.U):
+       This variable conditionally defines the HAS_GETMNT symbol, which
+       indicates to the C program that the getmnt() routine is available
+       to retrieve one or more mount info blocks by filename.
+
 d_getmntent (d_getmntent.U):
        This variable conditionally defines the HAS_GETMNTENT symbol, which
        indicates to the C program that the getmntent() routine is available
-       to iterate through mounted files.
+       to iterate through mounted files to get their mount info.
 
 d_getnbyaddr (d_getnbyad.U):
        This variable conditionally defines the HAS_GETNETBYADDR symbol, which
@@ -631,6 +741,10 @@ d_getnetprotos (d_getnetprotos.U):
        prototypes for the various getnet*() functions.  
        See also netdbtype.U for probing for various netdb types.
 
+d_getpagsz (d_getpagsz.U):
+       This variable conditionally defines HAS_GETPAGESIZE if getpagesize()
+       is available to get the system page size.
+
 d_getpbyname (d_getprotby.U):
        This variable conditionally defines the HAS_GETPROTOBYNAME 
        symbol, which indicates to the C program that the 
@@ -676,6 +790,10 @@ d_getprotoprotos (d_getprotoprotos.U):
        prototypes for the various getproto*() functions.  
        See also netdbtype.U for probing for various netdb types.
 
+d_getprpwnam (d_getprpwnam.U):
+       This variable conditionally defines HAS_GETPRPWNAM if getprpwnam() is
+       available to retrieve protected (shadow) password entries by name.
+
 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
@@ -703,10 +821,6 @@ d_getservprotos (d_getservprotos.U):
        prototypes for the various getserv*() functions.  
        See also netdbtype.U for probing for various netdb types.
 
-d_getspent (d_getspent.U):
-       This variable conditionally defines HAS_GETSPENT if getspent() is
-       available to retrieve SysV shadow password entries sequentially.
-
 d_getspnam (d_getspnam.U):
        This variable conditionally defines HAS_GETSPNAM if getspnam() is
        available to retrieve SysV shadow password entries by name.
@@ -732,6 +846,10 @@ d_htonl (d_htonl.U):
        This variable conditionally defines HAS_HTONL if htonl() and its
        friends are available to do network order byte swapping.
 
+d_iconv (d_iconv.U):
+       This variable conditionally defines the HAS_ICONV symbol, which
+       indicates to the C program that the iconv() routine is available.
+
 d_index (d_strchr.U):
        This variable conditionally defines HAS_INDEX if index() and
        rindex() are available for string searching.
@@ -741,17 +859,21 @@ d_inetaton (d_inetaton.U):
        indicates to the C program that the inet_aton() function is available
        to parse IP address "dotted-quad" strings.
 
-d_int64t (i_inttypes.U):
+d_int64_t (d_int64_t.U):
        This symbol will be defined if the C compiler supports int64_t.
 
-d_iovec_s (i_sysuio.U):
-       This variable conditionally defines the HAS_STRUCT_IOVEC symbol,
-       which indicates that the struct iovec is supported.
-
 d_isascii (d_isascii.U):
        This variable conditionally defines the HAS_ISASCII constant,
        which indicates to the C program that isascii() is available.
 
+d_isnan (d_isnan.U):
+       This variable conditionally defines the HAS_ISNAN symbol, which
+       indicates to the C program that the isnan() routine is available.
+
+d_isnanl (d_isnanl.U):
+       This variable conditionally defines the HAS_ISNANL symbol, which
+       indicates to the C program that the isnanl() routine is available.
+
 d_killpg (d_killpg.U):
        This variable conditionally defines the HAS_KILLPG symbol, which
        indicates to the C program that the killpg() routine is available
@@ -771,10 +893,6 @@ d_link (d_link.U):
        This variable conditionally defines HAS_LINK if link() is
        available to create hard links.
 
-d_llseek (io64.U):
-       This variable conditionally defines the HAS_LLSEEK symbol, which
-       indicates to the C program that the llseek() routine is available.
-
 d_locconv (d_locconv.U):
        This variable conditionally defines HAS_LOCALECONV if localeconv() is
        available for numeric and monetary formatting conventions.
@@ -791,6 +909,12 @@ d_longlong (d_longlong.U):
        This variable conditionally defines HAS_LONG_LONG if 
        the long long type is supported.
 
+d_lseekproto (d_lseekproto.U):
+       This variable conditionally defines the HAS_LSEEK_PROTO symbol,
+       which indicates to the C program that the system provides
+       a prototype for the lseek() function.  Otherwise, it is
+       up to the program to supply one.
+
 d_lstat (d_lstat.U):
        This variable conditionally defines HAS_LSTAT if lstat() is
        available to do file stats on symbolic links.
@@ -844,10 +968,26 @@ d_mkdir (d_mkdir.U):
        indicates to the C program that the mkdir() routine is available
        to create directories..
 
+d_mkdtemp (d_mkdtemp.U):
+       This variable conditionally defines the HAS_MKDTEMP symbol, which
+       indicates to the C program that the mkdtemp() routine is available
+       to exclusively create a uniquely named temporary directory.
+
 d_mkfifo (d_mkfifo.U):
        This variable conditionally defines the HAS_MKFIFO symbol, which
        indicates to the C program that the mkfifo() routine is available.
 
+d_mkstemp (d_mkstemp.U):
+       This variable conditionally defines the HAS_MKSTEMP symbol, which
+       indicates to the C program that the mkstemp() routine is available
+       to exclusively create and open a uniquely named temporary file.
+
+d_mkstemps (d_mkstemps.U):
+       This variable conditionally defines the HAS_MKSTEMPS symbol, which
+       indicates to the C program that the mkstemps() routine is available
+       to exclusively create and open a uniquely named (with a suffix)
+       temporary file.
+
 d_mktime (d_mktime.U):
        This variable conditionally defines the HAS_MKTIME symbol, which
        indicates to the C program that the mktime() routine is available.
@@ -856,6 +996,17 @@ d_mmap (d_mmap.U):
        This variable conditionally defines HAS_MMAP if mmap() is
        available to map a file into memory.
 
+d_modfl (d_modfl.U):
+       This variable conditionally defines the HAS_MODFL symbol, which
+       indicates to the C program that the modfl() routine is available.
+
+d_modfl_pow32_bug (d_modfl.U):
+       This variable conditionally defines the HAS_MODFL_POW32_BUG symbol,
+       which indicates that modfl() is broken for long doubles >= pow(2, 32).
+       For example from 4294967303.150000 one would get 4294967302.000000
+       and 1.150000.  The bug has been seen in certain versions of glibc,
+       release 2.2.2 is known to be okay.
+
 d_mprotect (d_mprotect.U):
        This variable conditionally defines HAS_MPROTECT if mprotect() is
        available to modify the access protection of a memory mapped file.
@@ -897,7 +1048,7 @@ d_msgget (d_msgget.U):
        This variable conditionally defines the HAS_MSGGET symbol, which
        indicates to the C program that the msgget() routine is available.
 
-d_msghdr_s (d_socket.U):
+d_msghdr_s (d_msghdr_s.U):
        This variable conditionally defines the HAS_STRUCT_MSGHDR symbol,
        which indicates that the struct msghdr is supported.
 
@@ -926,7 +1077,15 @@ d_nice (d_nice.U):
        This variable conditionally defines the HAS_NICE symbol, which
        indicates to the C program that the nice() routine is available.
 
-d_off64_t (io64.U):
+d_nv_preserves_uv (perlxv.U):
+       This variable indicates whether a variable of type nvtype
+       can preserve all the bits a variable of type uvtype.
+
+d_nv_preserves_uv_bits (perlxv.U):
+       This variable indicates how many of bits type uvtype
+       a variable nvtype can preserve.
+
+d_off64_t (d_off64_t.U):
        This symbol will be defined if the C compiler supports off64_t.
 
 d_old_pthread_create_joinable (d_pthrattrj.U):
@@ -959,6 +1118,11 @@ d_pause (d_pause.U):
        indicates to the C program that the pause() routine is available
        to suspend a process until a signal is received.
 
+d_perl_otherlibdirs (otherlibdirs.U):
+       This variable conditionally defines PERL_OTHERLIBDIRS, which
+       contains a colon-separated set of paths for the perl binary to
+       include in @INC.  See also otherlibdirs.
+
 d_phostname (d_gethname.U):
        This variable conditionally defines the HAS_PHOSTNAME symbol, which
        contains the shell command which, when fed to popen(), may be
@@ -984,28 +1148,34 @@ d_PRId64 (quadfio.U):
        indiciates that stdio has a symbol to print 64-bit decimal numbers.
 
 d_PRIeldbl (longdblfio.U):
-       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+       This variable conditionally defines the PERL_PRIfldbl symbol, which
        indiciates that stdio has a symbol to print long doubles.
 
-d_PRIEldbl (longdblfio.U):
-       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+d_PRIEUldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldbl symbol, which
        indiciates that stdio has a symbol to print long doubles.
+       The 'U' in the name is to separate this from d_PRIeldbl so that even
+       case-blind systems can see the difference.
 
 d_PRIfldbl (longdblfio.U):
-       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+       This variable conditionally defines the PERL_PRIfldbl symbol, which
        indiciates that stdio has a symbol to print long doubles.
 
-d_PRIFldbl (longdblfio.U):
-       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+d_PRIFUldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldbl symbol, which
        indiciates that stdio has a symbol to print long doubles.
+       The 'U' in the name is to separate this from d_PRIfldbl so that even
+       case-blind systems can see the difference.
 
 d_PRIgldbl (longdblfio.U):
-       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+       This variable conditionally defines the PERL_PRIfldbl symbol, which
        indiciates that stdio has a symbol to print long doubles.
 
-d_PRIGldbl (longdblfio.U):
-       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+d_PRIGUldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldbl symbol, which
        indiciates that stdio has a symbol to print long doubles.
+       The 'U' in the name is to separate this from d_PRIgldbl so that even
+       case-blind systems can see the difference.
 
 d_PRIi64 (quadfio.U):
        This variable conditionally defines the PERL_PRIi64 symbol, which
@@ -1024,9 +1194,11 @@ d_PRIx64 (quadfio.U):
        This variable conditionally defines the PERL_PRIx64 symbol, which
        indiciates that stdio has a symbol to print 64-bit hexadecimal numbers.
 
-d_PRIX64 (quadfio.U):
-       This variable conditionally defines the PERL_PRIX64 symbol, which
+d_PRIXU64 (quadfio.U):
+       This variable conditionally defines the PERL_PRIXU64 symbol, which
        indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers.
+       The 'U' in the name is to separate this from d_PRIx64 so that even
+       case-blind systems can see the difference.
 
 d_pthread_yield (d_pthread_y.U):
        This variable conditionally defines the HAS_PTHREAD_YIELD
@@ -1065,6 +1237,14 @@ d_pwquota (i_pwd.U):
        This variable conditionally defines PWQUOTA, which indicates
        that struct passwd contains pw_quota.
 
+d_qgcvt (d_qgcvt.U):
+       This variable conditionally defines the HAS_QGCVT symbol, which
+       indicates to the C program that the qgcvt() routine is available.
+
+d_quad (quadtype.U):
+       This variable, if defined, tells that there's a 64-bit integer type,
+       quadtype.
+
 d_readdir (d_readdir.U):
        This variable conditionally defines HAS_READDIR if readdir() is
        available to read directory entries.
@@ -1078,9 +1258,13 @@ d_readv (d_readv.U):
        This variable conditionally defines the HAS_READV symbol, which
        indicates to the C program that the readv() routine is available.
 
-d_recvmsg (d_socket.U):
-       This variable conditionally defines the HAS_RECVMSG symbol,
-       which indicates that the recvmsg is supported.
+d_realpath (d_realpath.U):
+       This variable conditionally defines the HAS_REALPATH symbol, which
+       indicates to the C program that the realpath() routine is available.
+
+d_recvmsg (d_recvmsg.U):
+       This variable conditionally defines the HAS_RECVMSG symbol, which
+       indicates to the C program that the recvmsg() routine is available.
 
 d_rename (d_rename.U):
        This variable conditionally defines the HAS_RENAME symbol, which
@@ -1108,6 +1292,12 @@ d_sanemcmp (d_sanemcmp.U):
        the memcpy() routine is available and can be used to compare relative
        magnitudes of chars with their high bits set.
 
+d_sbrkproto (d_sbrkproto.U):
+       This variable conditionally defines the HAS_SBRK_PROTO symbol,
+       which indicates to the C program that the system provides
+       a prototype for the sbrk() function.  Otherwise, it is
+       up to the program to supply one.
+
 d_sched_yield (d_pthread_y.U):
        This variable conditionally defines the HAS_SCHED_YIELD
        symbol if the sched_yield routine is available to yield
@@ -1118,6 +1308,10 @@ d_scm_rights (d_socket.U):
        which indicates that the SCM_RIGHTS is available.  #ifdef is
        not enough because it may be an enum, glibc has been known to do this.
 
+d_SCNfldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldbl symbol, which
+       indiciates that stdio has a symbol to scan long doubles.
+
 d_seekdir (d_readdir.U):
        This variable conditionally defines HAS_SEEKDIR if seekdir() is
        available.
@@ -1151,9 +1345,9 @@ d_semop (d_semop.U):
        This variable conditionally defines the HAS_SEMOP symbol, which
        indicates to the C program that the semop() routine is available.
 
-d_sendmsg (d_socket.U):
-       This variable conditionally defines the HAS_SENDMSG symbol,
-       which indicates that the sendmsg is supported.
+d_sendmsg (d_sendmsg.U):
+       This variable conditionally defines the HAS_SENDMSG symbol, which
+       indicates to the C program that the sendmsg() routine is available.
 
 d_setegid (d_setegid.U):
        This variable conditionally defines the HAS_SETEGID symbol, which
@@ -1179,6 +1373,10 @@ d_sethent (d_sethent.U):
        This variable conditionally defines HAS_SETHOSTENT if sethostent() is
        available.
 
+d_setitimer (d_setitimer.U):
+       This variable conditionally defines the HAS_SETITIMER symbol, which
+       indicates to the C program that the setitimer() routine is available.
+
 d_setlinebuf (d_setlnbuf.U):
        This variable conditionally defines the HAS_SETLINEBUF symbol, which
        indicates to the C program that the setlinebuf() routine is available
@@ -1214,6 +1412,11 @@ d_setprior (d_setprior.U):
        This variable conditionally defines HAS_SETPRIORITY if setpriority()
        is available to set a process's priority.
 
+d_setproctitle (d_setproctitle.U):
+       This variable conditionally defines the HAS_SETPROCTITLE symbol,
+       which indicates to the C program that the setproctitle() routine
+       is available.
+
 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
@@ -1257,10 +1460,6 @@ d_setsid (d_setsid.U):
        This variable conditionally defines HAS_SETSID if setsid() is
        available to set the process group ID.
 
-d_setspent (d_setspent.U):
-       This variable conditionally defines HAS_SETSPENT if setspent() is
-       available to initialize the scan of SysV shadow password entries.
-
 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
@@ -1299,34 +1498,72 @@ d_sigaction (d_sigaction.U):
        This variable conditionally defines the HAS_SIGACTION symbol, which
        indicates that the Vr4 sigaction() routine is available.
 
+d_sigprocmask (d_sigprocmask.U):
+       This variable conditionally defines HAS_SIGPROCMASK
+       if sigprocmask() is available to examine or change the signal mask
+       of the calling process.
+
 d_sigsetjmp (d_sigsetjmp.U):
        This variable conditionally defines the HAS_SIGSETJMP symbol,
        which indicates that the sigsetjmp() routine is available to
        call setjmp() and optionally save the process's signal mask.
 
+d_sockatmark (d_sockatmark.U):
+       This variable conditionally defines the HAS_SOCKATMARK symbol, which
+       indicates to the C program that the sockatmark() routine is available.
+
+d_sockatmarkproto (d_sockatmarkproto.U):
+       This variable conditionally defines the HAS_SOCKATMARK_PROTO symbol,
+       which indicates to the C program that the system provides
+       a prototype for the sockatmark() function.  Otherwise, it is
+       up to the program to supply one.
+
 d_socket (d_socket.U):
        This variable conditionally defines HAS_SOCKET, which indicates
        that the BSD socket interface is supported.
 
+d_socklen_t (d_socklen_t.U):
+       This symbol will be defined if the C compiler supports socklen_t.
+
 d_sockpair (d_socket.U):
        This variable conditionally defines the HAS_SOCKETPAIR symbol, which
        indicates that the BSD socketpair() is supported.
 
+d_socks5_init (d_socks5_init.U):
+       This variable conditionally defines the HAS_SOCKS5_INIT symbol, which
+       indicates to the C program that the socks5_init() routine is available.
+
+d_sqrtl (d_sqrtl.U):
+       This variable conditionally defines the HAS_SQRTL symbol, which
+       indicates to the C program that the sqrtl() routine is available.
+
+d_sresgproto (d_sresgproto.U):
+       This variable conditionally defines the HAS_SETRESGID_PROTO symbol,
+       which indicates to the C program that the system provides
+       a prototype for the setresgid() function.  Otherwise, it is
+       up to the program to supply one.
+
+d_sresuproto (d_sresuproto.U):
+       This variable conditionally defines the HAS_SETRESUID_PROTO symbol,
+       which indicates to the C program that the system provides
+       a prototype for the setresuid() function.  Otherwise, it is
+       up to the program to supply one.
+
 d_statblks (d_statblks.U):
        This variable conditionally defines USE_STAT_BLOCKS
        if this system has a stat structure declaring
        st_blksize and st_blocks.
 
-d_statfs (d_statfs.U):
-       This variable conditionally defines the HAS_STATFS symbol, which
-       indicates to the C program that the statfs() routine is available.
-
-d_statfsflags (d_statfs.U):
-       This variable conditionally defines the HAS_STRUCT_STATFS_FLAGS
+d_statfs_f_flags (d_statfs_f_flags.U):
+       This variable conditionally defines the HAS_STRUCT_STATFS_F_FLAGS
        symbol, which indicates to struct statfs from has f_flags member.
        This kind of struct statfs is coming from sys/mount.h (BSD),
        not from sys/statfs.h (SYSV).
 
+d_statfs_s (d_statfs_s.U):
+       This variable conditionally defines the HAS_STRUCT_STATFS symbol,
+       which indicates that the struct statfs is supported.
+
 d_statvfs (d_statvfs.U):
        This variable conditionally defines the HAS_STATVFS symbol, which
        indicates to the C program that the statvfs() routine is available.
@@ -1339,6 +1576,15 @@ d_stdio_ptr_lval (d_stdstdio.U):
        This variable conditionally defines STDIO_PTR_LVALUE if the
        FILE_ptr macro can be used as an lvalue.
 
+d_stdio_ptr_lval_nochange_cnt (d_stdstdio.U):
+       This symbol is defined if using the FILE_ptr macro as an lvalue
+       to increase the pointer by n leaves File_cnt(fp) unchanged.
+
+d_stdio_ptr_lval_sets_cnt (d_stdstdio.U):
+       This symbol is defined if using the FILE_ptr macro as an lvalue
+       to increase the pointer by n has the side effect of decreasing the
+       value of File_cnt(fp) by n.
+
 d_stdio_stream_array (stdio_streams.U):
        This variable tells whether there is an array holding
        the stdio streams.
@@ -1376,6 +1622,10 @@ d_strerror (d_strerror.U):
        This variable conditionally defines HAS_STRERROR if strerror() is
        available to translate error numbers to strings.
 
+d_strftime (d_strftime.U):
+       This variable conditionally defines the HAS_STRFTIME symbol, which
+       indicates to the C program that the strftime() routine is available.
+
 d_strtod (d_strtod.U):
        This variable conditionally defines the HAS_STRTOD symbol, which
        indicates to the C program that the strtod() routine is available
@@ -1386,15 +1636,31 @@ d_strtol (d_strtol.U):
        indicates to the C program that the strtol() routine is available
        to provide better numeric string conversion than atoi() and friends.
 
+d_strtold (d_strtold.U):
+       This variable conditionally defines the HAS_STRTOLD symbol, which
+       indicates to the C program that the strtold() routine is available.
+
+d_strtoll (d_strtoll.U):
+       This variable conditionally defines the HAS_STRTOLL symbol, which
+       indicates to the C program that the strtoll() routine is available.
+
+d_strtoq (d_strtoq.U):
+       This variable conditionally defines the HAS_STRTOQ symbol, which
+       indicates to the C program that the strtoq() routine is available.
+
 d_strtoul (d_strtoul.U):
        This variable conditionally defines the HAS_STRTOUL symbol, which
        indicates to the C program that the strtoul() routine is available
        to provide conversion of strings to unsigned long.
 
-d_strtoull (strtoull.U):
+d_strtoull (d_strtoull.U):
        This variable conditionally defines the HAS_STRTOULL symbol, which
        indicates to the C program that the strtoull() routine is available.
 
+d_strtouq (d_strtouq.U):
+       This variable conditionally defines the HAS_STRTOUQ symbol, which
+       indicates to the C program that the strtouq() routine is available.
+
 d_strxfrm (d_strxfrm.U):
        This variable conditionally defines HAS_STRXFRM if strxfrm() is
        available to transform strings.
@@ -1412,6 +1678,12 @@ d_syscall (d_syscall.U):
        This variable conditionally defines HAS_SYSCALL if syscall() is
        available call arbitrary system calls.
 
+d_syscallproto (d_syscallproto.U):
+       This variable conditionally defines the HAS_SYSCALL_PROTO symbol,
+       which indicates to the C program that the system provides
+       a prototype for the syscall() function.  Otherwise, it is
+       up to the program to supply one.
+
 d_sysconf (d_sysconf.U):
        This variable conditionally defines the HAS_SYSCONF symbol, which
        indicates to the C program that the sysconf() routine is available
@@ -1467,6 +1739,14 @@ d_tzname (d_tzname.U):
        This variable conditionally defines HAS_TZNAME if tzname[] is
        available to access timezone names.
 
+d_u32align (d_u32align.U):
+       This variable tells whether you must access character data
+       through U32-aligned pointers.
+
+d_ualarm (d_ualarm.U):
+       This variable conditionally defines the HAS_UALARM symbol, which
+       indicates to the C program that the ualarm() routine is available.
+
 d_umask (d_umask.U):
        This variable conditionally defines the HAS_UMASK symbol, which
        indicates to the C program that the umask() routine is available.
@@ -1481,6 +1761,26 @@ d_union_semun (d_union_semun.U):
        This variable conditionally defines HAS_UNION_SEMUN if the
        union semun is defined by including <sys/sem.h>.
 
+d_usleep (d_usleep.U):
+       This variable conditionally defines HAS_USLEEP if usleep() is
+       available to do high granularity sleeps.
+
+d_usleepproto (d_usleepproto.U):
+       This variable conditionally defines the HAS_USLEEP_PROTO symbol,
+       which indicates to the C program that the system provides
+       a prototype for the usleep() function.  Otherwise, it is
+       up to the program to supply one.
+
+d_ustat (d_ustat.U):
+       This variable conditionally defines HAS_USTAT if ustat() is
+       available to query file system statistics by dev_t.
+
+d_vendorarch (vendorarch.U):
+       This variable conditionally defined PERL_VENDORARCH.
+
+d_vendorbin (vendorbin.U):
+       This variable conditionally defines PERL_VENDORBIN.
+
 d_vendorlib (vendorlib.U):
        This variable conditionally defines PERL_VENDORLIB.
 
@@ -1540,7 +1840,7 @@ d_xenix (Guess.U):
        the C program that it runs under Xenix.
 
 date (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -1554,6 +1854,20 @@ db_prefixtype (i_db.U):
        in the <db.h> header file.  In older versions of DB, it was
        int, while in newer ones it is size_t.
 
+db_version_major (i_db.U):
+       This variable contains the major version number of
+       Berkeley DB found in the <db.h> header file.
+
+db_version_minor (i_db.U):
+       This variable contains the minor version number of
+       Berkeley DB found in the <db.h> header file.
+       For DB version 1 this is always 0.
+
+db_version_patch (i_db.U):
+       This variable contains the patch version number of
+       Berkeley DB found in the <db.h> header file.
+       For DB version 1 this is always 0.
+
 defvoidused (voidflags.U):
        This variable contains the default value of the VOIDUSED symbol (15).
 
@@ -1597,12 +1911,12 @@ ebcdic (ebcdic.U):
        See trnl.U
 
 echo (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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
+       This variable is 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.
 
@@ -1619,7 +1933,7 @@ 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
+       This variable is 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.
 
@@ -1654,14 +1968,23 @@ flex (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
 
+fpossize (fpossize.U):
+       This variable contains the size of a fpostype in bytes.
+
 fpostype (fpostype.U):
-       This variable defines Fpos_t to be something like fpost_t, long, 
+       This variable defines Fpos_t to be something like fpos_t, long, 
        uint, or whatever type is used to declare file positions in libc.
 
 freetype (mallocsrc.U):
        This variable contains the return type of free().  It is usually
        void, but occasionally int.
 
+from (Cross.U):
+       This variable contains the command used by Configure
+       to copy files from the target host.  Useful and available
+       only during Perl build.
+       The string ':' if not cross-compiling.
+
 full_ar (Loc_ar.U):
        This variable contains the full pathname to 'ar', whether or
        not the user has specified 'portability'.  This is only used
@@ -1681,11 +2004,26 @@ full_sed (Loc_sed.U):
        can share this executable will have the same full pathname to
        'sed.'
 
-gccversion (cc.U):
+gccosandvers (gccvers.U):
+       If GNU cc (gcc) is used, this variable the operating system and
+       version used to compile the gcc.  It is set to '' if not gcc,
+       or if nothing useful can be parsed as the os version.
+
+gccversion (gccvers.U):
        If GNU cc (gcc) is used, this variable holds '1' or '2' to 
        indicate whether the compiler is version 1 or 2.  This is used in
        setting some of the default cflags.  It is set to '' if not gcc.
 
+gidformat (gidf.U):
+       This variable contains the format string used for printing a Gid_t.
+
+gidsign (gidsign.U):
+       This variable contains the signedness of a gidtype.
+       1 for unsigned, -1 for signed.
+
+gidsize (gidsize.U):
+       This variable contains the size of a gidtype in bytes.
+
 gidtype (gidtype.U):
        This variable defines Gid_t to be something like gid_t, int,
        ushort, or whatever type is used to declare the return type
@@ -1697,7 +2035,7 @@ glibpth (libpth.U):
        this platform, libpth is the cleaned-up version.
 
 grep (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -1705,6 +2043,8 @@ 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
        "ypcat group" when NIS is used.
+       On some systems, such as os390, there may be no equivalent
+       command, in which case this variable is unset.
 
 groupstype (groupstype.U):
        This variable defines Groups_t to be something like gid_t, int, 
@@ -1713,7 +2053,7 @@ groupstype (groupstype.U):
        gidtype (gid_t), but sometimes it isn't.
 
 gzip (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -1733,12 +2073,32 @@ hostcat (nis.U):
        This variable contains a command that produces the text of the
        /etc/hosts file.  This is normally "cat /etc/hosts", but can be
        "ypcat hosts" when NIS is used.
+       On some systems, such as os390, there may be no equivalent
+       command, in which case this variable is unset.
+
+i16size (perlxv.U):
+       This variable is the size of an I16 in bytes.
+
+i16type (perlxv.U):
+       This variable contains the C type used for Perl's I16.
+
+i32size (perlxv.U):
+       This variable is the size of an I32 in bytes.
+
+i32type (perlxv.U):
+       This variable contains the C type used for Perl's I32.
+
+i64size (perlxv.U):
+       This variable is the size of an I64 in bytes.
 
-huge (models.U):
-       This variable contains a flag which will tell the C compiler and loader
-       to produce a program running with a huge memory model.  If the
-       huge model is not supported, contains the flag to produce large
-       model programs.  It is up to the Makefile to use this.
+i64type (perlxv.U):
+       This variable contains the C type used for Perl's I64.
+
+i8size (perlxv.U):
+       This variable is the size of an I8 in bytes.
+
+i8type (perlxv.U):
+       This variable contains the C type used for Perl's I8.
 
 i_arpainet (i_arpainet.U):
        This variable conditionally defines the I_ARPA_INET symbol,
@@ -1790,10 +2150,22 @@ i_grp (i_grp.U):
        This variable conditionally defines the I_GRP symbol, and indicates
        whether a C program should include <grp.h>.
 
+i_iconv (i_iconv.U):
+       This variable conditionally defines the I_ICONV symbol, and indicates
+       whether a C program should include <iconv.h>.
+
+i_ieeefp (i_ieeefp.U):
+       This variable conditionally defines the I_IEEEFP symbol, and indicates
+       whether a C program should include <ieeefp.h>.
+
 i_inttypes (i_inttypes.U):
        This variable conditionally defines the I_INTTYPES symbol,
        and indicates whether a C program should include <inttypes.h>.
 
+i_libutil (i_libutil.U):
+       This variable conditionally defines the I_LIBUTIL symbol, and indicates
+       whether a C program should include <libutil.h>.
+
 i_limits (i_limits.U):
        This variable conditionally defines the I_LIMITS symbol, and indicates
        whether a C program may include <limits.h> to get symbols like WORD_BIT
@@ -1850,6 +2222,10 @@ i_poll (i_poll.U):
        This variable conditionally defines the I_POLL symbol, and indicates
        whether a C program should include <poll.h>.
 
+i_prot (i_prot.U):
+       This variable conditionally defines the I_PROT symbol, and indicates
+       whether a C program should include <prot.h>.
+
 i_pthread (i_pthread.U):
        This variable conditionally defines the I_PTHREAD symbol,
        and indicates whether a C program should include <pthread.h>.
@@ -1899,6 +2275,10 @@ i_string (i_string.U):
        This variable conditionally defines the I_STRING symbol, which
        indicates that <string.h> should be included rather than <strings.h>.
 
+i_sunmath (i_sunmath.U):
+       This variable conditionally defines the I_SUNMATH symbol, and indicates
+       whether a C program should include <sunmath.h>.
+
 i_sysaccess (i_sysaccess.U):
        This variable conditionally defines the I_SYS_ACCESS symbol,
        and indicates whether a C program should include <sys/access.h>.
@@ -1926,10 +2306,18 @@ i_sysioctl (i_sysioctl.U):
        indicates to the C program that <sys/ioctl.h> exists and should
        be included.
 
+i_syslog (i_syslog.U):
+       This variable conditionally defines the I_SYSLOG symbol,
+       and indicates whether a C program should include <syslog.h>.
+
 i_sysmman (i_sysmman.U):
        This variable conditionally defines the I_SYS_MMAN symbol, and
        indicates whether a C program should include <sys/mman.h>.
 
+i_sysmode (i_sysmode.U):
+       This variable conditionally defines the I_SYSMODE symbol,
+       and indicates whether a C program should include <sys/mode.h>.
+
 i_sysmount (i_sysmount.U):
        This variable conditionally defines the I_SYSMOUNT symbol,
        and indicates whether a C program should include <sys/mount.h>.
@@ -1964,6 +2352,10 @@ i_sysstat (i_sysstat.U):
        This variable conditionally defines the I_SYS_STAT symbol,
        and indicates whether a C program should include <sys/stat.h>.
 
+i_sysstatfs (i_sysstatfs.U):
+       This variable conditionally defines the I_SYSSTATFS symbol,
+       and indicates whether a C program should include <sys/statfs.h>.
+
 i_sysstatvfs (i_sysstatvfs.U):
        This variable conditionally defines the I_SYSSTATVFS symbol,
        and indicates whether a C program should include <sys/statvfs.h>.
@@ -1994,6 +2386,14 @@ i_sysun (i_sysun.U):
        to the C program that it should include <sys/un.h> to get UNIX
        domain socket definitions.
 
+i_sysutsname (i_sysutsname.U):
+       This variable conditionally defines the I_SYSUTSNAME symbol,
+       and indicates whether a C program should include <sys/utsname.h>.
+
+i_sysvfs (i_sysvfs.U):
+       This variable conditionally defines the I_SYSVFS symbol,
+       and indicates whether a C program should include <sys/vfs.h>.
+
 i_syswait (i_syswait.U):
        This variable conditionally defines I_SYS_WAIT, which indicates
        to the C program that it should include <sys/wait.h>.
@@ -2016,6 +2416,10 @@ i_unistd (i_unistd.U):
        This variable conditionally defines the I_UNISTD symbol, and indicates
        whether a C program should include <unistd.h>.
 
+i_ustat (i_ustat.U):
+       This variable conditionally defines the I_USTAT symbol, and indicates
+       whether a C program should include <ustat.h>.
+
 i_utime (i_utime.U):
        This variable conditionally defines the I_UTIME symbol, and indicates
        whether a C program should include <utime.h>.
@@ -2042,6 +2446,21 @@ ignore_versioned_solibs (libs.U):
        libraries (libfoo.so.x.y) are to be ignored (because they
        cannot be linked against).
 
+inc_version_list (inc_version_list.U):
+       This variable specifies the list of subdirectories in over
+       which perl.c:incpush() and lib/lib.pm will automatically
+       search when adding directories to @INC.  The elements in
+       the list are separated by spaces.  This is only useful
+       if you have a perl library directory tree structured like the
+       default one.  See INSTALL for how this works.  The versioned
+       site_perl directory was introduced in 5.005, so that is the
+       lowest possible value.
+
+inc_version_list_init (inc_version_list.U):
+       This variable holds the same list as inc_version_list, but
+       each item is enclosed in double quotes and separated by commas, 
+       suitable for use in the PERL_INC_VERSION_LIST initialization.
+
 incpath (usrinc.U):
        This variable must preceed the normal include path to get hte
        right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
@@ -2100,6 +2519,11 @@ installsitearch (sitearch.U):
        those systems using AFS. For extra portability, only this variable
        should be used in makefiles.
 
+installsitebin (sitebin.U):
+       This variable is usually the same as sitebinexp, unless you are on
+       a system running AFS, in which case they may differ slightly. You
+       should always use this variable within your makefiles for portability.
+
 installsitelib (sitelib.U):
        This variable is really the same as sitelibexp but may differ on
        those systems using AFS. For extra portability, only this variable
@@ -2128,6 +2552,16 @@ installusrbinperl (instubperl.U):
        /usr/bin/perl in addition to
        $installbin/perl
 
+installvendorarch (vendorarch.U):
+       This variable is really the same as vendorarchexp but may differ on
+       those systems using AFS. For extra portability, only this variable
+       should be used in makefiles.
+
+installvendorbin (vendorbin.U):
+       This variable is really the same as vendorbinexp but may differ on
+       those systems using AFS. For extra portability, only this variable
+       should be used in makefiles.
+
 installvendorlib (vendorlib.U):
        This variable is really the same as vendorlibexp but may differ on
        those systems using AFS. For extra portability, only this variable
@@ -2137,6 +2571,21 @@ intsize (intsize.U):
        This variable contains the value of the INTSIZE symbol, which
        indicates to the C program how many bytes there are in an int.
 
+issymlink (issymlink.U):
+       This variable holds the test command to test for a symbolic link
+       (if they are supported).  Typical values include 'test -h' and
+       'test -L'.
+
+ivdformat (perlxvf.U):
+       This variable contains the format string used for printing
+       a Perl IV as a signed decimal integer. 
+
+ivsize (perlxv.U):
+       This variable is the size of an IV in bytes.
+
+ivtype (perlxv.U):
+       This variable contains the C type used for Perl's IV.
+
 known_extensions (Extensions.U):
        This variable holds a list of all XS extensions included in 
        the package.
@@ -2145,11 +2594,6 @@ 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
-       the Makefile to use this.
-
 ld (dlsrc.U):
        This variable indicates the program to be used to link
        libraries for dynamic loading.  On some systems, it is 'ld'.
@@ -2166,13 +2610,17 @@ ldflags (ccflags.U):
        This variable contains any additional C loader flags desired by
        the user.  It is up to the Makefile to use this.
 
+ldflags_uselargefiles (uselfs.U):
+       This variable contains the loader flags needed by large file builds
+       and added to ldflags by hints files.
+
 ldlibpthname (libperl.U):
        This variable holds the name of the shared library
        search path, often LD_LIBRARY_PATH.  To get an empty
        string, the hints file must set this to 'none'.
 
 less (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -2198,11 +2646,32 @@ libs (libs.U):
        This variable holds the additional libraries we want to use.
        It is up to the Makefile to deal with it.
 
+libsdirs (libs.U):
+       This variable holds the directory names aka dirnames of the libraries
+       we found and accepted, duplicates are removed.
+
+libsfiles (libs.U):
+       This variable holds the filenames aka basenames of the libraries
+       we found and accepted.
+
+libsfound (libs.U):
+       This variable holds the full pathnames of the libraries
+       we found and accepted.
+
+libspath (libs.U):
+       This variable holds the directory names probed for libraries.
+
 libswanted (Myinit.U):
        This variable holds a list of all the libraries we want to
        search.  The order is chosen to pick up the c library
        ahead of ucb or bsd libraries for SVR4.
 
+libswanted_uselargefiles (uselfs.U):
+       This variable contains the libraries needed by large file builds
+       and added to ldflags by hints files.  It is a space separated list
+       of the library names without the "lib" prefix or any suffix, just
+       like libswanted..
+
 line (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
@@ -2216,7 +2685,7 @@ lkflags (ccflags.U):
        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
+       This variable is 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.
 
@@ -2260,7 +2729,7 @@ lpr (Loc.U):
        The value is a plain '' and is not useful.
 
 ls (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -2283,7 +2752,7 @@ mailx (Loc.U):
        The value is a plain '' and is not useful.
 
 make (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -2344,22 +2813,16 @@ man3ext (man3dir.U):
        See man3dir.
 
 Mcc (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
-medium (models.U):
-       This variable contains a flag which will tell the C compiler and loader
-       to produce a program running with a medium memory model.  If the
-       medium model is not supported, contains the flag to produce large
-       model programs.  It is up to the Makefile to use this.
-
 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
+       This variable is 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.
 
@@ -2368,18 +2831,13 @@ mmaptype (d_mmap.U):
        (and simultaneously the type of the first argument).
        It can be 'void *' or 'caddr_t'.
 
-models (models.U):
-       This variable contains the list of memory models supported by this
-       system.  Possible component values are none, split, unsplit, small,
-       medium, large, and huge.  The component values are space separated.
-
 modetype (modetype.U):
        This variable defines modetype to be something like mode_t, 
        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
+       This variable is 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.
 
@@ -2419,6 +2877,15 @@ n (n.U):
        command to suppress newline.  Otherwise it is null.  Correct usage is
        $echo $n "prompt for a question: $c".
 
+need_va_copy (need_va_copy.U):
+       This symbol, if defined, indicates that the system stores
+       the variable argument list datatype, va_list, in a format
+       that cannot be copied by simple assignment, so that some
+       other means must be used when copying is required.
+       As such systems vary in their provision (or non-provision)
+       of copying mechanisms, handy.h defines a platform-
+       independent macro, Perl_va_copy(src, dst), to do the job.
+
 netdb_hlen_type (netdbtype.U):
        This variable holds the type used for the 2nd argument to
        gethostbyaddr().  Usually, this is int or size_t or unsigned.
@@ -2441,7 +2908,7 @@ netdb_net_type (netdbtype.U):
        This is only useful if you have getnetbyaddr(), naturally.
 
 nm (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -2461,10 +2928,40 @@ nonxs_ext (Extensions.U):
        in the package.  All of them will be built.
 
 nroff (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
+nveformat (perlxvf.U):
+       This variable contains the format string used for printing
+       a Perl NV using %e-ish floating point format.
+
+nvEUformat (perlxvf.U):
+       This variable contains the format string used for printing
+       a Perl NV using %E-ish floating point format.
+
+nvfformat (perlxvf.U):
+       This variable confains the format string used for printing
+       a Perl NV using %f-ish floating point format.
+
+nvFUformat (perlxvf.U):
+       This variable confains the format string used for printing
+       a Perl NV using %F-ish floating point format.
+
+nvgformat (perlxvf.U):
+       This variable contains the format string used for printing
+       a Perl NV using %g-ish floating point format.
+
+nvGUformat (perlxvf.U):
+       This variable contains the format string used for printing
+       a Perl NV using %G-ish floating point format.
+
+nvsize (perlxv.U):
+       This variable is the size of an NV in bytes.
+
+nvtype (perlxv.U):
+       This variable contains the C type used for Perl's NV.
+
 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
@@ -2505,6 +3002,16 @@ osvers (Oldconfig.U):
        same for this package, hints files might just be os_4.0 or
        os_4.1, etc., not keeping separate files for each little release.
 
+otherlibdirs (otherlibdirs.U):
+       This variable contains a colon-separated set of paths for the perl
+       binary to search for additional library files or modules.
+       These directories will be tacked to the end of @INC.
+       Perl will automatically search below each path for version-
+       and architecture-specific directories.  See inc_version_list
+       for more details.
+       A value of ' ' means 'none' and is used to preserve this value
+       for the next run through Configure.
+
 package (package.U):
        This variable contains the name of the package being constructed.
        It is primarily intended for the use of later Configure units.
@@ -2517,29 +3024,64 @@ passcat (nis.U):
        This variable contains a command that produces the text of the
        /etc/passwd file.  This is normally "cat /etc/passwd", but can be
        "ypcat passwd" when NIS is used.
+       On some systems, such as os390, there may be no equivalent
+       command, in which case this variable is unset.
 
 patchlevel (patchlevel.U):
        The patchlevel level of this package.
        The value of patchlevel comes from the patchlevel.h file.
+       In a version number such as 5.6.1, this is the "6".
+       In patchlevel.h, this is referred to as "PERL_VERSION".
 
 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.
 
+perl5 (perl5.U):
+       This variable contains the full path (if any) to a previously
+       installed perl5.005 or later suitable for running the script
+       to determine inc_version_list.
+
 perl (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
 
+perl_patchlevel (patchlevel.U):
+       This is the Perl patch level, a numeric change identifier,
+       as defined by whichever source code maintenance system
+       is used to maintain the patches; currently Perforce.
+       It does not correlate with the Perl version numbers or
+       the maintenance versus development dichotomy except
+       by also being increasing.
+
+PERL_REVISION (Oldsyms.U):
+       In a Perl version number such as 5.6.2, this is the 5.
+       This value is manually set in patchlevel.h
+
+PERL_SUBVERSION (Oldsyms.U):
+       In a Perl version number such as 5.6.2, this is the 2.
+       Values greater than 50 represent potentially unstable
+       development subversions.
+       This value is manually set in patchlevel.h
+
+PERL_VERSION (Oldsyms.U):
+       In a Perl version number such as 5.6.2, this is the 6.
+       This value is manually set in patchlevel.h
+
 perladmin (perladmin.U):
        Electronic mail address of the perl5 administrator.
 
+perllibs (End.U):
+       The list of libraries needed by Perl only (any libraries needed
+       by extensions only will by dropped, if using dynamic loading).
+
 perlpath (perlpath.U):
        This variable contains the eventual value of the PERLPATH symbol,
        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
+       This variable is 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.
 
@@ -2558,6 +3100,21 @@ plibpth (libpth.U):
        Its value is prepend to libpth. This variable takes care of special
        machines, like the mips.  Usually, it should be empty.
 
+pm_apiversion (xs_apiversion.U):
+       This variable contains the version of the oldest perl
+       compatible with the present perl.  (That is, pure perl modules
+       written for $pm_apiversion will still work for the current
+       version).  perl.c:incpush() and lib/lib.pm will automatically
+       search in $sitelib for older directories across major versions
+       back to pm_apiversion.  This is only useful if you have a perl
+       library directory tree structured like the default one.  The
+       versioned site_perl library was introduced in 5.005, so that's
+       the default setting for this variable.  It's hard to imagine
+       it changing before Perl6.  It is included here for symmetry
+       with xs_apiveprsion -- the searching algorithms will
+       (presumably) be similar.
+       See the INSTALL file for how this works.
+
 pmake (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
@@ -2595,6 +3152,14 @@ ptrsize (ptrsize.U):
        This variable contains the value of the PTRSIZE symbol, which
        indicates to the C program how many bytes there are in a pointer.
 
+quadkind (quadtype.U):
+       This variable, if defined, encodes the type of a quad:
+       1 = int, 2 = long, 3 = long long, 4 = int64_t.
+
+quadtype (quadtype.U):
+       This variable defines Quad_t to be something like long, int, 
+       long long, int64_t, or whatever type is used for 64-bit integers.
+
 randbits (randfunc.U):
        Indicates how many bits are produced by the function used to
        generate normalized random numbers.
@@ -2619,8 +3184,13 @@ rd_nodata (nblock_io.U):
        used, which is a shame because you cannot make the difference between
        no data and an EOF.. Sigh!
 
+revision (patchlevel.U):
+       The value of revision comes from the patchlevel.h file.
+       In a version number such as 5.6.1, this is the "5".
+       In patchlevel.h, this is referred to as "PERL_REVISION".
+
 rm (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -2628,6 +3198,12 @@ rmail (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
 
+run (Cross.U):
+       This variable contains the command used by Configure
+       to copy and execute a cross-compiled executable in the
+       target host.  Useful and available only during Perl build.
+       Empty string '' if not cross-compiling.
+
 runnm (usenm.U):
        This variable contains 'true' or 'false' depending whether the
        nm extraction should be performed or not, according to the value
@@ -2649,7 +3225,7 @@ scriptdirexp (scriptdir.U):
        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
+       This variable is 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.
 
@@ -2749,6 +3325,10 @@ sig_num_init (sig_name.U):
        below.  A "ZERO" is prepended to the list, and the list is 
        terminated with a plain 0.
 
+sig_size (sig_name.U):
+       This variable contains the number of elements of the sig_name
+       and sig_num arrays, excluding the final NULL entry.
+
 signal_t (d_voidsig.U):
        This variable holds the type of the signal handler (void or int).
 
@@ -2757,16 +3337,46 @@ sitearch (sitearch.U):
        which is the name of the private library for this package.  It may
        have a ~ on the front. It is up to the makefile to eventually create
        this directory while performing installation (with ~ substitution).
+       The standard distribution will put nothing in this directory.
+       After perl has been installed, users may install their own local
+       architecture-dependent modules in this directory with
+       MakeMaker Makefile.PL
+       or equivalent.  See INSTALL for details.
 
 sitearchexp (sitearch.U):
        This variable is the ~name expanded version of sitearch, so that you
        may use it directly in Makefiles or shell scripts.
 
+sitebin (sitebin.U):
+       This variable holds the name of the directory in which the user wants
+       to put add-on publicly executable files 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.
+       The standard distribution will put nothing in this directory.
+       After perl has been installed, users may install their own local
+       executables in this directory with
+       MakeMaker Makefile.PL
+       or equivalent.  See INSTALL for details.
+
+sitebinexp (sitebin.U):
+       This is the same as the sitebin variable, but is filename expanded at
+       configuration time, for use in your makefiles.
+
 sitelib (sitelib.U):
        This variable contains the eventual value of the SITELIB symbol,
        which is the name of the private library for this package.  It may
        have a ~ on the front. It is up to the makefile to eventually create
        this directory while performing installation (with ~ substitution).
+       The standard distribution will put nothing in this directory.
+       After perl has been installed, users may install their own local
+       architecture-independent modules in this directory with
+       MakeMaker Makefile.PL
+       or equivalent.  See INSTALL for details.
+
+sitelib_stem (sitelib.U):
+       This variable is $sitelibexp with any trailing version-specific component
+       removed.  The elements in inc_version_list (inc_version_list.U) can
+       be tacked onto this variable to generate a list of directories to search.
 
 sitelibexp (sitelib.U):
        This variable is the ~name expanded version of sitelib, so that you
@@ -2775,11 +3385,15 @@ sitelibexp (sitelib.U):
 siteprefix (siteprefix.U):
        This variable holds the full absolute path of the directory below
        which the user will install add-on packages.
+       See INSTALL for usage and examples.
 
 siteprefixexp (siteprefix.U):
        This variable holds the full absolute path of the directory below
        which the user will install add-on packages.  Derived from siteprefix.
 
+sizesize (sizesize.U):
+       This variable contains the size of a sizetype in bytes.
+
 sizetype (sizetype.U):
        This variable defines sizetype to be something like size_t, 
        unsigned long, or whatever type is used to declare length 
@@ -2793,11 +3407,6 @@ 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
-       the Makefile to use this.
-
 so (so.U):
        This variable holds the extension used to identify shared libraries
        (also known as shared objects) on the system. Usually set to 'so'.
@@ -2808,8 +3417,13 @@ sockethdr (d_socket.U):
 socketlib (d_socket.U):
        This variable has the names of any libraries needed for socket support.
 
+socksizetype (socksizetype.U):
+       This variable holds the type used for the size argument
+       for various socket calls like accept.  Usual values include
+       socklen_t, size_t, and int.
+
 sort (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -2822,12 +3436,6 @@ 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.
 
-split (models.U):
-       This variable contains a flag which will tell the C compiler and loader
-       to produce a program that will run in separate I and D space, for those
-       machines that support separation of instruction and data space.  It is
-       up to the Makefile to use this.
-
 sPRId64 (quadfio.U):
        This variable, if defined, contains the string used by stdio to
        format 64-bit decimal numbers (format 'd') for output.
@@ -2836,25 +3444,31 @@ sPRIeldbl (longdblfio.U):
        This variable, if defined, contains the string used by stdio to
        format long doubles (format 'e') for output.
 
-sPRIEldbl (longdblfio.U):
+sPRIEUldbl (longdblfio.U):
        This variable, if defined, contains the string used by stdio to
        format long doubles (format 'E') for output.
+       The 'U' in the name is to separate this from sPRIeldbl so that even
+       case-blind systems can see the difference.
 
 sPRIfldbl (longdblfio.U):
        This variable, if defined, contains the string used by stdio to
        format long doubles (format 'f') for output.
 
-sPRIFldbl (longdblfio.U):
+sPRIFUldbl (longdblfio.U):
        This variable, if defined, contains the string used by stdio to
        format long doubles (format 'F') for output.
+       The 'U' in the name is to separate this from sPRIfldbl so that even
+       case-blind systems can see the difference.
 
 sPRIgldbl (longdblfio.U):
        This variable, if defined, contains the string used by stdio to
        format long doubles (format 'g') for output.
 
-sPRIGldbl (longdblfio.U):
+sPRIGUldbl (longdblfio.U):
        This variable, if defined, contains the string used by stdio to
        format long doubles (format 'G') for output.
+       The 'U' in the name is to separate this from sPRIgldbl so that even
+       case-blind systems can see the difference.
 
 sPRIi64 (quadfio.U):
        This variable, if defined, contains the string used by stdio to
@@ -2872,15 +3486,21 @@ sPRIx64 (quadfio.U):
        This variable, if defined, contains the string used by stdio to
        format 64-bit hexadecimal numbers (format 'x') for output.
 
-sPRIX64 (quadfio.U):
+sPRIXU64 (quadfio.U):
        This variable, if defined, contains the string used by stdio to
        format 64-bit hExADECimAl numbers (format 'X') for output.
+       The 'U' in the name is to separate this from sPRIx64 so that even
+       case-blind systems can see the difference.
 
 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.
 
+sSCNfldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'f') for input.
+
 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 
@@ -2951,6 +3571,8 @@ submit (Loc.U):
 subversion (patchlevel.U):
        The subversion level of this package.
        The value of subversion comes from the patchlevel.h file.
+       In a version number such as 5.6.1, this is the "1".
+       In patchlevel.h, this is referred to as "PERL_SUBVERSION".
        This is unique to perl.
 
 sysman (sysman.U):
@@ -2967,6 +3589,10 @@ tar (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
 
+targetarch (Cross.U):
+       If cross-compiling, this variable contains the target architecture.
+       If not, this will be empty.
+
 tbl (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
@@ -2976,7 +3602,7 @@ tee (Loc.U):
        The value is a plain '' and is not useful.
 
 test (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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.
 
@@ -2988,13 +3614,19 @@ 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.
 
+to (Cross.U):
+       This variable contains the command used by Configure
+       to copy to from the target host.  Useful and available
+       only during Perl build.
+       The string ':' if not cross-compiling.
+
 touch (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is 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
+       This variable is 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.
 
@@ -3008,33 +3640,109 @@ troff (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
 
+u16size (perlxv.U):
+       This variable is the size of an U16 in bytes.
+
+u16type (perlxv.U):
+       This variable contains the C type used for Perl's U16.
+
+u32size (perlxv.U):
+       This variable is the size of an U32 in bytes.
+
+u32type (perlxv.U):
+       This variable contains the C type used for Perl's U32.
+
+u64size (perlxv.U):
+       This variable is the size of an U64 in bytes.
+
+u64type (perlxv.U):
+       This variable contains the C type used for Perl's U64.
+
+u8size (perlxv.U):
+       This variable is the size of an U8 in bytes.
+
+u8type (perlxv.U):
+       This variable contains the C type used for Perl's U8.
+
+uidformat (uidf.U):
+       This variable contains the format string used for printing a Uid_t.
+
+uidsign (uidsign.U):
+       This variable contains the signedness of a uidtype.
+       1 for unsigned, -1 for signed.
+
+uidsize (uidsize.U):
+       This variable contains the size of a uidtype in bytes.
+
 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
+       This variable is 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
+       This variable is 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.
 
-use64bits (use64bits.U):
-       This variable conditionally defines the USE_64_BITS symbol,
-       and indicates that explicit 64-bit interfaces should be used
-       when available.
+uquadtype (quadtype.U):
+       This variable defines Uquad_t to be something like unsigned long,
+       unsigned int, unsigned long long, uint64_t, or whatever type is
+       used for 64-bit integers.
+
+use5005threads (usethreads.U):
+       This variable conditionally defines the USE_5005THREADS symbol,
+       and indicates that Perl should be built to use the 5.005-based
+       threading implementation.
+
+use64bitall (use64bits.U):
+       This variable conditionally defines the USE_64_BIT_ALL symbol,
+       and indicates that 64-bit integer types should be used
+       when available.  The maximal possible
+       64-bitness is employed: LP64 or ILP64, meaning that you will
+       be able to use more than 2 gigabytes of memory.  This mode is
+       even more binary incompatible than USE_64_BIT_INT. You may not
+       be able to run the resulting executable in a 32-bit CPU at all or
+       you may need at least to reboot your OS to 64-bit mode.
+
+use64bitint (use64bits.U):
+       This variable conditionally defines the USE_64_BIT_INT symbol,
+       and indicates that 64-bit integer types should be used
+       when available.  The minimal possible 64-bitness
+       is employed, just enough to get 64-bit integers into Perl.
+       This may mean using for example "long longs", while your memory
+       may still be limited to 2 gigabytes.
+
+usecrosscompile (Cross.U):
+       This variable conditionally defines the USE_CROSS_COMPILE symbol,
+       and indicates that Perl has been cross-compiled.
 
 usedl (dlsrc.U):
-       This variable indicates if the the system supports dynamic
+       This variable indicates if the system supports dynamic
        loading of some sort.  See also dlsrc and dlobj.
 
+useithreads (usethreads.U):
+       This variable conditionally defines the USE_ITHREADS symbol,
+       and indicates that Perl should be built to use the interpreter-based
+       threading implementation.
+
+uselargefiles (uselfs.U):
+       This variable conditionally defines the USE_LARGE_FILES symbol,
+       and indicates that large file interfaces should be used when
+       available.
+
 uselongdouble (uselongdbl.U):
        This variable conditionally defines the USE_LONG_DOUBLE symbol,
        and indicates that long doubles should be used when available.
 
+usemorebits (usemorebits.U):
+       This variable conditionally defines the USE_MORE_BITS symbol,
+       and indicates that explicit 64-bit interfaces and long doubles
+       should be used when available.
+
 usemultiplicity (usemultiplicity.U):
        This variable conditionally defines the MULTIPLICITY symbol,
        and indicates that Perl should be built to use multiplicity.
@@ -3069,6 +3777,13 @@ useposix (Extensions.U):
        for hints files to indicate that POSIX will not compile
        on a particular system.
 
+usereentrant (usethreads.U):
+       This variable conditionally defines the USE_REENTRANT_API symbol,
+       which indicates that the thread code may try to use the various
+       _r versions of library functions.  This is only potentially
+       meaningful if usethreads is set and is very experimental, it is
+       not even prompted for.
+
 usesfio (d_sfio.U):
        This variable is set to true when the user agrees to use sfio.
        It is set to false when sfio is not available or when the user
@@ -3105,13 +3820,67 @@ uuname (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
 
+uvoformat (perlxvf.U):
+       This variable contains the format string used for printing
+       a Perl UV as an unsigned octal integer. 
+
+uvsize (perlxv.U):
+       This variable is the size of a UV in bytes.
+
+uvtype (perlxv.U):
+       This variable contains the C type used for Perl's UV.
+
+uvuformat (perlxvf.U):
+       This variable contains the format string used for printing
+       a Perl UV as an unsigned decimal integer. 
+
+uvxformat (perlxvf.U):
+       This variable contains the format string used for printing
+       a Perl UV as an unsigned hexadecimal integer in lowercase abcdef.
+
+uvXUformat (perlxvf.U):
+       This variable contains the format string used for printing
+       a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF.
+
+vendorarch (vendorarch.U):
+       This variable contains the value of the PERL_VENDORARCH symbol.
+       It may have a ~ on the front. 
+       The standard distribution will put nothing in this directory.
+       Vendors who distribute perl may wish to place their own
+       architecture-dependent modules and extensions in this directory with
+       MakeMaker Makefile.PL INSTALLDIRS=vendor 
+       or equivalent.  See INSTALL for details.
+
+vendorarchexp (vendorarch.U):
+       This variable is the ~name expanded version of vendorarch, so that you
+       may use it directly in Makefiles or shell scripts.
+
+vendorbin (vendorbin.U):
+       This variable contains the eventual value of the VENDORBIN symbol.
+       It may have a ~ on the front.
+       The standard distribution will put nothing in this directory.
+       Vendors who distribute perl may wish to place additional
+       binaries in this directory with
+       MakeMaker Makefile.PL INSTALLDIRS=vendor 
+       or equivalent.  See INSTALL for details.
+
+vendorbinexp (vendorbin.U):
+       This variable is the ~name expanded version of vendorbin, so that you
+       may use it directly in Makefiles or shell scripts.
+
 vendorlib (vendorlib.U):
        This variable contains the eventual value of the VENDORLIB symbol,
-       which is the name of the private library for this package.  It may
-       have a ~ on the front. It is up to the makefile to eventually create
-       this directory while performing installation (with ~ substitution).
-       Vendors who distribute perl binaries may place their own
-       extensions and modules in this directory.
+       which is the name of the private library for this package.
+       The standard distribution will put nothing in this directory.
+       Vendors who distribute perl may wish to place their own
+       modules in this directory with
+       MakeMaker Makefile.PL INSTALLDIRS=vendor 
+       or equivalent.  See INSTALL for details.
+
+vendorlib_stem (vendorlib.U):
+       This variable is $vendorlibexp with any trailing version-specific component
+       removed.  The elements in inc_version_list (inc_version_list.U) can
+       be tacked onto this variable to generate a list of directories to search.
 
 vendorlibexp (vendorlib.U):
        This variable is the ~name expanded version of vendorlib, so that you
@@ -3120,17 +3889,30 @@ vendorlibexp (vendorlib.U):
 vendorprefix (vendorprefix.U):
        This variable holds the full absolute path of the directory below
        which the vendor will install add-on packages.
+       See INSTALL for usage and examples.
 
 vendorprefixexp (vendorprefix.U):
        This variable holds the full absolute path of the directory below
        which the vendor will install add-on packages.  Derived from vendorprefix.
 
 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.
+       The full version number of this package, such as 5.6.1 (or 5_6_1).
+       This combines revision, patchlevel, and subversion to get the
+       full version number, including any possible subversions.
+       This is suitable for use as a directory name, and hence is
+       filesystem dependent.
+
+versiononly (versiononly.U):
+       If set, this symbol indicates that only the version-specific
+       components of a perl installation should be installed.
+       This may be useful for making a test installation of a new
+       version without disturbing the existing installation.
+       Setting versiononly is equivalent to setting installperl's -v option.
+       In particular, the non-versioned scripts and programs such as
+       a2p, c2ph, h2xs, pod2*, and perldoc are not installed
+       (see INSTALL for a more complete list).  Nor are the man
+       pages installed.
+       Usually, this is undef.
 
 vi (Loc.U):
        This variable is defined but not used by Configure.
@@ -3146,12 +3928,37 @@ xlibpth (libpth.U):
        libraries on this platform, for example CPU-specific libraries
        (on multi-CPU platforms) may be listed here.
 
+xs_apiversion (xs_apiversion.U):
+       This variable contains the version of the oldest perl binary
+       compatible with the present perl.  perl.c:incpush() and
+       lib/lib.pm will automatically search in $sitearch for older
+       directories across major versions back to xs_apiversion.
+       This is only useful if you have a perl library directory tree
+       structured like the default one.
+       See INSTALL for how this works.
+       The versioned site_perl directory was introduced in 5.005,
+       so that is the lowest possible value.
+       Since this can depend on compile time options (such as
+       bincompat) it is set by Configure.  Other non-default sources
+       of potential incompatibility, such as multiplicity, threads,
+       debugging, 64bits, sfio, etc., are not checked for currently,
+       though in principle we could go snooping around in old
+       Config.pm files.
+
+yacc (yacc.U):
+       This variable holds the name of the compiler compiler we
+       want to use in the Makefile. It can be yacc, byacc, or bison -y.
+
+yaccflags (yacc.U):
+       This variable contains any additional yacc flags desired by the
+       user.  It is up to the Makefile to use this.
+
 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
+       This variable is 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.