This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
In UNICOS division is really lossy, better use
[perl5.git] / Porting / Glossary
index edda0cb..a706e72 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,16 +44,49 @@ 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):
-       MakeMaker will install add-on modules in a directory with the
-       PERL_APIVERSION version number.  The value is set manually in
-       patchlevel.h.  Normally, for maintenance releases, this is
-       just something like 5.005 or 5.6 or 5.7.  That is, it does not
-       include the subversion number and does not change across
-       maintenance releases.  This is so that add-on extensions can
-       be shared across maintenance versions.  It is unclear how this
-       ought to work for developer versions.  If a release breaks
-       binary compatibility, this number should be increased.
+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 used internally by Configure to determine the
@@ -97,16 +137,17 @@ 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 used internally by Configure to determine the
@@ -140,7 +181,8 @@ cat (Loc.U):
 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
@@ -158,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.
@@ -185,8 +243,9 @@ chgrp (Loc.U):
        The value is a plain '' and is not useful.
 
 chmod (Loc.U):
-       This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       This variable is used internally by Configure to determine the
+       full pathname (if any) of the chmod program.  After Configure runs,
+       the value is reset to a plain "chmod" and is not useful.
 
 chown (Loc.U):
        This variable is defined but not used by Configure.
@@ -206,10 +265,6 @@ 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
@@ -235,7 +290,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.
@@ -274,11 +329,6 @@ 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
@@ -289,6 +339,10 @@ csh (Loc.U):
        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.
@@ -329,9 +383,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
@@ -376,10 +431,18 @@ d_chsize (d_chsize.U):
        indicates to the C program that the chsize() routine is available
        to truncate files.  You might need a -lx to get this routine.
 
+d_class (d_class.U):
+       This variable conditionally defines the HAS_CLASS symbol, which
+       indicates to the C program that the class() routine is available.
+
 d_closedir (d_closedir.U):
        This variable conditionally defines HAS_CLOSEDIR if closedir() is
        available.
 
+d_cmsghdr_s (d_cmsghdr_s.U):
+       This variable conditionally defines the HAS_STRUCT_CMSGHDR symbol,
+       which indicates that 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
@@ -404,6 +467,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.
@@ -471,10 +540,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.
@@ -483,6 +548,10 @@ d_eunice (Guess.U):
        This variable conditionally defines the symbols EUNICE and VAX, which
        alerts the C program that it must deal with ideosyncracies of VMS.
 
+d_fchdir (d_fchdir.U):
+       This variable conditionally defines the HAS_FCHDIR symbol, which
+       indicates to the C program that the fchdir() routine is available.
+
 d_fchmod (d_fchmod.U):
        This variable conditionally defines the HAS_FCHMOD symbol, which
        indicates to the C program that the fchmod() routine is available
@@ -497,6 +566,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
@@ -517,6 +590,14 @@ d_fgetpos (d_fgetpos.U):
        This variable conditionally defines HAS_FGETPOS if fgetpos() is
        available to get the file position indicator.
 
+d_finite (d_finite.U):
+       This variable conditionally defines the HAS_FINITE symbol, which
+       indicates to the C program that the finite() routine is available.
+
+d_finitel (d_finitel.U):
+       This variable conditionally defines the HAS_FINITEL symbol, which
+       indicates to the C program that the finitel() 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.
@@ -525,19 +606,45 @@ 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.
 
+d_fp_class (d_fp_class.U):
+       This variable conditionally defines the HAS_FP_CLASS symbol, which
+       indicates to the C program that the fp_class() routine is available.
+
 d_fpathconf (d_pathconf.U):
        This variable conditionally defines the HAS_FPATHCONF symbol, which
        indicates to the C program that the pathconf() routine is available
        to determine file-system related limits and options associated
        with a given open file descriptor.
 
-d_fpos64_t (io64.U):
+d_fpclass (d_fpclass.U):
+       This variable conditionally defines the HAS_FPCLASS symbol, which
+       indicates to the C program that the fpclass() routine is available.
+
+d_fpclassify (d_fpclassify.U):
+       This variable conditionally defines the HAS_FPCLASSIFY symbol, which
+       indicates to the C program that the fpclassify() routine is available.
+
+d_fpclassl (d_fpclassl.U):
+       This variable conditionally defines the HAS_FPCLASSL symbol, which
+       indicates to the C program that the fpclassl() routine is available.
+
+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.
@@ -558,6 +665,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.
@@ -576,6 +687,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
@@ -611,6 +735,10 @@ 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
@@ -646,6 +774,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 
@@ -691,6 +823,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
@@ -718,10 +854,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.
@@ -747,6 +879,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.
@@ -756,13 +892,29 @@ 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_isascii (d_isascii.U):
        This variable conditionally defines the HAS_ISASCII constant,
        which indicates to the C program that isascii() is available.
 
+d_isfinite (d_isfinite.U):
+       This variable conditionally defines the HAS_ISFINITE symbol, which
+       indicates to the C program that the isfinite() routine is available.
+
+d_isinf (d_isinf.U):
+       This variable conditionally defines the HAS_ISINF symbol, which
+       indicates to the C program that the isinf() routine 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
@@ -798,10 +950,20 @@ 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.
 
+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
@@ -847,14 +1009,49 @@ 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.
 
+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.
+
 d_msg (d_msg.U):
        This variable conditionally defines the HAS_MSG symbol, which
        indicates that the entire msg*(2) library is present.
@@ -892,6 +1089,10 @@ 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_msghdr_s.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.
@@ -900,6 +1101,14 @@ d_msgsnd (d_msgsnd.U):
        This variable conditionally defines the HAS_MSGSND symbol, which
        indicates to the C program that the msgsnd() routine is available.
 
+d_msync (d_msync.U):
+       This variable conditionally defines HAS_MSYNC if msync() is
+       available to synchronize a mapped file.
+
+d_munmap (d_munmap.U):
+       This variable conditionally defines HAS_MUNMAP if munmap() is
+       available to unmap a region mapped by mmap().
+
 d_mymalloc (mallocsrc.U):
        This variable conditionally defines MYMALLOC in case other parts
        of the source want to take special action if MYMALLOC is used.
@@ -909,7 +1118,19 @@ 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_nl_langinfo (d_nl_langinfo.U):
+       This variable conditionally defines the HAS_NL_LANGINFO symbol, which
+       indicates to the C program that the nl_langinfo() routine is available.
+
+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):
@@ -942,6 +1163,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
@@ -967,28 +1193,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
@@ -1007,9 +1239,16 @@ 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_atfork (d_pthread_atfork.U):
+       This variable conditionally defines the HAS_PTHREAD_ATFORK symbol,
+       which indicates to the C program that the pthread_atfork()
+       routine is available.
 
 d_pthread_yield (d_pthread_y.U):
        This variable conditionally defines the HAS_PTHREAD_YIELD
@@ -1048,6 +1287,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.
@@ -1057,6 +1304,14 @@ 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_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
        indicates to the C program that the rename() routine is available
@@ -1072,17 +1327,25 @@ d_rmdir (d_rmdir.U):
 
 d_safebcpy (d_safebcpy.U):
        This variable conditionally defines the HAS_SAFE_BCOPY symbol if
-       the bcopy() routine can do overlapping copies.
+       the bcopy() routine can do overlapping copies.  Normally, you
+       should probably use memmove().
 
 d_safemcpy (d_safemcpy.U):
        This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
        the memcpy() routine can do overlapping copies.
+       For overlapping copies, memmove() should be used, if available.
 
 d_sanemcmp (d_sanemcmp.U):
        This variable conditionally defines the HAS_SANE_MEMCMP symbol if
        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
@@ -1093,6 +1356,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.
@@ -1126,6 +1393,10 @@ 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_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
        indicates to the C program that the setegid() routine is available
@@ -1150,6 +1421,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
@@ -1185,6 +1460,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
@@ -1228,10 +1508,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
@@ -1270,23 +1546,57 @@ 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
@@ -1314,6 +1624,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.
@@ -1351,6 +1670,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
@@ -1361,15 +1684,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.
@@ -1387,6 +1726,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
@@ -1442,6 +1787,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.
@@ -1456,10 +1809,27 @@ 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_unordered (d_unordered.U):
+       This variable conditionally defines the HAS_UNORDERED symbol, which
+       indicates to the C program that the unordered() routine is available.
+
+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.
 
@@ -1513,6 +1883,10 @@ 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.
@@ -1532,6 +1906,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).
 
@@ -1607,6 +1995,9 @@ extensions (Extensions.U):
        and is typically used to test whether a particular extesion 
        is available.
 
+extras (Extras.U):
+       This variable holds a list of extra modules to install.
+
 fflushall (fflushall.U):
        This symbol, if defined, tells that to flush
        all pending stdio output one must loop through all
@@ -1643,6 +2034,12 @@ 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
@@ -1662,7 +2059,12 @@ 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.
@@ -1696,6 +2098,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, 
@@ -1724,12 +2128,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.
-
-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.
+       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.
@@ -1796,6 +2196,14 @@ i_float (i_float.U):
        whether a C program may include <float.h> to get symbols like DBL_MAX
        or DBL_MIN, i.e. machine dependent floating point values.
 
+i_fp (i_fp.U):
+       This variable conditionally defines the I_FP symbol, and indicates
+       whether a C program should include <fp.h>.
+
+i_fp_class (i_fp_class.U):
+       This variable conditionally defines the I_FP_CLASS symbol, and indicates
+       whether a C program should include <fp_class.h>.
+
 i_gdbm (i_gdbm.U):
        This variable conditionally defines the I_GDBM symbol, which
        indicates to the C program that <gdbm.h> exists and should
@@ -1805,10 +2213,26 @@ 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_langinfo (i_langinfo.U):
+       This variable conditionally defines the I_LANGINFO symbol,
+       and indicates whether a C program should include <langinfo.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
@@ -1865,6 +2289,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>.
@@ -1914,6 +2342,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>.
@@ -1941,6 +2373,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>.
@@ -2009,6 +2453,10 @@ 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>.
@@ -2065,6 +2513,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".
@@ -2156,6 +2619,11 @@ 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
@@ -2170,6 +2638,11 @@ 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. 
@@ -2188,11 +2661,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'.
@@ -2209,6 +2677,10 @@ 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
@@ -2241,11 +2713,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.
@@ -2391,12 +2884,6 @@ Mcc (Loc.U):
        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".
@@ -2406,10 +2893,10 @@ mkdir (Loc.U):
        full pathname (if any) of the mkdir program.  After Configure runs,
        the value is reset to a plain "mkdir" and is not useful.
 
-models (models.U):
-       This variable contains the list of memory models supported by this
-       system.  Possible component values are none, split, unsplit, small,
-       medium, large, and huge.  The component values are space separated.
+mmaptype (d_mmap.U):
+       This symbol contains the type of pointer returned by mmap()
+       (and simultaneously the type of the first argument).
+       It can be 'void *' or 'caddr_t'.
 
 modetype (modetype.U):
        This variable defines modetype to be something like mode_t, 
@@ -2457,6 +2944,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.
@@ -2503,6 +2999,30 @@ nroff (Loc.U):
        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.
 
@@ -2549,6 +3069,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.
@@ -2561,22 +3091,35 @@ 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_APIVERSION (Oldsyms.U):
-       This value is manually set in patchlevel.h and is used
-       to set the Configure apiversion variable.
+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.
@@ -2595,6 +3138,10 @@ PERL_VERSION (Oldsyms.U):
 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
@@ -2672,7 +3219,7 @@ 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.
 
-quadcase (quadtype.U):
+quadkind (quadtype.U):
        This variable, if defined, encodes the type of a quad:
        1 = int, 2 = long, 3 = long long, 4 = int64_t.
 
@@ -2704,6 +3251,11 @@ 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 used internally by Configure to determine the
        full pathname (if any) of the rm program.  After Configure runs,
@@ -2713,6 +3265,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
@@ -2834,6 +3392,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).
 
@@ -2878,6 +3440,11 @@ sitelib (sitelib.U):
        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
        may use it directly in Makefiles or shell scripts.
@@ -2891,6 +3458,9 @@ 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 
@@ -2904,11 +3474,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'.
@@ -2919,6 +3484,11 @@ 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 used internally by Configure to determine the
        full pathname (if any) of the sort program.  After Configure runs,
@@ -2933,12 +3503,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.
@@ -2947,25 +3511,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
@@ -2983,15 +3553,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 
@@ -3039,7 +3615,7 @@ stdio_cnt (d_stdstdio.U):
 
 stdio_filbuf (d_stdstdio.U):
        This variable defines how, given a FILE pointer, fp, to tell
-       stdio to refill it's internal buffers (?).  This will
+       stdio to refill its internal buffers (?).  This will
        be used to define the macro FILE_filbuf(fp).
 
 stdio_ptr (d_stdstdio.U):
@@ -3062,6 +3638,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):
@@ -3078,6 +3656,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.
@@ -3099,6 +3681,12 @@ 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 used internally by Configure to determine the
        full pathname (if any) of the touch program.  After Configure runs,
@@ -3172,28 +3760,51 @@ uquadtype (quadtype.U):
        unsigned int, unsigned long long, uint64_t, or whatever type is
        used for 64-bit integers.
 
-use64bits (use64bits.U):
-       This variable conditionally defines the USE_64_BITS symbol,
-       and indicates that explicit 64-bit interfaces should be used
-       when available.
+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.  The use64bits symbol will also be turned on if necessary.
+       available.
 
 uselongdouble (uselongdbl.U):
        This variable conditionally defines the USE_LONG_DOUBLE symbol,
        and indicates that long doubles should be used when available.
 
-uselonglong (uselonglong.U):
-       This variable conditionally defines the USE_LONG_LONG symbol,
-       and indicates that long longs 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
@@ -3233,6 +3844,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
@@ -3249,7 +3867,7 @@ usesocks (usesocks.U):
        and indicates that Perl should be built to use SOCKS.
 
 usethreads (usethreads.U):
-       This variable conditionally defines the USE_THREADS symbol,
+       This variable conditionally defines the USE_5005THREADS symbol,
        and indicates that Perl should be built to use threads.
 
 usevendorprefix (vendorprefix.U):
@@ -3285,7 +3903,24 @@ uvuformat (perlxvf.U):
 
 uvxformat (perlxvf.U):
        This variable contains the format string used for printing
-       a Perl UV as an unsigned hexadecimal integer. 
+       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.
@@ -3309,6 +3944,11 @@ vendorlib (vendorlib.U):
        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
        may use it directly in Makefiles or shell scripts.
@@ -3323,11 +3963,32 @@ vendorprefixexp (vendorprefix.U):
        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.
+
+version_patchlevel_string (patchlevel.U):
+       This is a string combining version, subversion and
+       perl_patchlevel (if perl_patchlevel is non-zero).  
+       It is typically something like 
+       'version 7 subversion 1'  or
+       'version 7 subversion 1 patchlevel 11224'
+       It is computed here to avoid duplication of code in myconfig.SH
+       and lib/Config.pm. 
+
+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.
@@ -3360,6 +4021,14 @@ xs_apiversion (xs_apiversion.U):
        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.