relax restrictions on constant names a bit (from M J T Guy)
[p5sagit/p5-mst-13.2.git] / Porting / Glossary
index 0b8a099..71d97f8 100644 (file)
@@ -26,7 +26,8 @@ afs (afs.U):
 
 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 +38,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 +113,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.
 
@@ -94,6 +130,10 @@ bin (bin.U):
        is most often a local directory such as /usr/local/bin. Programs using
        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.
+
 binexp (bin.U):
        This is the same as the bin variable, but is filename expanded at
        configuration time, for use in your makefiles.
@@ -103,7 +143,7 @@ bison (Loc.U):
        The value is a plain '' 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.
 
@@ -127,7 +167,7 @@ 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.
 
@@ -154,8 +194,6 @@ ccflags (ccflags.U):
 
 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.
 
 cf_by (cf_who.U):
@@ -170,6 +208,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.
@@ -188,7 +230,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.
 
@@ -196,6 +238,10 @@ compress (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
 
+CONFIGDOTSH (Oldsyms.U):
+       This is set to 'true' in config.sh so that a shell script
+       sourcing config.sh can tell if it has been sourced already.
+
 contains (contains.U):
        This variable holds the command to do a grep with a proper return
        status.  On most sane systems it is simply "grep".  On insane systems
@@ -203,7 +249,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.
 
@@ -212,7 +258,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.
 
@@ -221,9 +267,9 @@ cpp_stuff (cpp_stuff.U):
        used by the C preprocessor.
 
 cppccsymbols (Cppsym.U):
-       The variable contains the symbols defined by the C compiler when
-       when it calls cpp.  The symbols defined by the cc alone or cpp
-       alone are not in this list, see ccsymbols and cppsymbols.
+       The variable contains the symbols defined by both
+       the bare C compiler and during a compilation that
+       includes stdio.h.
        The list is a space-separated list of symbol=value tokens.
 
 cppflags (ccflags.U):
@@ -255,9 +301,8 @@ cppstdin (cppstdin.U):
        preprocessor symbols.
 
 cppsymbols (Cppsym.U):
-       The variable contains the symbols defined by the C preprocessor
-       alone.  The symbols defined by cc or by cc when it calls cpp are
-       not in this list, see ccsymbols and cppccsymbols.
+       The variable contains the symbols during a compilation
+       that includes stdio.h.
        The list is a space-separated list of symbol=value tokens.
 
 crosscompile (crosscompile.U):
@@ -271,7 +316,7 @@ cryptlib (d_crypt.U):
        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.
 
@@ -292,6 +337,14 @@ d_archlib (archlib.U):
        of architecture-dependent library files for $package.  If
        $archlib is the same as $privlib, then this is set to undef.
 
+d_atolf (atolf.U):
+       This variable conditionally defines the HAS_ATOLF symbol, which
+       indicates to the C program that the atolf() routine is available.
+
+d_atoll (atoll.U):
+       This variable conditionally defines the HAS_ATOLL symbol, which
+       indicates to the C program that the atoll() routine is available.
+
 d_attribut (d_attribut.U):
        This variable conditionally defines HASATTRIBUTE, which
        indicates the C compiler can check for function attributes,
@@ -305,6 +358,12 @@ d_bcopy (d_bcopy.U):
        This variable conditionally defines the HAS_BCOPY symbol if
        the bcopy() routine is available to copy strings.
 
+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.
+
 d_bsd (Guess.U):
        This symbol conditionally defines the symbol BSD when running on a
        BSD system.
@@ -352,10 +411,6 @@ d_closedir (d_closedir.U):
        This variable conditionally defines HAS_CLOSEDIR if closedir() is
        available.
 
-d_cmsghdr_s (d_socket.U):
-       This variable conditionally defines the HAS_STRUCT_CMSGHDR symbol,
-       which indicates that the the struct cmsghdr is supported.
-
 d_const (d_const.U):
        This variable conditionally defines the HASCONST symbol, which
        indicates to the C program that this C compiler knows about the
@@ -380,25 +435,10 @@ 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_dbmclose64 (dbm64.U):
-       This variable conditionally defines the HAS_DBMCLOSE64 symbol, which
-       indicates to the C program that the dbmclose64() routine is available.
-
-d_dbminit64 (dbm64.U):
-       This variable conditionally defines the HAS_DBMINIT64 symbol, which
-       indicates to the C program that the dbminit64() routine is available.
-
-d_delete64 (dbm64.U):
-       This variable conditionally defines the HAS_DELETE64 symbol, which
-       indicates to the C program that the delete64() routine is available.
-
 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.
 
-d_dirent64_s (io64.U):
-       This symbol will be defined if the C compiler supports struct dirent64.
-
 d_dirnamlen (i_dirent.U):
        This variable conditionally defines DIRNAMLEN, which indicates
        to the C program that the length of directory entry names is
@@ -504,37 +544,18 @@ d_fds_bits (d_fd_set.U):
        a half-fast job and neglected to provide the macros to manipulate
        an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
 
-d_fetch64 (dbm64.U):
-       This variable conditionally defines the HAS_FETCH64 symbol, which
-       indicates to the C program that the fetch64() routine is available.
-
-d_fgetpos64 (stdio64.U):
-       This variable conditionally defines the HAS_FGETPOS64 symbol, which
-       indicates to the C program that the fgetpos64() routine is available.
-
 d_fgetpos (d_fgetpos.U):
        This variable conditionally defines HAS_FGETPOS if fgetpos() is
        available to get the file position indicator.
 
-d_firstkey64 (dbm64.U):
-       This variable conditionally defines the HAS_FIRSTKEY64 symbol, which
-       indicates to the C program that the firstkey64() routine is available.
-
 d_flexfnam (d_flexfnam.U):
        This variable conditionally defines the FLEXFILENAMES symbol, which
        indicates that the system supports filenames longer than 14 characters.
 
-d_flock64_s (io64.U):
-       This symbol will be defined if the C compiler supports struct flock64.
-
 d_flock (d_flock.U):
        This variable conditionally defines HAS_FLOCK if flock() is
        available to do file locking.
 
-d_fopen64 (stdio64.U):
-       This variable conditionally defines the HAS_FOPEN64 symbol, which
-       indicates to the C program that the fopen64() routine is available.
-
 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.
@@ -545,35 +566,22 @@ d_fpathconf (d_pathconf.U):
        to determine file-system related limits and options associated
        with a given open file descriptor.
 
-d_freopen64 (stdio64.U):
-       This variable conditionally defines the HAS_FREOPEN64 symbol, which
-       indicates to the C program that the freopen64() routine is available.
-
-d_fseek64 (stdio64.U):
-       This variable conditionally defines the HAS_FSEEK64 symbol, which
-       indicates to the C program that the fseek64() routine is available.
+d_fpos64_t (d_fpos64_t.U):
+       This symbol will be defined if the C compiler supports fpos64_t.
 
-d_fseeko64 (stdio64.U):
-       This variable conditionally defines the HAS_FSEEKO64 symbol, which
-       indicates to the C program that the fseeko64() 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.
 
-d_fsetpos64 (stdio64.U):
-       This variable conditionally defines the HAS_FSETPOS64 symbol, which
-       indicates to the C program that the fsetpos64() routine is available.
-
 d_fsetpos (d_fsetpos.U):
        This variable conditionally defines HAS_FSETPOS if fsetpos() is
        available to set the file position indicator.
 
-d_fstat64 (io64.U):
-       This variable conditionally defines the HAS_FSTAT64 symbol, which
-       indicates to the C program that the fstat64() routine is available.
-
-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.
 
@@ -581,14 +589,6 @@ 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_ftell64 (stdio64.U):
-       This variable conditionally defines the HAS_FTELL64 symbol, which
-       indicates to the C program that the ftell64() routine is available.
-
-d_ftello64 (stdio64.U):
-       This variable conditionally defines the HAS_FTELLO64 symbol, which
-       indicates to the C program that the ftello64() 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.
@@ -598,10 +598,6 @@ d_ftime (d_ftime.U):
        that the ftime() routine exists.  The ftime() routine is basically
        a sub-second accuracy clock.
 
-d_ftruncate64 (io64.U):
-       This variable conditionally defines the HAS_FTRUNCATE64 symbol, which
-       indicates to the C program that the ftruncate64() routine is available.
-
 d_Gconvert (d_gconvert.U):
        This variable holds what Gconvert is defined as to convert
        floating point numbers into strings. It could be 'gconvert'
@@ -611,6 +607,15 @@ 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_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
@@ -651,10 +656,15 @@ d_getlogin (d_getlogin.U):
        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
@@ -777,6 +787,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.
@@ -786,16 +800,9 @@ 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_ino64_t (io64.U):
-       This symbol will be defined if the C compiler supports ino64_t.
-
-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.
@@ -810,22 +817,19 @@ d_lchown (d_lchown.U):
        indicates to the C program that the lchown() routine is available
        to operate on a symbolic link (instead of following the link).
 
+d_ldbl_dig (d_ldbl_dig.U):
+       This variable conditionally defines d_ldbl_dig if this system's
+       header files provide LDBL_DIG, which is the number of significant
+       digits in a long double precision number.
+
 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.
 
-d_lockf64 (io64.U):
-       This variable conditionally defines the HAS_LOCKF64 symbol, which
-       indicates to the C program that the lockf64() routine is available.
-
 d_lockf (d_lockf.U):
        This variable conditionally defines HAS_LOCKF if lockf() is
        available to do file locking.
@@ -838,22 +842,16 @@ d_longlong (d_longlong.U):
        This variable conditionally defines HAS_LONG_LONG if 
        the long long type is supported.
 
-d_lseek64 (io64.U):
-       This variable conditionally defines the HAS_LSEEK64 symbol, which
-       indicates to the C program that the lseek64() routine is available.
-
-d_lstat64 (io64.U):
-       This variable conditionally defines the HAS_LSTAT64 symbol, which
-       indicates to the C program that the lstat64() routine is available.
+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.
 
-d_madvise (d_madvise.U):
-       This variable conditionally defines HAS_MADVISE if madvise() is
-       available to map a file into memory.
-
 d_mblen (d_mblen.U):
        This variable conditionally defines the HAS_MBLEN symbol, which
        indicates to the C program that the mblen() routine is available
@@ -899,10 +897,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.
@@ -952,10 +966,6 @@ 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):
-       This variable conditionally defines the HAS_STRUCT_MSGHDR symbol,
-       which indicates that the struct msghdr is supported.
-
 d_msgrcv (d_msgrcv.U):
        This variable conditionally defines the HAS_MSGRCV symbol, which
        indicates to the C program that the msgrcv() routine is available.
@@ -977,19 +987,16 @@ d_mymalloc (mallocsrc.U):
        of the source want to take special action if MYMALLOC is used.
        This may include different sorts of profiling or error detection.
 
-d_nextkey64 (dbm64.U):
-       This variable conditionally defines the HAS_NEXTKEY64 symbol, which
-       indicates to the C program that the nextkey64() routine is available.
-
 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):
-       This symbol will be defined if the C compiler supports off64_t.
+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_offset_t (io64.U):
-       This symbol will be defined if the C compiler supports offset_t.
+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):
        This variable conditionally defines pthread_create_joinable.
@@ -998,7 +1005,7 @@ d_old_pthread_create_joinable (d_pthrattrj.U):
 d_oldpthreads (usethreads.U):
        This variable conditionally defines the OLD_PTHREADS_API symbol,
        and indicates that Perl should be built to use the old
-       draft POSIX threads API.  This is only potneially meaningful if
+       draft POSIX threads API.  This is only potentially meaningful if
        usethreads is set.
 
 d_oldsock (d_socket.U):
@@ -1010,14 +1017,6 @@ d_open3 (d_open3.U):
        which indicates to the C program that the 3 argument version of
        the open(2) function is available.
 
-d_open64 (io64.U):
-       This variable conditionally defines the HAS_OPEN64 symbol, which
-       indicates to the C program that the open64() routine is available.
-
-d_opendir64 (io64.U):
-       This variable conditionally defines the HAS_OPENDIR64 symbol, which
-       indicates to the C program that the opendir64() routine is available.
-
 d_pathconf (d_pathconf.U):
        This variable conditionally defines the HAS_PATHCONF symbol, which
        indicates to the C program that the pathconf() routine is available
@@ -1049,6 +1048,55 @@ d_portable (d_portable.U):
        indicates to the C program that it should not assume that it is
        running on the machine it was compiled on.
 
+d_PRId64 (quadfio.U):
+       This variable conditionally defines the PERL_PRId64 symbol, which
+       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
+       indiciates that stdio has a symbol to print long doubles.
+
+d_PRIEldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldlbl 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
+       indiciates that stdio has a symbol to print long doubles.
+
+d_PRIFldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldlbl 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
+       indiciates that stdio has a symbol to print long doubles.
+
+d_PRIGldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+       indiciates that stdio has a symbol to print long doubles.
+
+d_PRIi64 (quadfio.U):
+       This variable conditionally defines the PERL_PRIi64 symbol, which
+       indiciates that stdio has a symbol to print 64-bit decimal numbers.
+
+d_PRIo64 (quadfio.U):
+       This variable conditionally defines the PERL_PRIo64 symbol, which
+       indiciates that stdio has a symbol to print 64-bit octal numbers.
+
+d_PRIu64 (quadfio.U):
+       This variable conditionally defines the PERL_PRIu64 symbol, which
+       indiciates that stdio has a symbol to print 64-bit unsigned decimal
+       numbers.
+
+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
+       indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers.
+
 d_pthread_yield (d_pthread_y.U):
        This variable conditionally defines the HAS_PTHREAD_YIELD
        symbol if the pthread_yield routine is available to yield
@@ -1086,9 +1134,9 @@ d_pwquota (i_pwd.U):
        This variable conditionally defines PWQUOTA, which indicates
        that struct passwd contains pw_quota.
 
-d_readdir64 (io64.U):
-       This variable conditionally defines the HAS_READDIR64 symbol, which
-       indicates to the C program that the readdir64() 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
@@ -1099,14 +1147,6 @@ d_readlink (d_readlink.U):
        indicates to the C program that the readlink() routine is available
        to read the value of a symbolic link.
 
-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_rename (d_rename.U):
        This variable conditionally defines the HAS_RENAME symbol, which
        indicates to the C program that the rename() routine is available
@@ -1143,10 +1183,6 @@ 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_seekdir64 (io64.U):
-       This variable conditionally defines the HAS_SEEKDIR64 symbol, which
-       indicates to the C program that the seekdir64() routine is available.
-
 d_seekdir (d_readdir.U):
        This variable conditionally defines HAS_SEEKDIR if seekdir() is
        available.
@@ -1180,10 +1216,6 @@ 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_setegid (d_setegid.U):
        This variable conditionally defines the HAS_SETEGID symbol, which
        indicates to the C program that the setegid() routine is available
@@ -1337,29 +1369,32 @@ 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_stat64 (io64.U):
-       This variable conditionally defines the HAS_STAT64 symbol, which
-       indicates to the C program that the stat64() 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_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.
@@ -1386,10 +1421,6 @@ d_stdstdio (d_stdstdio.U):
        has a FILE structure declaring usable _ptr and _cnt fields (or
        equivalent) in stdio.h.
 
-d_store64 (dbm64.U):
-       This variable conditionally defines the HAS_STORE64 symbol, which
-       indicates to the C program that the store64() routine is available.
-
 d_strchr (d_strchr.U):
        This variable conditionally defines HAS_STRCHR if strchr() and
        strrchr() are available for string searching.
@@ -1423,11 +1454,27 @@ 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_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 (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.
@@ -1472,10 +1519,6 @@ d_tcsetpgrp (d_tcstpgrp.U):
        indicates to the C program that the tcsetpgrp() routine is available
        to set foreground process group ID.
 
-d_telldir64 (io64.U):
-       This variable conditionally defines the HAS_TELLDIR64 symbol, which
-       indicates to the C program that the telldir64() routine is available.
-
 d_telldir (d_readdir.U):
        This variable conditionally defines HAS_TELLDIR if telldir() is
        available.
@@ -1496,14 +1539,6 @@ d_times (d_times.U):
        that the times() routine exists.  The times() routine is normaly
        provided on UNIX systems. You may have to include <sys/times.h>.
 
-d_tmpfile64 (stdio64.U):
-       This variable conditionally defines the HAS_TMPFILE64 symbol, which
-       indicates to the C program that the tmpfile64() routine is available.
-
-d_truncate64 (io64.U):
-       This variable conditionally defines the HAS_TRUNCATE64 symbol, which
-       indicates to the C program that the truncate64() routine is available.
-
 d_truncate (d_truncate.U):
        This variable conditionally defines HAS_TRUNCATE if truncate() is
        available to truncate files.
@@ -1526,6 +1561,16 @@ 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_ustat (d_ustat.U):
+       This variable conditionally defines HAS_USTAT if ustat() is
+       available to query file system statistics by dev_t.
+
+d_vendorbin (vendorbin.U):
+       This variable conditionally defines PERL_VENDORBIN.
+
+d_vendorlib (vendorlib.U):
+       This variable conditionally defines PERL_VENDORLIB.
+
 d_vfork (d_vfork.U):
        This variable conditionally defines the HAS_VFORK symbol, which
        indicates the vfork() routine is available.
@@ -1573,16 +1618,12 @@ d_wctomb (d_wctomb.U):
        indicates to the C program that the wctomb() routine is available
        to convert a wide character to a multibyte.
 
-d_writev (d_writev.U):
-       This variable conditionally defines the HAS_WRITEV symbol, which
-       indicates to the C program that the writev() routine is available.
-
 d_xenix (Guess.U):
        This variable conditionally defines the symbol XENIX, which alerts
        the C program that it runs under Xenix.
 
 date (Loc.U):
-       This variable is be used internally by Configure to determine the
+       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.
 
@@ -1639,12 +1680,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.
 
@@ -1661,7 +1702,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.
 
@@ -1696,8 +1737,11 @@ 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):
@@ -1728,6 +1772,16 @@ gccversion (cc.U):
        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
@@ -1739,7 +1793,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.
 
@@ -1747,6 +1801,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, 
@@ -1755,7 +1811,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.
 
@@ -1775,6 +1831,8 @@ 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.
 
 huge (models.U):
        This variable contains a flag which will tell the C compiler and loader
@@ -1782,6 +1840,30 @@ huge (models.U):
        huge model is not supported, contains the flag to produce large
        model programs.  It is up to the Makefile to use this.
 
+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.
+
+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,
        and indicates whether a C program should include <arpa/inet.h>.
@@ -1832,6 +1914,10 @@ 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_inttypes (i_inttypes.U):
        This variable conditionally defines the I_INTTYPES symbol,
        and indicates whether a C program should include <inttypes.h>.
@@ -1893,7 +1979,7 @@ i_poll (i_poll.U):
        whether a C program should include <poll.h>.
 
 i_pthread (i_pthread.U):
-       This variable conditionally defines the I_PTHREADEAD symbol,
+       This variable conditionally defines the I_PTHREAD symbol,
        and indicates whether a C program should include <pthread.h>.
 
 i_pwd (i_pwd.U):
@@ -1968,10 +2054,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>.
@@ -2006,6 +2100,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>.
@@ -2036,6 +2134,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>.
@@ -2058,6 +2164,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>.
@@ -2084,6 +2194,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".
@@ -2115,6 +2240,18 @@ installman3dir (man3dir.U):
        man3direxp only points to the read-only access location. For extra
        portability, you should only use this variable within your makefiles.
 
+installprefix (installprefix.U):
+       This variable holds the name of the directory below which 
+       "make install" will install the package.  For most users, this
+       is the same as prefix.  However, it is useful for
+       installing the software into a different (usually temporary)
+       location after which it can be bundled up and moved somehow
+       to the final location specified by prefix.
+
+installprefixexp (installprefix.U):
+       This variable holds the full absolute path of installprefix
+       with all ~-expansion done.
+
 installprivlib (privlib.U):
        This variable is really the same as privlibexp but may differ on
        those systems using AFS. For extra portability, only this variable
@@ -2130,20 +2267,63 @@ 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
        should be used in makefiles.
 
+installstyle (installstyle.U):
+       This variable describes the "style" of the perl installation.
+       This is intended to be useful for tools that need to
+       manipulate entire perl distributions.  Perl itself doesn't use
+       this to find its libraries -- the library directories are
+       stored directly in Config.pm.  Currently, there are only two
+       styles:  "lib" and "lib/perl5".  The default library locations
+       (e.g. privlib, sitelib) are either $prefix/lib or
+       $prefix/lib/perl5.  The former is useful if $prefix is a
+       directory dedicated to perl (e.g. /opt/perl), while the latter
+       is useful if $prefix is shared by many packages, e.g. if
+       $prefix=/usr/local.
+               This may later be extended to include other information, so
+       be careful with pattern-matching on the results.
+               For compatibility with perl5.005 and earlier, the default
+       setting is based on whether or not $prefix contains the string
+       "perl".
+
 installusrbinperl (instubperl.U):
        This variable tells whether Perl should be installed also as
        /usr/bin/perl in addition to
        $installbin/perl
 
+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
+       should be used in makefiles.
+
 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.
 
+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.
@@ -2173,8 +2353,13 @@ ldflags (ccflags.U):
        This variable contains any additional C loader flags desired by
        the user.  It is up to the Makefile to use this.
 
+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.
 
@@ -2200,6 +2385,21 @@ 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
@@ -2218,7 +2418,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.
 
@@ -2262,7 +2462,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.
 
@@ -2285,7 +2485,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.
 
@@ -2346,7 +2546,7 @@ 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.
 
@@ -2361,7 +2561,7 @@ mips_type (usrinc.U):
        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.
 
@@ -2381,7 +2581,7 @@ modetype (modetype.U):
        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.
 
@@ -2443,7 +2643,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.
 
@@ -2463,10 +2663,16 @@ 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.
 
+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
@@ -2519,19 +2725,42 @@ 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_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.
 
@@ -2541,7 +2770,7 @@ perlpath (perlpath.U):
        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.
 
@@ -2560,6 +2789,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.
@@ -2597,6 +2841,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.
@@ -2621,8 +2873,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.
 
@@ -2651,7 +2908,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.
 
@@ -2759,21 +3016,55 @@ 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.
 
 sitelibexp (sitelib.U):
        This variable is the ~name expanded version of sitelib, so that you
        may use it directly in Makefiles or shell scripts.
 
+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.
+
 sizetype (sizetype.U):
        This variable defines sizetype to be something like size_t, 
        unsigned long, or whatever type is used to declare length 
@@ -2802,8 +3093,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,6 +3118,54 @@ split (models.U):
        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.
+
+sPRIeldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'e') for output.
+
+sPRIEldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'E') for output.
+
+sPRIfldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'f') for output.
+
+sPRIFldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'F') for output.
+
+sPRIgldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'g') for output.
+
+sPRIGldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'G') for output.
+
+sPRIi64 (quadfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format 64-bit decimal numbers (format 'i') for output.
+
+sPRIo64 (quadfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format 64-bit octal numbers (format 'o') for output.
+
+sPRIu64 (quadfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format 64-bit unsigned decimal numbers (format 'u') for output.
+
+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):
+       This variable, if defined, contains the string used by stdio to
+       format 64-bit hExADECimAl numbers (format 'X') for output.
+
 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
@@ -2897,6 +3241,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):
@@ -2922,7 +3268,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.
 
@@ -2935,12 +3281,12 @@ timetype (d_time.U):
        included). Anyway, the type Time_t should be used.
 
 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.
 
@@ -2954,29 +3300,105 @@ 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.
 
 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.
@@ -3030,6 +3452,10 @@ usethreads (usethreads.U):
        This variable conditionally defines the USE_THREADS symbol,
        and indicates that Perl should be built to use threads.
 
+usevendorprefix (vendorprefix.U):
+       This variable tells whether the vendorprefix
+       and consequently other vendor* paths are in use.
+
 usevfork (d_vfork.U):
        This variable is set to true when the user accepts to use vfork.
        It is set to false when no vfork is available or when the user
@@ -3043,12 +3469,65 @@ 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. 
+
+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.
+       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.
+
+vendorlibexp (vendorlib.U):
+       This variable is the ~name expanded version of vendorlib, so that you
+       may use it directly in Makefiles or shell scripts.
+
+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.
 
 vi (Loc.U):
        This variable is defined but not used by Configure.
@@ -3064,12 +3543,29 @@ 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.
+
 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.