This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for var names in @a=~// warning
[perl5.git] / Porting / Glossary
index b3500b6..81c83a9 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
@@ -112,13 +112,13 @@ archlibexp (archlib.U):
        This variable is the same as the archlib variable, but is
        filename expanded at configuration time, for convenient use.
 
-archname64 (use64bits.U):
-       This variable is used for the 64-bitness part of $archname.
-
 archname (archname.U):
        This variable is a short name to characterize the current
        architecture.  It is used mainly to construct the default archlib.
 
+archname64 (use64bits.U):
+       This variable is used for the 64-bitness part of $archname.
+
 archobjs (Unix.U):
        This variable defines any additional objects that must be linked
        in with the program on this architecture.  On unix, it is usually
@@ -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 contains 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,38 +436,43 @@ 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_format (d_attribut_format.U):
+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.
 
-d_attribute_malloc (d_attribute_malloc.U):
+d_attribute_malloc (d_attribut.U):
        This variable conditionally defines HASATTRIBUTE_MALLOC, which
        indicates the C compiler can understand functions as having
        malloc-like semantics.
 
-d_attribute_nonnull (d_attribute_nonnull.U):
+d_attribute_nonnull (d_attribut.U):
        This variable conditionally defines HASATTRIBUTE_NONNULL, which
        indicates that the C compiler can know that certain arguments
        must not be NULL, and will check accordingly at compile time.
 
-d_attribute_noreturn (d_attribute_noreturn.U):
+d_attribute_noreturn (d_attribut.U):
        This variable conditionally defines HASATTRIBUTE_NORETURN, which
        indicates that the C compiler can know that certain functions
        are guaranteed never to return.
 
-d_attribute_pure (d_attribute_pure.U):
+d_attribute_pure (d_attribut.U):
        This variable conditionally defines HASATTRIBUTE_PURE, which
        indicates that the C compiler can know that certain functions
        are "pure" functions, meaning that they have no side effects, and
        only rely on function input and/or global data for their results.
 
-d_attribute_unused (d_attribute_unused.U):
+d_attribute_unused (d_attribut.U):
        This variable conditionally defines HASATTRIBUTE_UNUSED, which
        indicates that the C compiler can know that certain variables
        and arguments may not always be used, and to not throw warnings
        if they don't get used.
 
-d_attribute_warn_unused_result (d_attribute_warn_unused_result.U):
+d_attribute_warn_unused_result (d_attribut.U):
        This variable conditionally defines
        HASATTRIBUTE_WARN_UNUSED_RESULT, which indicates that the C
        compiler can know that certain functions have a return values
@@ -482,13 +517,18 @@ d_bzero (d_bzero.U):
        This variable conditionally defines the HAS_BZERO symbol if
        the bzero() routine is available to set memory to 0.
 
+d_c99_variadic_macros (d_c99_variadic.U):
+       This variable conditionally defines the HAS_C99_VARIADIC_MACROS
+       symbol, which indicates to the C program that C99 variadic macros
+       are available.
+
 d_casti32 (d_casti32.U):
        This variable conditionally defines CASTI32, which indicates
        whether the C compiler can cast large floats to 32-bit ints.
 
 d_castneg (d_castneg.U):
        This variable conditionally defines CASTNEG, which indicates
-       wether the C compiler can cast negative float to unsigned.
+       whether the C compiler can cast negative float to unsigned.
 
 d_charvspr (d_vprintf.U):
        This variable conditionally defines CHARVSPRINTF if this system
@@ -534,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
@@ -548,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()
@@ -578,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
@@ -687,7 +749,7 @@ d_eofnblk (nblock_io.U):
 
 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.
+       alerts the C program that it must deal with idiosyncrasies of VMS.
 
 d_faststdio (d_faststdio.U):
        This variable conditionally defines the HAS_FAST_STDIO symbol,
@@ -824,7 +886,7 @@ d_ftime (d_ftime.U):
        that the ftime() routine exists.  The ftime() routine is basically
        a sub-second accuracy clock.
 
-d_futimes (f_futimes.U):
+d_futimes (d_futimes.U):
        This variable conditionally defines the HAS_FUTIMES symbol, which
        indicates to the C program that the futimes() routine is available.
 
@@ -849,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
@@ -856,7 +941,7 @@ d_getcwd (d_getcwd.U):
 
 d_getespwnam (d_getespwnam.U):
        This variable conditionally defines HAS_GETESPWNAM if getespwnam() is
-       available to retrieve enchanced (shadow) password entries by name.
+       available to retrieve enhanced (shadow) password entries by name.
 
 d_getfsstat (d_getfsstat.U):
        This variable conditionally defines the HAS_GETFSSTAT symbol, which
@@ -951,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
@@ -1011,15 +1101,15 @@ d_getpgid (d_getpgid.U):
        indicates to the C program that the getpgid(pid) function
        is available to get the process group id.
 
+d_getpgrp (d_getpgrp.U):
+       This variable conditionally defines HAS_GETPGRP if getpgrp() is
+       available to get the current process group.
+
 d_getpgrp2 (d_getpgrp2.U):
        This variable conditionally defines the HAS_GETPGRP2 symbol, which
        indicates to the C program that the getpgrp2() (as in DG/UX) routine
        is available to get the current process group.
 
-d_getpgrp (d_getpgrp.U):
-       This variable conditionally defines HAS_GETPGRP if getpgrp() is
-       available to get the current process group.
-
 d_getppid (d_getppid.U):
        This variable conditionally defines the HAS_GETPPID symbol, which
        indicates to the C program that the getppid() routine is available
@@ -1125,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()
@@ -1151,6 +1245,10 @@ d_ilogbl (d_ilogbl.U):
        indicates to the C program that the ilogbl() routine is available.
        If scalbnl is also present we can emulate frexpl.
 
+d_inc_version_list (inc_version_list.U):
+       This variable conditionally defines PERL_INC_VERSION_LIST.
+       It is set to undef when PERL_INC_VERSION_LIST is empty.
+
 d_index (d_strchr.U):
        This variable conditionally defines HAS_INDEX if index() and
        rindex() are available for string searching.
@@ -1160,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.
 
@@ -1198,15 +1306,28 @@ d_ldbl_dig (d_ldbl_dig.U):
        header files provide LDBL_DIG, which is the number of significant
        digits in a long double precision number.
 
+d_libm_lib_version (d_libm_lib_version.U):
+       This variable conditionally defines the LIBM_LIB_VERSION symbol,
+       which indicates to the C program that math.h defines _LIB_VERSION
+       being available in libm
+
 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.
@@ -1237,12 +1358,12 @@ d_madvise (d_madvise.U):
        This variable conditionally defines HAS_MADVISE if madvise() is
        available to map a file into memory.
 
-d_malloc_size (d_malloc_size.U):
-       This symbol, if defined, indicates that the malloc_size
+d_malloc_good_size (d_malloc_size.U):
+       This symbol, if defined, indicates that the malloc_good_size
        routine is available for use.
 
-d_malloc_good_size (d_malloc_good_size.U):
-       This symbol, if defined, indicates that the malloc_good_size
+d_malloc_size (d_malloc_size.U):
+       This symbol, if defined, indicates that the malloc_size
        routine is available for use.
 
 d_mblen (d_mblen.U):
@@ -1278,7 +1399,7 @@ d_memcpy (d_memcpy.U):
 d_memmove (d_memmove.U):
        This variable conditionally defines the HAS_MEMMOVE symbol, which
        indicates to the C program that the memmove() routine is available
-       to copy potentatially overlapping blocks of memory.
+       to copy potentially overlapping blocks of memory.
 
 d_memset (d_memset.U):
        This variable conditionally defines the HAS_MEMSET symbol, which
@@ -1314,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.
@@ -1401,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.
@@ -1475,60 +1617,73 @@ 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.
+       indicates that stdio has a symbol to print 64-bit decimal numbers.
 
 d_PRIeldbl (longdblfio.U):
        This variable conditionally defines the PERL_PRIfldbl symbol, which
-       indiciates that stdio has a symbol to print long doubles.
+       indicates that stdio has a symbol to print long doubles.
 
 d_PRIEUldbl (longdblfio.U):
        This variable conditionally defines the PERL_PRIfldbl symbol, which
-       indiciates that stdio has a symbol to print long doubles.
+       indicates 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_PRIfldbl symbol, which
-       indiciates that stdio has a symbol to print long doubles.
+       indicates that stdio has a symbol to print long doubles.
 
 d_PRIFUldbl (longdblfio.U):
        This variable conditionally defines the PERL_PRIfldbl symbol, which
-       indiciates that stdio has a symbol to print long doubles.
+       indicates 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_PRIfldbl symbol, which
-       indiciates that stdio has a symbol to print long doubles.
+       indicates that stdio has a symbol to print long doubles.
 
 d_PRIGUldbl (longdblfio.U):
        This variable conditionally defines the PERL_PRIfldbl symbol, which
-       indiciates that stdio has a symbol to print long doubles.
+       indicates 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
-       indiciates that stdio has a symbol to print 64-bit decimal numbers.
+       indicates 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.
+       indicates that stdio has a symbol to print 64-bit octal numbers.
 
 d_PRIu64 (quadfio.U):
        This variable conditionally defines the PERL_PRIu64 symbol, which
-       indiciates that stdio has a symbol to print 64-bit unsigned decimal
+       indicates that stdio has a symbol to print 64-bit unsigned decimal
        numbers.
 
 d_PRIx64 (quadfio.U):
        This variable conditionally defines the PERL_PRIx64 symbol, which
-       indiciates that stdio has a symbol to print 64-bit hexadecimal numbers.
+       indicates that stdio has a symbol to print 64-bit hexadecimal numbers.
 
 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.
+       indicates 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.
 
@@ -1536,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()
@@ -1596,15 +1755,15 @@ d_random_r (d_random_r.U):
        which indicates to the C program that the random_r()
        routine is available.
 
+d_readdir (d_readdir.U):
+       This variable conditionally defines HAS_READDIR if readdir() is
+       available to read directory entries.
+
 d_readdir64_r (d_readdir64_r.U):
        This variable conditionally defines the HAS_READDIR64_R symbol,
        which indicates to the C program that the readdir64_r()
        routine is available.
 
-d_readdir (d_readdir.U):
-       This variable conditionally defines HAS_READDIR if readdir() is
-       available to read directory entries.
-
 d_readdir_r (d_readdir_r.U):
        This variable conditionally defines the HAS_READDIR_R symbol,
        which indicates to the C program that the readdir_r()
@@ -1674,7 +1833,7 @@ d_scm_rights (d_socket.U):
 
 d_SCNfldbl (longdblfio.U):
        This variable conditionally defines the PERL_PRIfldbl symbol, which
-       indiciates that stdio has a symbol to scan long doubles.
+       indicates that stdio has a symbol to scan long doubles.
 
 d_seekdir (d_readdir.U):
        This variable conditionally defines HAS_SEEKDIR if seekdir() is
@@ -1783,15 +1942,15 @@ d_setpgid (d_setpgid.U):
        This variable conditionally defines the HAS_SETPGID symbol if the
        setpgid(pid, gpid) function is available to set process group ID.
 
+d_setpgrp (d_setpgrp.U):
+       This variable conditionally defines HAS_SETPGRP if setpgrp() is
+       available to set the current process group.
+
 d_setpgrp2 (d_setpgrp2.U):
        This variable conditionally defines the HAS_SETPGRP2 symbol, which
        indicates to the C program that the setpgrp2() (as in DG/UX) routine
        is available to set the current process group.
 
-d_setpgrp (d_setpgrp.U):
-       This variable conditionally defines HAS_SETPGRP if setpgrp() is
-       available to set the current process group.
-
 d_setprior (d_setprior.U):
        This variable conditionally defines HAS_SETPRIORITY if setpriority()
        is available to set a process's priority.
@@ -1897,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
@@ -1907,6 +2071,26 @@ 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
+       $sitearch is the same as $archlib, then this is set to undef.
+
+d_snprintf (d_snprintf.U):
+       This variable conditionally defines the HAS_SNPRINTF symbol, which
+       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.
@@ -1932,7 +2116,7 @@ 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_sprintf_returns_strlen (d_sprintf_returns_strlen.U):
+d_sprintf_returns_strlen (d_sprintf_len.U):
        This variable defines whether sprintf returns the length of the string
        (as per the ANSI spec). Some C libraries retain compatibility with
        pre-ANSI C and return a pointer to the passed in buffer; for these
@@ -1979,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.
@@ -2151,12 +2341,16 @@ d_telldirproto (d_telldirproto.U):
 
 d_time (d_time.U):
        This variable conditionally defines the HAS_TIME symbol, which indicates
-       that the time() routine exists.  The time() routine is normaly
+       that the time() routine exists.  The time() routine is normally
        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
+       that the times() routine exists.  The times() routine is normally
        provided on UNIX systems. You may have to include <sys/times.h>.
 
 d_tm_tm_gmtoff (i_time.U):
@@ -2258,7 +2452,7 @@ d_voidtty (i_sysioctl.U):
        This variable conditionally defines USE_IOCNOTTY to indicate that the
        ioctl() call with TIOCNOTTY should be used to void tty association.
        Otherwise (on USG probably), it is enough to close the standard file
-       decriptors and do a setpgrp().
+       descriptors and do a setpgrp().
 
 d_volatile (d_volatile.U):
        This variable conditionally defines the HASVOLATILE symbol, which
@@ -2270,6 +2464,11 @@ d_vprintf (d_vprintf.U):
        indicates to the C program that the vprintf() routine is available
        to printf with a pointer to an argument list.
 
+d_vsnprintf (d_snprintf.U):
+       This variable conditionally defines the HAS_VSNPRINTF symbol, which
+       indicates to the C program that the vsnprintf () library function
+       is available.
+
 d_wait4 (d_wait4.U):
        This variable conditionally defines the HAS_WAIT4 symbol, which
        indicates the wait4() routine is available.
@@ -2358,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.
@@ -2385,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.
@@ -2439,9 +2641,13 @@ expr (Loc.U):
 extensions (Extensions.U):
        This variable holds a list of all extension files (both XS and
        non-xs linked into the package.  It is propagated to Config.pm
-       and is typically used to test whether a particular extesion
+       and is typically used to test whether a particular extension
        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.
 
@@ -2458,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,
@@ -2468,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.
@@ -2768,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
@@ -2822,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>.
@@ -2859,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>.
@@ -2937,6 +3164,11 @@ i_stdarg (i_varhdr.U):
        indicates to the C program that <stdarg.h> exists and should
        be included.
 
+i_stdbool (i_stdbool.U):
+       This variable conditionally defines the I_STDBOOL symbol, which
+       indicates to the C program that <stdbool.h> exists and should
+       be included.
+
 i_stddef (i_stddef.U):
        This variable conditionally defines the I_STDDEF symbol, which
        indicates to the C program that <stddef.h> exists and should
@@ -3006,6 +3238,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>.
@@ -3132,19 +3368,32 @@ inc_version_list (inc_version_list.U):
        site_perl directory was introduced in 5.005, so that is the
        lowest possible value.
 
+       This list includes architecture-dependent directories back to
+       version $api_versionstring (e.g. 5.5.640) and
+       architecture-independent directories all the way back to
+       5.005.
+
 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
+       This variable must precede the normal include path to get the
        right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
        Value can be "" or "/bsd43" on mips.
 
 inews (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
+
+initialinstalllocation (bin.U):
+       When userelocatableinc is true, this variable holds the location
+       that make install should copy the perl binary to, with all the
+       run-time relocatable paths calculated from this at install time.
+       When used, it is initialised to the original value of binexp, and
+       then binexp is set to '.../', as the other binaries are found
+       relative to the perl binary.
 
 installarchlib (archlib.U):
        This variable is really the same as archlibexp but may differ on
@@ -3153,7 +3402,7 @@ installarchlib (archlib.U):
 
 installbin (bin.U):
        This variable is the same as binexp unless AFS is running in which case
-       the user is explicitely prompted for it. This variable should always
+       the user is explicitly prompted for it. This variable should always
        be used in your makefiles for maximum portability.
 
 installhtml1dir (html1dir.U):
@@ -3350,7 +3599,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
@@ -3432,11 +3681,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
@@ -3486,11 +3735,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
@@ -3507,17 +3756,29 @@ lseektype (lseektype.U):
        or whatever type is used to declare lseek offset's type in the
        kernel (which also appears to be lseek's return type).
 
-mad (mad.u):
+mad (mad.U):
        This variable indicates that the Misc Attribute Definition code is to
        be compiled.
 
+madlyh (mad.U):
+       If the Misc Attribute Decoration is to be compiled, this variable is
+       set to the name of the extra header files to be used, else it is ''
+
+madlyobj (mad.U):
+       If the Misc Attribute Decoration is to be compiled, this variable is
+       set to the name of the extra object files to be used, else it is ''
+
+madlysrc (mad.U):
+       If the Misc Attribute Decoration is to be compiled, this variable is
+       set to the name of the extra C source files to be used, else it is ''
+
 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
@@ -3534,7 +3795,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.
 
@@ -3583,11 +3844,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".
@@ -3627,7 +3883,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
@@ -3711,6 +3967,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.
@@ -3820,14 +4081,45 @@ path_sep (Unix.U):
        This is an old synonym for p_ in Head.U, the character
        used to separate elements in the command shell search PATH.
 
+perl (Loc.U):
+       This variable is 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
        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_API_REVISION (patchlevel.h):
+       This number describes the earliest compatible PERL_REVISION of
+       Perl ("compatibility" here being defined as sufficient binary/API
+       compatibility to run XS code built with the older version).
+       Normally this does not change across maintenance releases.
+       Please read the comment in patchlevel.h.
+
+PERL_API_SUBVERSION (patchlevel.h):
+       This number describes the earliest compatible PERL_SUBVERSION of
+       Perl ("compatibility" here being defined as sufficient binary/API
+       compatibility to run XS code built with the older version).
+       Normally this does not change across maintenance releases.
+       Please read the comment in patchlevel.h.
+
+PERL_API_VERSION (patchlevel.h):
+       This number describes the earliest compatible PERL_VERSION of
+       Perl ("compatibility" here being defined as sufficient binary/API
+       compatibility to run XS code built with the older version).
+       Normally this does not change across maintenance releases.
+       Please read the comment in patchlevel.h.
+
+PERL_CONFIG_SH (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.
+
+PERL_PATCHLEVEL (Oldsyms.U):
+       This symbol reflects the patchlevel, if available. Will usually
+       come from the .patch file, which is available when the perl
+       source tree was fetched with rsync.
 
 perl_patchlevel (patchlevel.U):
        This is the Perl patch level, a numeric change identifier,
@@ -3841,6 +4133,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
@@ -3891,11 +4193,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
@@ -3991,9 +4293,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
@@ -4045,7 +4351,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.
@@ -4089,6 +4395,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
@@ -4101,7 +4415,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
@@ -4315,11 +4629,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
@@ -4419,9 +4741,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
@@ -4433,6 +4755,13 @@ ssizetype (ssizetype.U):
        of bytes or an error condition.  It must be a signed type.
        We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
 
+st_ino_sign (st_ino_def.U):
+       This variable contains the signedness of struct stat's st_ino.
+       1 for unsigned, -1 for signed.
+
+st_ino_size (st_ino_def.U):
+       This variable contains the size of struct stat's st_ino in bytes.
+
 startperl (startperl.U):
        This variable contains the string to put on the front of a perl
        script to make sure (hopefully) that it runs with perl and not some
@@ -4441,7 +4770,7 @@ startperl (startperl.U):
        eval 'exec perl -S $0 ${1+"$@"}'
        if $running_under_some_shell;
        to guarantee perl startup should the shell execute the script. Note
-       that this magic incatation is not understood by csh.
+       that this magic incantation is not understood by csh.
 
 startsh (startsh.U):
        This variable contains the string to put on the front of a shell
@@ -4498,7 +4827,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.
@@ -4515,11 +4844,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.
@@ -4527,11 +4856,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
@@ -4576,7 +4905,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.
@@ -4640,7 +4969,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,
@@ -4664,10 +4993,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'.
@@ -4678,6 +5015,11 @@ useithreads (usethreads.U):
        and indicates that Perl should be built to use the interpreter-based
        threading implementation.
 
+usekernprocpathname (usekernprocpathname.U)
+       This variable, indicates that we can use sysctl with
+       KERN_PROC_PATHNAME to get a full path for the executable, and hence
+       convert $^X to an absolute path.
+
 uselargefiles (uselfs.U):
        This variable conditionally defines the USE_LARGE_FILES symbol,
        and indicates that large file interfaces should be used when
@@ -4703,7 +5045,7 @@ usemultiplicity (usemultiplicity.U):
 usemymalloc (mallocsrc.U):
        This variable contains y if the malloc that comes with this package
        is desired over the system's version of malloc.  People often include
-       special versions of malloc for effiency, but such versions are often
+       special versions of malloc for efficiency, but such versions are often
        less portable.  See also mallocsrc and mallocobj.
        If this is 'y', then -lmalloc is removed from $libs.
 
@@ -4711,6 +5053,11 @@ usenm (usenm.U):
        This variable contains 'true' or 'false' depending whether the
        nm extraction is wanted or not.
 
+usensgetexecutablepath (usensgetexecutablepath.U):
+       This symbol, if defined, indicates that we can use _NSGetExecutablePath
+       and realpath to get a full path for the executable, and hence convert
+       $^X to an absolute path.
+
 useopcode (Extensions.U):
        This variable holds either 'true' or 'false' to indicate
        whether the Opcode extension should be used.  The sole
@@ -4737,7 +5084,7 @@ usereentrant (usethreads.U):
        meaningful if usethreads is set and is very experimental, it is
        not even prompted for.
 
-userelocatableinc (XXX.U):
+userelocatableinc (bin.U):
        This variable is set to true to indicate that perl should relocate
        @INC entries at runtime based on the path to the perl binary.
        Any @INC paths starting ".../" are relocated relative to the directory
@@ -4747,7 +5094,7 @@ userelocatableinc (XXX.U):
 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
-       explicitely requests not to use sfio.  It is here primarily so
+       explicitly requests not to use sfio.  It is here primarily so
        that command-line settings can override the auto-detection of
        d_sfio without running into a "WHOA THERE".
 
@@ -4755,6 +5102,11 @@ useshrplib (libperl.U):
        This variable is set to 'true' if the user wishes
        to build a shared libperl, and 'false' otherwise.
 
+usesitecustomize (d_sitecustomize.U):
+       This variable is set to true when the user requires a mechanism that
+       allows the sysadmin to add entries to @INC at runtime.  This variable
+       being set, makes perl run '$sitelib/sitecustomize.pl' at startup.
+
 usesocks (usesocks.U):
        This variable conditionally defines the USE_SOCKS symbol,
        and indicates that Perl should be built to use SOCKS.
@@ -4770,7 +5122,7 @@ usevendorprefix (vendorprefix.U):
 usevfork (d_vfork.U):
        This variable is set to true when the user accepts to use vfork.
        It is set to false when no vfork is available or when the user
-       explicitely requests not to use vfork.
+       explicitly requests not to use vfork.
 
 usrinc (usrinc.U):
        This variable holds the path of the include files, which is
@@ -4778,7 +5130,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
@@ -4802,6 +5154,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.
@@ -4950,7 +5307,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,
@@ -4972,7 +5329,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