This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Add non-XS extensions to known_extensions.
[perl5.git] / Porting / Glossary
index af6fa64..1f5b8c9 100644 (file)
@@ -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.
@@ -159,6 +164,10 @@ bison (Loc.U):
        full pathname (if any) of the bison program.  After Configure runs,
        the value is reset to a plain "bison" and is not useful.
 
+bootstrap_charset (ebcdic.U):
+       This variable conditionally defines BOOTSTRAP_CHARSET if
+       this system uses non-ASCII encoding.
+
 byacc (Loc.U):
        This variable is used internally by Configure to determine the
        full pathname (if any) of the byacc program.  After Configure runs,
@@ -244,9 +253,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
@@ -255,7 +272,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,
@@ -269,7 +286,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_arg1,
+       config_arg2, 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
@@ -284,7 +318,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
@@ -389,6 +423,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()
@@ -402,6 +440,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.
@@ -489,7 +532,7 @@ d_casti32 (d_casti32.U):
 
 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
@@ -563,6 +606,10 @@ d_ctermid_r (d_ctermid_r.U):
        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()
@@ -588,6 +635,10 @@ 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
@@ -702,7 +753,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,
@@ -847,7 +898,7 @@ d_Gconvert (d_gconvert.U):
        This variable holds what Gconvert is defined as to convert
        floating point numbers into strings.  By default, Configure
        sets this macro to use the first of gconvert, gcvt, or sprintf
-       that pass sprintf-%g-like behaviour tests.  If perl is using
+       that pass sprintf-%g-like behavior tests.  If perl is using
        long doubles, the macro uses the first of the following
        functions that pass Configure's tests: qgcvt, sprintf (if
        Configure knows how to make sprintf format long doubles--see
@@ -864,6 +915,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
@@ -871,7 +945,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
@@ -966,6 +1040,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
@@ -1140,6 +1219,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()
@@ -1179,13 +1262,43 @@ 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.
 
+d_ip_mreq (d_socket.U):
+       This variable conditionally defines the HAS_IP_MREQ symbol, which
+       indicates the availability of a struct ip_mreq.
+
+d_ip_mreq_source (d_socket.U):
+       This variable conditionally defines the HAS_IP_MREQ_SOURCE symbol,
+       which indicates the availability of a struct ip_mreq_source.
+
+d_ipv6_mreq (d_socket.U):
+       This variable conditionally defines the HAS_IPV6_MREQ symbol, which
+       indicates the availability of a struct ipv6_mreq.
+
+d_ipv6_mreq_source (d_socket.U):
+       This variable conditionally defines the HAS_IPV6_MREQ_SOURCE symbol,
+       which indicates the availability of a struct ipv6_mreq_source.
+
 d_isascii (d_isascii.U):
        This variable conditionally defines the HAS_ISASCII constant,
        which indicates to the C program that isascii() is available.
 
+d_isblank (d_isblank.U):
+       This variable conditionally defines the HAS_ISBLANK constant,
+       which indicates to the C program that isblank() is available.
+
 d_isfinite (d_isfinite.U):
        This variable conditionally defines the HAS_ISFINITE symbol, which
        indicates to the C program that the isfinite() routine is available.
@@ -1226,6 +1339,10 @@ 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()
@@ -1306,7 +1423,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
@@ -1342,6 +1459,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.
@@ -1437,6 +1558,15 @@ d_ndbm (i_ndbm.U):
        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.
@@ -1511,43 +1641,52 @@ 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
@@ -1555,20 +1694,20 @@ d_printf_format_null (d_attribut.U):
 
 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.
 
@@ -1718,7 +1857,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
@@ -1956,6 +2095,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
@@ -1966,6 +2110,15 @@ d_snprintf (d_snprintf.U):
        indicates to the C program that the snprintf () library function
        is available.
 
+d_sockaddr_in6 (d_socket.U):
+       This variable conditionally defines the HAS_SOCKADDR_IN6 symbol, which
+       indicates the availability of a struct sockaddr_in6.
+
+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.
@@ -2038,6 +2191,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.
@@ -2087,9 +2246,9 @@ d_strctcpy (d_strctcpy.U):
        structures.
 
 d_strerrm (d_strerror.U):
-       This variable holds what Strerrr is defined as to translate an error
+       This variable holds what Strerror is defined as to translate an error
        code condition into an error message string. It could be 'strerror'
-       or a more complex macro emulating strrror with sys_errlist[], or the
+       or a more complex macro emulating strerror with sys_errlist[], or the
        "unknown" string when both strerror and sys_errlist are missing.
 
 d_strerror (d_strerror.U):
@@ -2210,12 +2369,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):
@@ -2317,7 +2480,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
@@ -2399,7 +2562,7 @@ direntrytype (i_dirent.U):
 
 dlext (dlext.U):
        This variable contains the extension that is to be used for the
-       dynamically loaded modules that perl generaties.
+       dynamically loaded modules that perl generates.
 
 dlsrc (dlsrc.U):
        This variable contains the name of the dynamic loading file that
@@ -2436,9 +2599,7 @@ eagain (nblock_io.U):
 
 ebcdic (ebcdic.U):
        This variable conditionally defines EBCDIC if this
-       system uses EBCDIC encoding.  Among other things, this
-       means that the character ranges are not contiguous.
-       See trnl.U
+       system uses EBCDIC encoding.
 
 echo (Loc.U):
        This variable is used internally by Configure to determine the
@@ -2452,7 +2613,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.
@@ -2505,10 +2666,14 @@ 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
+       non-xs) installed with the package.  It is propagated to Config.pm
+       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.
 
@@ -2525,7 +2690,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,
@@ -2535,7 +2700,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.
@@ -3025,6 +3190,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
@@ -3235,19 +3405,19 @@ inc_version_list_init (inc_version_list.U):
        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
+       When used, it is initialized to the original value of binexp, and
        then binexp is set to '.../', as the other binaries are found
        relative to the perl binary.
 
@@ -3258,7 +3428,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):
@@ -3450,12 +3620,16 @@ ivtype (perlxv.U):
        This variable contains the C type used for Perl's IV.
 
 known_extensions (Extensions.U):
-       This variable holds a list of all XS extensions included in
-       the package.
+       This variable holds a list of all extensions (both XS and non-xs)
+       included in the package source distribution.  This information is
+       only really of use during the Perl build, as the list makes no
+       distinction between extensions which were build and installed, and
+       those which where not.  See "extensions" for the list of extensions
+       actually built and available.
 
 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
@@ -3463,6 +3637,11 @@ ld (dlsrc.U):
        On ELF systems, it should be $cc.  Mostly, we'll try to respect
        the hint file setting.
 
+ld_can_script (dlsrc.U):
+       This variable shows if the loader accepts scripts in the form of
+       -Wl,--version-script=ld.script. This is currently only supported
+       for GNU ld on ELF in dynamic loading builds.
+
 lddlflags (dlsrc.U):
        This variable contains any special flags that might need to be
        passed to $ld to create a shared library suitable for dynamic
@@ -3537,11 +3716,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
@@ -3591,11 +3770,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
@@ -3630,11 +3809,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
@@ -3651,7 +3830,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.
 
@@ -3739,7 +3918,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
@@ -3759,9 +3938,9 @@ myhostname (myhostname.U):
        The dot comes with mydomain, and need not be supplied by the program.
 
 myuname (Oldconfig.U):
-       The output of 'uname -a' if available, otherwise the hostname. On Xenix,
-       pseudo variables assignments in the output are stripped, thank you. The
-       whole thing is then lower-cased.
+       The output of 'uname -a' if available, otherwise the hostname.
+       The whole thing is then lower-cased and slashes and single quotes are
+       removed.
 
 n (n.U):
        This variable contains the '-n' flag if that is what causes the echo
@@ -3815,8 +3994,10 @@ nm_so_opt (usenm.U):
        Maybe Linux should just always set usenm=false.
 
 nonxs_ext (Extensions.U):
-       This variable holds a list of all non-xs extensions included
-       in the package.  All of them will be built.
+       This variable holds a list of all non-xs extensions built and
+       installed by the package.  By default, all non-xs extensions
+       distributed will be built, with the exception of platform-specific
+       extensions (currently only one VMS specific extension).
 
 nroff (Loc.U):
        This variable is used internally by Configure to determine the
@@ -3841,11 +4022,11 @@ nvEUformat (perlxvf.U):
        a Perl NV using %E-ish floating point format.
 
 nvfformat (perlxvf.U):
-       This variable confains the format string used for printing
+       This variable contains the format string used for printing
        a Perl NV using %f-ish floating point format.
 
 nvFUformat (perlxvf.U):
-       This variable confains the format string used for printing
+       This variable contains the format string used for printing
        a Perl NV using %F-ish floating point format.
 
 nvgformat (perlxvf.U):
@@ -3938,8 +4119,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
@@ -3988,6 +4170,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
@@ -4038,11 +4230,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
@@ -4072,7 +4264,7 @@ procselfexe (d_procselfexe.U):
 
 prototype (prototype.U):
        This variable holds the eventual value of CAN_PROTOTYPE, which
-       indicates the C compiler can handle funciton prototypes.
+       indicates the C compiler can handle function prototypes.
 
 ptrsize (ptrsize.U):
        This variable contains the value of the PTRSIZE symbol, which
@@ -4144,7 +4336,7 @@ rm_try (Unix.U):
 
 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
@@ -4196,7 +4388,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.
@@ -4240,6 +4432,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
@@ -4252,7 +4452,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
@@ -4466,11 +4666,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
@@ -4584,6 +4792,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
@@ -4592,7 +4807,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
@@ -4649,7 +4864,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.
@@ -4666,11 +4881,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.
@@ -4678,11 +4893,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
@@ -4727,7 +4942,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.
@@ -4815,6 +5030,10 @@ 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.
@@ -4833,6 +5052,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
@@ -4858,7 +5082,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.
 
@@ -4866,6 +5090,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
@@ -4902,7 +5131,7 @@ userelocatableinc (bin.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".
 
@@ -4927,10 +5156,14 @@ usevendorprefix (vendorprefix.U):
        This variable tells whether the vendorprefix
        and consequently other vendor* paths are in use.
 
+useversionedarchname (archname.U):
+       This variable indicates whether to include the $api_versionstring
+       as a component of the $archname.
+
 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
@@ -4938,7 +5171,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
@@ -4962,6 +5195,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.
@@ -5110,7 +5348,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,
@@ -5132,7 +5370,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