This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Restore a reference to $perlpath. Installation needs it
[perl5.git] / Porting / Glossary
index 43723bb..9170c6c 100644 (file)
@@ -34,7 +34,7 @@ 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.
+       tests for AFSness in the configure and test process.
 
 alignbytes (alignbytes.U):
        This variable holds the number of bytes required to align a
@@ -142,7 +142,7 @@ baserev (baserev.U):
 
 bash (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 bin (bin.U):
        This variable holds the name of the directory in which the user wants
@@ -150,6 +150,11 @@ 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.
 
+bin_ELF (dlsrc.U):
+       This variable saves the result from configure if generated binaries
+       are in ELF format. Only set to defined when the test has actually
+       been performed, and the result was positive.
+
 binexp (bin.U):
        This is the same as the bin variable, but is filename expanded at
        configuration time, for use in your makefiles.
@@ -244,13 +249,17 @@ 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.
 
+charbits (charsize.U):
+       This variable contains the value of the CHARBITS symbol, which
+       indicates to the C program how many bits there are in a character.
+
 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.
+       The value is the empty string and is not useful.
 
 chmod (Loc.U):
        This variable is used internally by Configure to determine the
@@ -259,7 +268,7 @@ chmod (Loc.U):
 
 chown (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 clocktype (d_times.U):
        This variable holds the type returned by times(). It can be long,
@@ -273,7 +282,24 @@ comm (Loc.U):
 
 compress (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
+
+config_arg0 (Options.U):
+       This variable contains the string used to invoke the Configure
+       command, as reported by the shell in the $0 variable.
+
+config_argc (Options.U):
+       This variable countains the number of command-line arguments
+       passed to Configure, as reported by the shell in the $# variable.
+       The individual arguments are stored as variables config_argc1,
+       config_argc2, etc.
+
+config_args (Options.U):
+       This variable contains a single string giving the command-line
+       arguments passed to Configure.  Spaces within arguments,
+       quotes, and escaped characters are not correctly preserved.
+       To reconstruct the command line, you must assemble the individual
+       command line pieces, given in config_arg[0-9]*.
 
 contains (contains.U):
        This variable holds the command to do a grep with a proper return
@@ -288,7 +314,7 @@ cp (Loc.U):
 
 cpio (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 cpp (Loc.U):
        This variable is used internally by Configure to determine the
@@ -393,6 +419,10 @@ 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_asctime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_ASCTIME64 symbol, which
+       indicates to the C program that the asctime64 () routine is available.
+
 d_asctime_r (d_asctime_r.U):
        This variable conditionally defines the HAS_ASCTIME_R symbol,
        which indicates to the C program that the asctime_r()
@@ -406,6 +436,11 @@ 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_attribute_deprecated (d_attribut.U):
+       This variable conditionally defines HASATTRIBUTE_DEPRECATED, which
+       indicates that GCC can handle the attribute for marking deprecated
+       APIs
+
 d_attribute_format (d_attribut.U):
        This variable conditionally defines HASATTRIBUTE_FORMAT, which
        indicates the C compiler can check for printf-like formats.
@@ -539,6 +574,11 @@ d_copysignl (d_copysignl.U):
        indicates to the C program that the copysignl() routine is available.
        If aintl is also present we can emulate modfl.
 
+d_cplusplus (d_cplusplus.U):
+       This variable conditionally defines the USE_CPLUSPLUS symbol, which
+       indicates that a C++ compiler was used to compiled Perl and will be
+       used to compile extensions.
+
 d_crypt (d_crypt.U):
        This variable conditionally defines the CRYPT symbol, which
        indicates to the C program that the crypt() routine is available
@@ -553,11 +593,19 @@ d_csh (d_csh.U):
        This variable conditionally defines the CSH symbol, which
        indicates to the C program that the C-shell exists.
 
+d_ctermid (d_ctermid.U):
+       This variable conditionally defines CTERMID if ctermid() is
+       available to generate filename for terminal.
+
 d_ctermid_r (d_ctermid_r.U):
        This variable conditionally defines the HAS_CTERMID_R symbol,
        which indicates to the C program that the ctermid_r()
        routine is available.
 
+d_ctime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_CTIME64 symbol, which
+       indicates to the C program that the ctime64 () routine is available.
+
 d_ctime_r (d_ctime_r.U):
        This variable conditionally defines the HAS_CTIME_R symbol,
        which indicates to the C program that the ctime_r()
@@ -583,6 +631,15 @@ 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_difftime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_DIFFTIME64 symbol, which
+       indicates to the C program that the difftime64 () routine is available.
+
+d_dir_dd_fd (d_dir_dd_fd.U):
+       This variable conditionally defines the HAS_DIR_DD_FD symbol, which
+       indicates that the DIR directory stream type contains a member
+       variable called dd_fd.
+
 d_dirfd (d_dirfd.U):
        This variable conditionally defines the HAS_DIRFD constant,
        which indicates to the C program that dirfd() is available
@@ -854,6 +911,29 @@ d_Gconvert (d_gconvert.U):
        call-back unit so that long doubles can be formatted without
        loss of precision.
 
+d_gdbm_ndbm_h_uses_prototypes (i_ndbm.U):
+       This variable conditionally defines the NDBM_H_USES_PROTOTYPES symbol,
+       which indicates that the gdbm-ndbm.h include file uses real ANSI C
+       prototypes instead of K&R style function declarations. K&R style
+       declarations are unsupported in C++, so the include file requires
+       special handling when using a C++ compiler and this variable is
+       undefined. Consult the different d_*ndbm_h_uses_prototypes variables
+       to get the same information for alternative ndbm.h include files.
+
+d_gdbmndbm_h_uses_prototypes (i_ndbm.U):
+       This variable conditionally defines the NDBM_H_USES_PROTOTYPES symbol,
+       which indicates that the gdbm/ndbm.h include file uses real ANSI C
+       prototypes instead of K&R style function declarations. K&R style
+       declarations are unsupported in C++, so the include file requires
+       special handling when using a C++ compiler and this variable is
+       undefined. Consult the different d_*ndbm_h_uses_prototypes variables
+       to get the same information for alternative ndbm.h include files.
+
+d_getaddrinfo (d_getaddrinfo.U):
+       This variable conditionally defines the HAS_GETADDRINFO symbol,
+       which indicates to the C program that the getaddrinfo() function
+       is available.
+
 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
@@ -956,6 +1036,11 @@ d_getmntent (d_getmntent.U):
        indicates to the C program that the getmntent() routine is available
        to iterate through mounted files to get their mount info.
 
+d_getnameinfo (d_getnameinfo.U):
+       This variable conditionally defines the HAS_GETNAMEINFO symbol,
+       which indicates to the C program that the getnameinfo() function
+       is available.
+
 d_getnbyaddr (d_getnbyad.U):
        This variable conditionally defines the HAS_GETNETBYADDR symbol, which
        indicates to the C program that the getnetbyaddr() routine is available
@@ -1130,6 +1215,10 @@ d_gettimeod (d_ftime.U):
        indicates that the gettimeofday() system call exists (to obtain a
        sub-second accuracy clock). You should probably include <sys/resource.h>.
 
+d_gmtime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_GMTIME64 symbol, which
+       indicates to the C program that the gmtime64 () routine is available.
+
 d_gmtime_r (d_gmtime_r.U):
        This variable conditionally defines the HAS_GMTIME_R symbol,
        which indicates to the C program that the gmtime_r()
@@ -1169,6 +1258,16 @@ 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_inetntop (d_inetntop.U):
+       This variable conditionally defines the HAS_INETNTOP symbol,
+       which indicates to the C program that the inet_ntop() function
+       is available.
+
+d_inetpton (d_inetpton.U):
+       This variable conditionally defines the HAS_INETPTON symbol,
+       which indicates to the C program that the inet_pton() function
+       is available.
+
 d_int64_t (d_int64_t.U):
        This symbol will be defined if the C compiler supports int64_t.
 
@@ -1216,11 +1315,19 @@ d_link (d_link.U):
        This variable conditionally defines HAS_LINK if link() is
        available to create hard links.
 
+d_localtime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_LOCALTIME64 symbol, which
+       indicates to the C program that the localtime64 () routine is available.
+
 d_localtime_r (d_localtime_r.U):
        This variable conditionally defines the HAS_LOCALTIME_R symbol,
        which indicates to the C program that the localtime_r()
        routine is available.
 
+d_localtime_r_needs_tzset (d_localtime_r.U):
+       This variable conditionally defines the LOCALTIME_R_NEEDS_TZSET
+       symbol, which makes us call tzset before localtime_r()
+
 d_locconv (d_locconv.U):
        This variable conditionally defines HAS_LOCALECONV if localeconv() is
        available for numeric and monetary formatting conventions.
@@ -1328,6 +1435,10 @@ 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_mktime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_MKTIME64 symbol, which
+       indicates to the C program that the mktime64 () routine is available.
+
 d_mmap (d_mmap.U):
        This variable conditionally defines HAS_MMAP if mmap() is
        available to map a file into memory.
@@ -1415,6 +1526,23 @@ 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_ndbm (i_ndbm.U):
+       This variable conditionally defines the HAS_NDBM symbol, which
+       indicates that both the ndbm.h include file and an appropriate ndbm
+       library exist.  Consult the different i_*ndbm variables
+       to find out the actual include location.  Sometimes, a system has the
+       header file but not the library.  This variable will only be set if
+       the system has both.
+
+d_ndbm_h_uses_prototypes (i_ndbm.U):
+       This variable conditionally defines the NDBM_H_USES_PROTOTYPES symbol,
+       which indicates that the ndbm.h include file uses real ANSI C
+       prototypes instead of K&R style function declarations. K&R style
+       declarations are unsupported in C++, so the include file requires
+       special handling when using a C++ compiler and this variable is
+       undefined. Consult the different d_*ndbm_h_uses_prototypes variables
+       to get the same information for alternative ndbm.h include files.
+
 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.
@@ -1489,6 +1617,15 @@ 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_prctl (d_prctl.U):
+       This variable conditionally defines the HAS_PRCTL symbol, which
+       indicates to the C program that the prctl() routine is available.
+
+d_prctl_set_name (d_prctl.U):
+       This variable conditionally defines the HAS_PRCTL_SET_NAME symbol,
+       which indicates to the C program that the prctl() routine supports
+       the PR_SET_NAME option.
+
 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.
@@ -1527,6 +1664,10 @@ 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_printf_format_null (d_attribut.U):
+       This variable conditionally defines PRINTF_FORMAT_NULL_OK, which
+       indicates the C compiler allows printf-like formats to be null.
+
 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.
@@ -1550,6 +1691,10 @@ d_procselfexe (d_procselfexe.U):
        Defined if $procselfexe is symlink to the absolute
        pathname of the executing program.
 
+d_pseudofork (d_vfork.U):
+       This variable conditionally defines the HAS_PSEUDOFORK symbol,
+       which indicates that an emulation of the fork routine is available.
+
 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()
@@ -1911,6 +2056,11 @@ d_sigaction (d_sigaction.U):
        This variable conditionally defines the HAS_SIGACTION symbol, which
        indicates that the Vr4 sigaction() routine is available.
 
+d_signbit (d_signbit.U):
+       This variable conditionally defines the HAS_SIGNBIT symbol, which
+       indicates to the C program that the signbit() routine is available
+       and safe to use with perl's intern NV type.
+
 d_sigprocmask (d_sigprocmask.U):
        This variable conditionally defines HAS_SIGPROCMASK
        if sigprocmask() is available to examine or change the signal mask
@@ -1921,6 +2071,11 @@ d_sigsetjmp (d_sigsetjmp.U):
        which indicates that the sigsetjmp() routine is available to
        call setjmp() and optionally save the process's signal mask.
 
+d_sin6_scope_id (d_socket.U):
+       This variable conditionally defines the HAS_SIN6_SCOPE_ID symbol, which
+       indicates that a struct sockaddr_in6 structure has the sin6_scope_id
+       member.
+
 d_sitearch (sitearch.U):
        This variable conditionally defines SITEARCH to hold the pathname
        of architecture-dependent library files for $package.  If
@@ -1931,6 +2086,11 @@ d_snprintf (d_snprintf.U):
        indicates to the C program that the snprintf () library function
        is available.
 
+d_sockaddr_sa_len (d_socket.U):
+       This variable conditionally defines the HAS_SOCKADDR_SA_LEN symbol,
+       which indicates that a struct sockaddr structure has the sa_len
+       member.
+
 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.
@@ -2003,6 +2163,12 @@ 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_static_inline (d_static_inline.U):
+       This variable conditionally defines the HAS_STATIC_INLINE symbol,
+       which indicates that the C compiler supports C99-style static
+       inline.  That is, the function can't be called from another
+       translation unit.
+
 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.
@@ -2178,6 +2344,10 @@ d_time (d_time.U):
        that the time() routine exists.  The time() routine is normaly
        provided on UNIX systems.
 
+d_timegm (d_timegm.U):
+       This variable conditionally defines the HAS_TIMEGM symbol, which
+       indicates to the C program that the timegm () routine is available.
+
 d_times (d_times.U):
        This variable conditionally defines the HAS_TIMES symbol, which indicates
        that the times() routine exists.  The times() routine is normaly
@@ -2387,6 +2557,9 @@ drand48_r_proto (d_drand48_r.U):
        REENTRANT_PROTO_T_ABC macros of reentr.h if d_drand48_r
        is defined.
 
+dtrace (usedtrace.U):
+       This variable holds the location of the dtrace executable.
+
 dynamic_ext (Extensions.U):
        This variable holds a list of XS extension files we want to
        link dynamically into the package.  It is used by Makefile.
@@ -2414,7 +2587,7 @@ egrep (Loc.U):
 
 emacs (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 endgrent_r_proto (d_endgrent_r.U):
        This variable encodes the prototype of endgrent_r.
@@ -2471,6 +2644,10 @@ extensions (Extensions.U):
        and is typically used to test whether a particular extesion
        is available.
 
+extern_C (Csym.U):
+       ANSI C requires 'extern' where C++ requires 'extern "C"'. This
+       variable can be used in Configure to do the right thing.
+
 extras (Extras.U):
        This variable holds a list of extra modules to install.
 
@@ -2487,7 +2664,7 @@ fflushNULL (fflushall.U):
 
 find (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 firstmakefile (Unix.U):
        This variable defines the first file searched by make.  On unix,
@@ -2497,7 +2674,7 @@ firstmakefile (Unix.U):
 
 flex (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 fpossize (fpossize.U):
        This variable contains the size of a fpostype in bytes.
@@ -2797,6 +2974,11 @@ i_arpainet (i_arpainet.U):
        This variable conditionally defines the I_ARPA_INET symbol,
        and indicates whether a C program should include <arpa/inet.h>.
 
+i_assert (i_assert.U):
+       This variable conditionally defines the I_ASSERT symbol, which
+       indicates to the C program that <assert.h> exists and could be
+       included.
+
 i_bsdioctl (i_sysioctl.U):
        This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
        indicates to the C program that <sys/bsdioctl.h> exists and should
@@ -2851,6 +3033,18 @@ i_gdbm (i_gdbm.U):
        indicates to the C program that <gdbm.h> exists and should
        be included.
 
+i_gdbm_ndbm (i_ndbm.U):
+       This variable conditionally defines the I_GDBM_NDBM symbol, which
+       indicates to the C program that <gdbm-ndbm.h> exists and should
+       be included.  This is the location of the ndbm.h compatibility file
+       in Debian 4.0.
+
+i_gdbmndbm (i_ndbm.U):
+       This variable conditionally defines the I_GDBMNDBM symbol, which
+       indicates to the C program that <gdbm/ndbm.h> exists and should
+       be included.  This was the location of the ndbm.h compatibility file
+       in RedHat 7.1.
+
 i_grp (i_grp.U):
        This variable conditionally defines the I_GRP symbol, and indicates
        whether a C program should include <grp.h>.
@@ -2888,6 +3082,10 @@ i_malloc (i_malloc.U):
        This variable conditionally defines the I_MALLOC symbol, and indicates
        whether a C program should include <malloc.h>.
 
+i_mallocmalloc (i_mallocmalloc.U):
+       This variable conditionally defines the I_MALLOCMALLOC symbol,
+       and indicates whether a C program should include <malloc/malloc.h>.
+
 i_math (i_math.U):
        This variable conditionally defines the I_MATH symbol, and indicates
        whether a C program may include <math.h>.
@@ -3035,6 +3233,10 @@ i_sysparam (i_sysparam.U):
        This variable conditionally defines the I_SYS_PARAM symbol, and indicates
        whether a C program should include <sys/param.h>.
 
+i_syspoll (i_syspoll.U):
+       This variable conditionally defines the I_SYS_POLL symbol, which
+       indicates to the C program that it should include <sys/poll.h>.
+
 i_sysresrc (i_sysresrc.U):
        This variable conditionally defines the I_SYS_RESOURCE symbol,
        and indicates whether a C program should include <sys/resource.h>.
@@ -3178,7 +3380,7 @@ incpath (usrinc.U):
 
 inews (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 initialinstalllocation (bin.U):
        When userelocatableinc is true, this variable holds the location
@@ -3392,7 +3594,7 @@ known_extensions (Extensions.U):
 
 ksh (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 ld (dlsrc.U):
        This variable indicates the program to be used to link
@@ -3474,11 +3676,11 @@ libswanted_uselargefiles (uselfs.U):
 
 line (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 lint (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 lkflags (ccflags.U):
        This variable contains any additional C partial linker flags desired by
@@ -3528,11 +3730,11 @@ longsize (intsize.U):
 
 lp (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 lpr (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 ls (Loc.U):
        This variable is used internally by Configure to determine the
@@ -3567,11 +3769,11 @@ madlysrc (mad.U):
 
 mail (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 mailx (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 make (Loc.U):
        This variable is used internally by Configure to determine the
@@ -3588,7 +3790,7 @@ make_set_make (make.U):
 
        make_set_make="MAKE=$make"      # if it doesn't.
 
-       This uses a comment character to distinguish a
+       This uses a comment character so that we can distinguish a
        'set' value (from a previous config.sh or Configure '-D' option)
        from an uncomputed value.
 
@@ -3637,11 +3839,6 @@ man3ext (man3dir.U):
        have: one of 'n', 'l', or '3'.  The Makefile must supply the '.'.
        See man3dir.
 
-Mcc (Loc.U):
-       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.
-
 mips_type (usrinc.U):
        This variable holds the environment type for the mips system.
        Possible values are "BSD 4.3" and "System V".
@@ -3681,7 +3878,7 @@ multiarch (multiarch.U):
 
 mv (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 myarchname (archname.U):
        This variable holds the architecture name computed by Configure in
@@ -3765,6 +3962,11 @@ 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.
 
+nv_overflows_integers_at (perlxv.U):
+       This variable gives the largest integer value that NVs can hold
+       as a constant floating point expression.
+       If it could not be determined, it holds the value 0.
+
 nv_preserves_uv_bits (perlxv.U):
        This variable indicates how many of bits type uvtype
        a variable nvtype can preserve.
@@ -3875,8 +4077,9 @@ path_sep (Unix.U):
        used to separate elements in the command shell search PATH.
 
 perl (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 perl program.  After Configure runs,
+       the value is reset to a plain "perl" and is not useful.
 
 perl5 (perl5.U):
        This variable contains the full path (if any) to a previously
@@ -3925,6 +4128,16 @@ 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_static_inline (d_static_inline.U):
+       This variable defines the PERL_STATIC_INLINE symbol to
+       the best-guess incantation to use for static inline functions.
+       Possibilities include
+       static inline       (c99)
+       static __inline__   (gcc -ansi)
+       static __inline     (MSVC)
+       static _inline      (older MSVC)
+       static              (c89 compilers)
+
 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
@@ -3975,11 +4188,11 @@ plibpth (libpth.U):
 
 pmake (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 pr (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 prefix (prefix.U):
        This variable holds the name of the directory below which the
@@ -4075,9 +4288,13 @@ rm (Loc.U):
        full pathname (if any) of the rm program.  After Configure runs,
        the value is reset to a plain "rm" and is not useful.
 
+rm_try (Unix.U):
+       This is a cleanup variable for try test programs.
+       Internal Configure use only.
+
 rmail (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 run (Cross.U):
        This variable contains the command used by Configure
@@ -4129,7 +4346,7 @@ selecttype (selecttype.U):
 
 sendmail (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 setgrent_r_proto (d_setgrent_r.U):
        This variable encodes the prototype of setgrent_r.
@@ -4173,6 +4390,14 @@ setservent_r_proto (d_setservent_r.U):
        REENTRANT_PROTO_T_ABC macros of reentr.h if d_setservent_r
        is defined.
 
+sGMTIME_max (time_size.U):
+       This variable defines the maximum value of the time_t offset that
+       the system function gmtime () accepts
+
+sGMTIME_min (time_size.U):
+       This variable defines the minimum value of the time_t offset that
+       the system function gmtime () accepts
+
 sh (sh.U):
        This variable contains the full pathname of the shell used
        on this system to execute Bourne shell scripts.  Usually, this will be
@@ -4185,7 +4410,7 @@ sh (sh.U):
 
 shar (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 sharpbang (spitshell.U):
        This variable contains the string #! if this system supports that
@@ -4399,11 +4624,19 @@ sizetype (sizetype.U):
 
 sleep (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
+
+sLOCALTIME_max (time_size.U):
+       This variable defines the maximum value of the time_t offset that
+       the system function localtime () accepts
+
+sLOCALTIME_min (time_size.U):
+       This variable defines the minimum value of the time_t offset that
+       the system function localtime () accepts
 
 smail (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 so (so.U):
        This variable holds the extension used to identify shared libraries
@@ -4503,9 +4736,9 @@ srandom_r_proto (d_srandom_r.U):
        is defined.
 
 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.
+       This variable holds the (possibly relative) path of the package source.
+       It is up to the Makefile to use this variable and set VPATH accordingly
+       to find the sources remotely.  Use $pkgsrc to have an absolute path.
 
 sSCNfldbl (longdblfio.U):
        This variable, if defined, contains the string used by stdio to
@@ -4582,7 +4815,7 @@ strings (i_string.U):
 
 submit (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 subversion (patchlevel.U):
        The subversion level of this package.
@@ -4599,11 +4832,11 @@ sysman (sysman.U):
 
 tail (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 tar (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 targetarch (Cross.U):
        If cross-compiling, this variable contains the target architecture.
@@ -4611,11 +4844,11 @@ targetarch (Cross.U):
 
 tbl (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 tee (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 test (Loc.U):
        This variable is used internally by Configure to determine the
@@ -4660,7 +4893,7 @@ trnl (trnl.U):
 
 troff (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 ttyname_r_proto (d_ttyname_r.U):
        This variable encodes the prototype of ttyname_r.
@@ -4724,7 +4957,7 @@ uquadtype (quadtype.U):
 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.
+       threading implementation. Only valid up to 5.8.x.
 
 use64bitall (use64bits.U):
        This variable conditionally defines the USE_64_BIT_ALL symbol,
@@ -4748,10 +4981,18 @@ usecrosscompile (Cross.U):
        This variable conditionally defines the USE_CROSS_COMPILE symbol,
        and indicates that Perl has been cross-compiled.
 
+usedevel (Devel.U):
+       This variable indicates that Perl was configured with development
+       features enabled.  This should not be done for production builds.
+
 usedl (dlsrc.U):
        This variable indicates if the system supports dynamic
        loading of some sort.  See also dlsrc and dlobj.
 
+usedtrace (usedtrace.U):
+       This variable indicates whether we are compiling with dtrace
+       support. See also dtrace.
+
 usefaststdio (usefaststdio.U):
        This variable conditionally defines the USE_FAST_STDIO symbol,
        and indicates that Perl should be built to use 'fast stdio'.
@@ -4867,7 +5108,7 @@ usrinc (usrinc.U):
 
 uuname (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 uvoformat (perlxvf.U):
        This variable contains the format string used for printing
@@ -4891,6 +5132,11 @@ uvXUformat (perlxvf.U):
        This variable contains the format string used for printing
        a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF.
 
+vaproto (vaproto.U):
+       This variable conditionally defines CAN_VAPROTO on systems supporting
+       prototype declaration of functions with a variable number of
+       arguments. See also prototype.
+
 vendorarch (vendorarch.U):
        This variable contains the value of the PERL_VENDORARCH symbol.
        It may have a ~ on the front.
@@ -5039,7 +5285,7 @@ versiononly (versiononly.U):
 
 vi (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 voidflags (voidflags.U):
        This variable contains the eventual value of the VOIDFLAGS symbol,
@@ -5061,7 +5307,7 @@ yaccflags (yacc.U):
 
 zcat (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 zip (Loc.U):
        This variable is used internally by Configure to determine the