This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Regenerate Configure.
[perl5.git] / Porting / Glossary
index c1b8758..46fb810 100644 (file)
@@ -33,21 +33,23 @@ ansi2knr (ansi2knr.U):
        Currently, this is not supported, so we just abort.
 
 aphostname (d_gethname.U):
-       Thie variable contains the command which can be used to compute the
+       This variable contains the command which can be used to compute the
        host name. The command is fully qualified by its absolute path, to make
        it safe when used by a process with super-user privileges.
 
 apiversion (patchlevel.U):
-       This is a number which identifies the lowest version of perl
-       to have an API (for XS extensions) compatible with the present
-       version.  For example, for 5.005_01, the apiversion should be
-       5.005, since 5.005_01 should be binary compatible with 5.005.
-       This should probably be incremented manually somehow, perhaps
-       from patchlevel.h.  For now, we'll guess maintenance subversions
-       will retain binary compatibility.
+       MakeMaker will install add-on modules in a directory with the
+       PERL_APIVERSION version number.  The value is set manually in
+       patchlevel.h.  Normally, for maintenance releases, this is
+       just something like 5.005 or 5.6 or 5.7.  That is, it does not
+       include the subversion number and does not change across
+       maintenance releases.  This is so that add-on extensions can
+       be shared across maintenance versions.  It is unclear how this
+       ought to work for developer versions.  If a release breaks
+       binary compatibility, this number should be increased.
 
 ar (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the ar program.  After Configure runs,
        the value is reset to a plain "ar" and is not useful.
 
@@ -77,7 +79,7 @@ archobjs (Unix.U):
        include os2/os2.obj.
 
 awk (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the awk program.  After Configure runs,
        the value is reset to a plain "awk" and is not useful.
 
@@ -94,6 +96,10 @@ bin (bin.U):
        is most often a local directory such as /usr/local/bin. Programs using
        this variable must be prepared to deal with ~name substitution.
 
+bincompat5005 (bincompat5005.U):
+       This variable contains y if Perl 5.006 should be binary-compatible
+       with Perl 5.005.
+
 binexp (bin.U):
        This is the same as the bin variable, but is filename expanded at
        configuration time, for use in your makefiles.
@@ -103,7 +109,7 @@ bison (Loc.U):
        The value is a plain '' and is not useful.
 
 byacc (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the byacc program.  After Configure runs,
        the value is reset to a plain "byacc" and is not useful.
 
@@ -127,7 +133,7 @@ castflags (d_castneg.U):
        4 = couldn't cast in argument expression list
 
 cat (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the cat program.  After Configure runs,
        the value is reset to a plain "cat" and is not useful.
 
@@ -188,7 +194,7 @@ clocktype (d_times.U):
        included).
 
 comm (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the comm program.  After Configure runs,
        the value is reset to a plain "comm" and is not useful.
 
@@ -203,7 +209,7 @@ contains (contains.U):
        is primarily for the use of other Configure units.
 
 cp (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the cp program.  After Configure runs,
        the value is reset to a plain "cp" and is not useful.
 
@@ -212,7 +218,7 @@ cpio (Loc.U):
        The value is a plain '' and is not useful.
 
 cpp (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the cpp program.  After Configure runs,
        the value is reset to a plain "cpp" and is not useful.
 
@@ -260,13 +266,18 @@ cppsymbols (Cppsym.U):
        not in this list, see ccsymbols and cppccsymbols.
        The list is a space-separated list of symbol=value tokens.
 
+crosscompile (crosscompile.U):
+       This variable conditionally defines the CROSSCOMPILE symbol
+       which signifies that the build process is be a cross-compilation.
+       This is normally set by hints files or from Configure command line.
+
 cryptlib (d_crypt.U):
        This variable holds -lcrypt or the path to a libcrypt.a archive if
        the crypt() function is not defined in the standard C library. It is
        up to the Makefile to use this.
 
 csh (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the csh program.  After Configure runs,
        the value is reset to a plain "csh" and is not useful.
 
@@ -287,6 +298,14 @@ d_archlib (archlib.U):
        of architecture-dependent library files for $package.  If
        $archlib is the same as $privlib, then this is set to undef.
 
+d_atolf (atolf.U):
+       This variable conditionally defines the HAS_ATOLF symbol, which
+       indicates to the C program that the atolf() routine is available.
+
+d_atoll (atoll.U):
+       This variable conditionally defines the HAS_ATOLL symbol, which
+       indicates to the C program that the atoll() routine is available.
+
 d_attribut (d_attribut.U):
        This variable conditionally defines HASATTRIBUTE, which
        indicates the C compiler can check for function attributes,
@@ -300,6 +319,12 @@ d_bcopy (d_bcopy.U):
        This variable conditionally defines the HAS_BCOPY symbol if
        the bcopy() routine is available to copy strings.
 
+d_bincompat5005 (bincompat5005.U):
+       This variable conditionally defines BINCOMPAT5005 so that embed.h
+       can take special action if Perl 5.006 should be binary-compatible
+       with Perl 5.005.  This is impossible for builds that use features
+       like threads and multiplicity it is always $undef for those versions.
+
 d_bsd (Guess.U):
        This symbol conditionally defines the symbol BSD when running on a
        BSD system.
@@ -375,25 +400,10 @@ d_dbl_dig (d_dbl_dig.U):
        header files provide DBL_DIG, which is the number of significant
        digits in a double precision number.
 
-d_dbmclose64 (dbm64.U):
-       This variable conditionally defines the HAS_DBMCLOSE64 symbol, which
-       indicates to the C program that the dbmclose64() routine is available.
-
-d_dbminit64 (dbm64.U):
-       This variable conditionally defines the HAS_DBMINIT64 symbol, which
-       indicates to the C program that the dbminit64() routine is available.
-
-d_delete64 (dbm64.U):
-       This variable conditionally defines the HAS_DELETE64 symbol, which
-       indicates to the C program that the delete64() routine is available.
-
 d_difftime (d_difftime.U):
        This variable conditionally defines the HAS_DIFFTIME symbol, which
        indicates to the C program that the difftime() routine is available.
 
-d_dirent64_s (io64.U):
-       This symbol will be defined if the C compiler supports struct dirent64.
-
 d_dirnamlen (i_dirent.U):
        This variable conditionally defines DIRNAMLEN, which indicates
        to the C program that the length of directory entry names is
@@ -457,6 +467,10 @@ d_endsent (d_endsent.U):
        This variable conditionally defines HAS_ENDSERVENT if endservent() is
        available to close whatever was being used for service queries.
 
+d_endspent (d_endspent.U):
+       This variable conditionally defines HAS_ENDSPENT if endspent() is
+       available to finalize the scan of SysV shadow password entries.
+
 d_eofnblk (nblock_io.U):
        This variable conditionally defines EOF_NONBLOCK if EOF can be seen
        when reading from a non-blocking I/O source.
@@ -495,37 +509,18 @@ d_fds_bits (d_fd_set.U):
        a half-fast job and neglected to provide the macros to manipulate
        an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
 
-d_fetch64 (dbm64.U):
-       This variable conditionally defines the HAS_FETCH64 symbol, which
-       indicates to the C program that the fetch64() routine is available.
-
-d_fgetpos64 (stdio64.U):
-       This variable conditionally defines the HAS_FGETPOS64 symbol, which
-       indicates to the C program that the fgetpos64() routine is available.
-
 d_fgetpos (d_fgetpos.U):
        This variable conditionally defines HAS_FGETPOS if fgetpos() is
        available to get the file position indicator.
 
-d_firstkey64 (dbm64.U):
-       This variable conditionally defines the HAS_FIRSTKEY64 symbol, which
-       indicates to the C program that the firstkey64() routine is available.
-
 d_flexfnam (d_flexfnam.U):
        This variable conditionally defines the FLEXFILENAMES symbol, which
        indicates that the system supports filenames longer than 14 characters.
 
-d_flock64_s (io64.U):
-       This symbol will be defined if the C compiler supports struct flock64.
-
 d_flock (d_flock.U):
        This variable conditionally defines HAS_FLOCK if flock() is
        available to do file locking.
 
-d_fopen64 (stdio64.U):
-       This variable conditionally defines the HAS_FOPEN64 symbol, which
-       indicates to the C program that the fopen64() routine is available.
-
 d_fork (d_fork.U):
        This variable conditionally defines the HAS_FORK symbol, which
        indicates to the C program that the fork() routine is available.
@@ -536,34 +531,17 @@ d_fpathconf (d_pathconf.U):
        to determine file-system related limits and options associated
        with a given open file descriptor.
 
-d_freopen64 (stdio64.U):
-       This variable conditionally defines the HAS_FREOPEN64 symbol, which
-       indicates to the C program that the freopen64() routine is available.
-
-d_fseek64 (stdio64.U):
-       This variable conditionally defines the HAS_FSEEK64 symbol, which
-       indicates to the C program that the fseek64() routine is available.
-
-d_fseeko64 (stdio64.U):
-       This variable conditionally defines the HAS_FSEEKO64 symbol, which
-       indicates to the C program that the fseeko64() routine is available.
+d_fpos64_t (io64.U):
+       This symbol will be defined if the C compiler supports fpos64_t.
 
 d_fseeko (d_fseeko.U):
        This variable conditionally defines the HAS_FSEEKO symbol, which
        indicates to the C program that the fseeko() routine is available.
 
-d_fsetpos64 (stdio64.U):
-       This variable conditionally defines the HAS_FSETPOS64 symbol, which
-       indicates to the C program that the fsetpos64() routine is available.
-
 d_fsetpos (d_fsetpos.U):
        This variable conditionally defines HAS_FSETPOS if fsetpos() is
        available to set the file position indicator.
 
-d_fstat64 (io64.U):
-       This variable conditionally defines the HAS_FSTAT64 symbol, which
-       indicates to the C program that the fstat64() routine is available.
-
 d_fstatfs (d_statfs.U):
        This variable conditionally defines the HAS_FSTATFS symbol, which
        indicates to the C program that the fstatfs() routine is available.
@@ -572,14 +550,6 @@ d_fstatvfs (d_statvfs.U):
        This variable conditionally defines the HAS_FSTATVFS symbol, which
        indicates to the C program that the fstatvfs() routine is available.
 
-d_ftell64 (stdio64.U):
-       This variable conditionally defines the HAS_FTELL64 symbol, which
-       indicates to the C program that the ftell64() routine is available.
-
-d_ftello64 (stdio64.U):
-       This variable conditionally defines the HAS_FTELLO64 symbol, which
-       indicates to the C program that the ftello64() routine is available.
-
 d_ftello (d_ftello.U):
        This variable conditionally defines the HAS_FTELLO symbol, which
        indicates to the C program that the ftello() routine is available.
@@ -589,10 +559,6 @@ d_ftime (d_ftime.U):
        that the ftime() routine exists.  The ftime() routine is basically
        a sub-second accuracy clock.
 
-d_ftruncate64 (io64.U):
-       This variable conditionally defines the HAS_FTRUNCATE64 symbol, which
-       indicates to the C program that the ftruncate64() routine is available.
-
 d_Gconvert (d_gconvert.U):
        This variable holds what Gconvert is defined as to convert
        floating point numbers into strings. It could be 'gconvert'
@@ -739,6 +705,14 @@ d_getservprotos (d_getservprotos.U):
        prototypes for the various getserv*() functions.  
        See also netdbtype.U for probing for various netdb types.
 
+d_getspent (d_getspent.U):
+       This variable conditionally defines HAS_GETSPENT if getspent() is
+       available to retrieve SysV shadow password entries sequentially.
+
+d_getspnam (d_getspnam.U):
+       This variable conditionally defines HAS_GETSPNAM if getspnam() is
+       available to retrieve SysV shadow password entries by name.
+
 d_gettimeod (d_ftime.U):
        This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
        indicates that the gettimeofday() system call exists (to obtain a
@@ -769,9 +743,6 @@ 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_ino64t (io64.U):
-       This symbol will be defined if the C compiler supports ino64_t.
-
 d_int64t (i_inttypes.U):
        This symbol will be defined if the C compiler supports int64_t.
 
@@ -793,18 +764,23 @@ d_lchown (d_lchown.U):
        indicates to the C program that the lchown() routine is available
        to operate on a symbolic link (instead of following the link).
 
+d_ldbl_dig (d_ldbl_dig.U):
+       This variable conditionally defines d_ldbl_dig if this system's
+       header files provide LDBL_DIG, which is the number of significant
+       digits in a long double precision number.
+
 d_link (d_link.U):
        This variable conditionally defines HAS_LINK if link() is
        available to create hard links.
 
+d_llseek (io64.U):
+       This variable conditionally defines the HAS_LLSEEK symbol, which
+       indicates to the C program that the llseek() routine is available.
+
 d_locconv (d_locconv.U):
        This variable conditionally defines HAS_LOCALECONV if localeconv() is
        available for numeric and monetary formatting conventions.
 
-d_lockf64 (io64.U):
-       This variable conditionally defines the HAS_LOCKF64 symbol, which
-       indicates to the C program that the lockf64() routine is available.
-
 d_lockf (d_lockf.U):
        This variable conditionally defines HAS_LOCKF if lockf() is
        available to do file locking.
@@ -817,14 +793,6 @@ d_longlong (d_longlong.U):
        This variable conditionally defines HAS_LONG_LONG if 
        the long long type is supported.
 
-d_lseek64 (io64.U):
-       This variable conditionally defines the HAS_LSEEK64 symbol, which
-       indicates to the C program that the lseek64() routine is available.
-
-d_lstat64 (io64.U):
-       This variable conditionally defines the HAS_LSTAT64 symbol, which
-       indicates to the C program that the lstat64() routine is available.
-
 d_lstat (d_lstat.U):
        This variable conditionally defines HAS_LSTAT if lstat() is
        available to do file stats on symbolic links.
@@ -848,6 +816,11 @@ d_mbtowc (d_mbtowc.U):
        indicates to the C program that the mbtowc() routine is available
        to convert multibyte to a wide character.
 
+d_memchr (d_memchr.U):
+       This variable conditionally defines the HAS_MEMCHR symbol, which
+       indicates to the C program that the memchr() routine is available
+       to locate characters within a C string.
+
 d_memcmp (d_memcmp.U):
        This variable conditionally defines the HAS_MEMCMP symbol, which
        indicates to the C program that the memcmp() routine is available
@@ -951,15 +924,11 @@ d_mymalloc (mallocsrc.U):
        of the source want to take special action if MYMALLOC is used.
        This may include different sorts of profiling or error detection.
 
-d_nextkey64 (dbm64.U):
-       This variable conditionally defines the HAS_NEXTKEY64 symbol, which
-       indicates to the C program that the nextkey64() routine is available.
-
 d_nice (d_nice.U):
        This variable conditionally defines the HAS_NICE symbol, which
        indicates to the C program that the nice() routine is available.
 
-d_off64t (io64.U):
+d_off64_t (io64.U):
        This symbol will be defined if the C compiler supports off64_t.
 
 d_old_pthread_create_joinable (d_pthrattrj.U):
@@ -969,7 +938,7 @@ d_old_pthread_create_joinable (d_pthrattrj.U):
 d_oldpthreads (usethreads.U):
        This variable conditionally defines the OLD_PTHREADS_API symbol,
        and indicates that Perl should be built to use the old
-       draft POSIX threads API.  This is only potneially meaningful if
+       draft POSIX threads API.  This is only potentially meaningful if
        usethreads is set.
 
 d_oldsock (d_socket.U):
@@ -981,14 +950,6 @@ d_open3 (d_open3.U):
        which indicates to the C program that the 3 argument version of
        the open(2) function is available.
 
-d_open64 (io64.U):
-       This variable conditionally defines the HAS_OPEN64 symbol, which
-       indicates to the C program that the open64() routine is available.
-
-d_opendir64 (io64.U):
-       This variable conditionally defines the HAS_OPENDIR64 symbol, which
-       indicates to the C program that the opendir64() routine is available.
-
 d_pathconf (d_pathconf.U):
        This variable conditionally defines the HAS_PATHCONF symbol, which
        indicates to the C program that the pathconf() routine is available
@@ -1001,7 +962,7 @@ d_pause (d_pause.U):
        to suspend a process until a signal is received.
 
 d_phostname (d_gethname.U):
-       This variable conditionally defines the PHOSTNAME symbol, which
+       This variable conditionally defines the HAS_PHOSTNAME symbol, which
        contains the shell command which, when fed to popen(), may be
        used to derive the host name.
 
@@ -1020,6 +981,55 @@ d_portable (d_portable.U):
        indicates to the C program that it should not assume that it is
        running on the machine it was compiled on.
 
+d_PRId64 (quadfio.U):
+       This variable conditionally defines the PERL_PRId64 symbol, which
+       indiciates that stdio has a symbol to print 64-bit decimal numbers.
+
+d_PRIeldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+       indiciates that stdio has a symbol to print long doubles.
+
+d_PRIEldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+       indiciates that stdio has a symbol to print long doubles.
+
+d_PRIfldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+       indiciates that stdio has a symbol to print long doubles.
+
+d_PRIFldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+       indiciates that stdio has a symbol to print long doubles.
+
+d_PRIgldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+       indiciates that stdio has a symbol to print long doubles.
+
+d_PRIGldbl (longdblfio.U):
+       This variable conditionally defines the PERL_PRIfldlbl symbol, which
+       indiciates that stdio has a symbol to print long doubles.
+
+d_PRIi64 (quadfio.U):
+       This variable conditionally defines the PERL_PRIi64 symbol, which
+       indiciates that stdio has a symbol to print 64-bit decimal numbers.
+
+d_PRIo64 (quadfio.U):
+       This variable conditionally defines the PERL_PRIo64 symbol, which
+       indiciates that stdio has a symbol to print 64-bit octal numbers.
+
+d_PRIu64 (quadfio.U):
+       This variable conditionally defines the PERL_PRIu64 symbol, which
+       indiciates that stdio has a symbol to print 64-bit unsigned decimal
+       numbers.
+
+d_PRIx64 (quadfio.U):
+       This variable conditionally defines the PERL_PRIx64 symbol, which
+       indiciates that stdio has a symbol to print 64-bit hexadecimal numbers.
+
+d_PRIX64 (quadfio.U):
+       This variable conditionally defines the PERL_PRIX64 symbol, which
+       indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers.
+
 d_pthread_yield (d_pthread_y.U):
        This variable conditionally defines the HAS_PTHREAD_YIELD
        symbol if the pthread_yield routine is available to yield
@@ -1057,10 +1067,6 @@ d_pwquota (i_pwd.U):
        This variable conditionally defines PWQUOTA, which indicates
        that struct passwd contains pw_quota.
 
-d_readdir64 (io64.U):
-       This variable conditionally defines the HAS_READDIR64 symbol, which
-       indicates to the C program that the readdir64() routine is available.
-
 d_readdir (d_readdir.U):
        This variable conditionally defines HAS_READDIR if readdir() is
        available to read directory entries.
@@ -1114,10 +1120,6 @@ d_scm_rights (d_socket.U):
        which indicates that the SCM_RIGHTS is available.  #ifdef is
        not enough because it may be an enum, glibc has been known to do this.
 
-d_seekdir64 (io64.U):
-       This variable conditionally defines the HAS_SEEKDIR64 symbol, which
-       indicates to the C program that the seekdir64() routine is available.
-
 d_seekdir (d_readdir.U):
        This variable conditionally defines HAS_SEEKDIR if seekdir() is
        available.
@@ -1135,11 +1137,11 @@ d_semctl (d_semctl.U):
        This variable conditionally defines the HAS_SEMCTL symbol, which
        indicates to the C program that the semctl() routine is available.
 
-d_semctl_semid_ds (d_union_senum.U):
+d_semctl_semid_ds (d_union_semun.U):
        This variable conditionally defines USE_SEMCTL_SEMID_DS, which
        indicates that struct semid_ds * is to be used for semctl IPC_STAT.
 
-d_semctl_semun (d_union_senum.U):
+d_semctl_semun (d_union_semun.U):
        This variable conditionally defines USE_SEMCTL_SEMUN, which
        indicates that union semun is to be used for semctl IPC_STAT.
 
@@ -1257,6 +1259,10 @@ d_setsid (d_setsid.U):
        This variable conditionally defines HAS_SETSID if setsid() is
        available to set the process group ID.
 
+d_setspent (d_setspent.U):
+       This variable conditionally defines HAS_SETSPENT if setspent() is
+       available to initialize the scan of SysV shadow password entries.
+
 d_setvbuf (d_setvbuf.U):
        This variable conditionally defines the HAS_SETVBUF symbol, which
        indicates to the C program that the setvbuf() routine is available
@@ -1308,10 +1314,6 @@ d_sockpair (d_socket.U):
        This variable conditionally defines the HAS_SOCKETPAIR symbol, which
        indicates that the BSD socketpair() is supported.
 
-d_stat64 (io64.U):
-       This variable conditionally defines the HAS_STAT64 symbol, which
-       indicates to the C program that the stat64() routine is available.
-
 d_statblks (d_statblks.U):
        This variable conditionally defines USE_STAT_BLOCKS
        if this system has a stat structure declaring
@@ -1339,6 +1341,10 @@ d_stdio_ptr_lval (d_stdstdio.U):
        This variable conditionally defines STDIO_PTR_LVALUE if the
        FILE_ptr macro can be used as an lvalue.
 
+d_stdio_stream_array (stdio_streams.U):
+       This variable tells whether there is an array holding
+       the stdio streams.
+
 d_stdiobase (d_stdstdio.U):
        This variable conditionally defines USE_STDIO_BASE if this system
        has a FILE structure declaring a usable _base field (or equivalent)
@@ -1349,10 +1355,6 @@ d_stdstdio (d_stdstdio.U):
        has a FILE structure declaring usable _ptr and _cnt fields (or
        equivalent) in stdio.h.
 
-d_store64 (dbm64.U):
-       This variable conditionally defines the HAS_STORE64 symbol, which
-       indicates to the C program that the store64() routine is available.
-
 d_strchr (d_strchr.U):
        This variable conditionally defines HAS_STRCHR if strchr() and
        strrchr() are available for string searching.
@@ -1391,6 +1393,10 @@ d_strtoul (d_strtoul.U):
        indicates to the C program that the strtoul() routine is available
        to provide conversion of strings to unsigned long.
 
+d_strtoull (strtoull.U):
+       This variable conditionally defines the HAS_STRTOULL symbol, which
+       indicates to the C program that the strtoull() routine is available.
+
 d_strxfrm (d_strxfrm.U):
        This variable conditionally defines HAS_STRXFRM if strxfrm() is
        available to transform strings.
@@ -1435,10 +1441,6 @@ d_tcsetpgrp (d_tcstpgrp.U):
        indicates to the C program that the tcsetpgrp() routine is available
        to set foreground process group ID.
 
-d_telldir64 (io64.U):
-       This variable conditionally defines the HAS_TELLDIR64 symbol, which
-       indicates to the C program that the telldir64() routine is available.
-
 d_telldir (d_readdir.U):
        This variable conditionally defines HAS_TELLDIR if telldir() is
        available.
@@ -1459,14 +1461,6 @@ d_times (d_times.U):
        that the times() routine exists.  The times() routine is normaly
        provided on UNIX systems. You may have to include <sys/times.h>.
 
-d_tmpfile64 (stdio64.U):
-       This variable conditionally defines the HAS_TMPFILE64 symbol, which
-       indicates to the C program that the tmpfile64() routine is available.
-
-d_truncate64 (io64.U):
-       This variable conditionally defines the HAS_TRUNCATE64 symbol, which
-       indicates to the C program that the truncate64() routine is available.
-
 d_truncate (d_truncate.U):
        This variable conditionally defines HAS_TRUNCATE if truncate() is
        available to truncate files.
@@ -1485,10 +1479,13 @@ d_uname (d_gethname.U):
        indicates to the C program that the uname() routine may be
        used to derive the host name.
 
-d_union_semun (d_union_senum.U):
+d_union_semun (d_union_semun.U):
        This variable conditionally defines HAS_UNION_SEMUN if the
        union semun is defined by including <sys/sem.h>.
 
+d_vendorlib (vendorlib.U):
+       This variable conditionally defines PERL_VENDORLIB.
+
 d_vfork (d_vfork.U):
        This variable conditionally defines the HAS_VFORK symbol, which
        indicates the vfork() routine is available.
@@ -1545,7 +1542,7 @@ d_xenix (Guess.U):
        the C program that it runs under Xenix.
 
 date (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the date program.  After Configure runs,
        the value is reset to a plain "date" and is not useful.
 
@@ -1602,12 +1599,12 @@ ebcdic (ebcdic.U):
        See trnl.U
 
 echo (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the echo program.  After Configure runs,
        the value is reset to a plain "echo" and is not useful.
 
 egrep (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the egrep program.  After Configure runs,
        the value is reset to a plain "egrep" and is not useful.
 
@@ -1624,7 +1621,7 @@ exe_ext (Unix.U):
        This is an old synonym for _exe.
 
 expr (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the expr program.  After Configure runs,
        the value is reset to a plain "expr" and is not useful.
 
@@ -1634,6 +1631,17 @@ extensions (Extensions.U):
        and is typically used to test whether a particular extesion 
        is available.
 
+fflushall (fflushall.U):
+       This symbol, if defined, tells that to flush
+       all pending stdio output one must loop through all
+       the stdio file handles stored in an array and fflush them.
+       Note that if fflushNULL is defined, fflushall will not
+       even be probed for and will be left undefined.
+
+fflushNULL (fflushall.U):
+       This symbol, if defined, tells that fflush(NULL) does flush
+       all pending stdio output.
+
 find (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
@@ -1691,7 +1699,7 @@ glibpth (libpth.U):
        this platform, libpth is the cleaned-up version.
 
 grep (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the grep program.  After Configure runs,
        the value is reset to a plain "grep" and is not useful.
 
@@ -1707,7 +1715,7 @@ groupstype (groupstype.U):
        gidtype (gid_t), but sometimes it isn't.
 
 gzip (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the gzip program.  After Configure runs,
        the value is reset to a plain "gzip" and is not useful.
 
@@ -1831,6 +1839,10 @@ i_neterrno (i_neterrno.U):
        indicates to the C program that <net/errno.h> exists and should
        be included.
 
+i_netinettcp (i_netinettcp.U):
+       This variable conditionally defines the I_NETINET_TCP symbol,
+       and indicates whether a C program should include <netinet/tcp.h>.
+
 i_niin (i_niin.U):
        This variable conditionally defines I_NETINET_IN, which indicates
        to the C program that it should include <netinet/in.h>. Otherwise,
@@ -1840,6 +1852,10 @@ i_poll (i_poll.U):
        This variable conditionally defines the I_POLL symbol, and indicates
        whether a C program should include <poll.h>.
 
+i_pthread (i_pthread.U):
+       This variable conditionally defines the I_PTHREAD symbol,
+       and indicates whether a C program should include <pthread.h>.
+
 i_pwd (i_pwd.U):
        This variable conditionally defines I_PWD, which indicates
        to the C program that it should include <pwd.h>.
@@ -1858,6 +1874,14 @@ i_sgtty (i_termio.U):
        indicates to the C program that it should include <sgtty.h> rather
        than <termio.h>.
 
+i_shadow (i_shadow.U):
+       This variable conditionally defines the I_SHADOW symbol, and indicates
+       whether a C program should include <shadow.h>.
+
+i_socks (i_socks.U):
+       This variable conditionally defines the I_SOCKS symbol, and indicates
+       whether a C program should include <socks.h>.
+
 i_stdarg (i_varhdr.U):
        This variable conditionally defines the I_STDARG symbol, which
        indicates to the C program that <stdarg.h> exists and should
@@ -2051,6 +2075,18 @@ installman3dir (man3dir.U):
        man3direxp only points to the read-only access location. For extra
        portability, you should only use this variable within your makefiles.
 
+installprefix (installprefix.U):
+       This variable holds the name of the directory below which 
+       "make install" will install the package.  For most users, this
+       is the same as prefix.  However, it is useful for
+       installing the software into a different (usually temporary)
+       location after which it can be bundled up and moved somehow
+       to the final location specified by prefix.
+
+installprefixexp (installprefix.U):
+       This variable holds the full absolute path of installprefix
+       with all ~-expansion done.
+
 installprivlib (privlib.U):
        This variable is really the same as privlibexp but may differ on
        those systems using AFS. For extra portability, only this variable
@@ -2071,11 +2107,34 @@ installsitelib (sitelib.U):
        those systems using AFS. For extra portability, only this variable
        should be used in makefiles.
 
+installstyle (installstyle.U):
+       This variable describes the "style" of the perl installation.
+       This is intended to be useful for tools that need to
+       manipulate entire perl distributions.  Perl itself doesn't use
+       this to find its libraries -- the library directories are
+       stored directly in Config.pm.  Currently, there are only two
+       styles:  "lib" and "lib/perl5".  The default library locations
+       (e.g. privlib, sitelib) are either $prefix/lib or
+       $prefix/lib/perl5.  The former is useful if $prefix is a
+       directory dedicated to perl (e.g. /opt/perl), while the latter
+       is useful if $prefix is shared by many packages, e.g. if
+       $prefix=/usr/local.
+               This may later be extended to include other information, so
+       be careful with pattern-matching on the results.
+               For compatibility with perl5.005 and earlier, the default
+       setting is based on whether or not $prefix contains the string
+       "perl".
+
 installusrbinperl (instubperl.U):
        This variable tells whether Perl should be installed also as
        /usr/bin/perl in addition to
        $installbin/perl
 
+installvendorlib (vendorlib.U):
+       This variable is really the same as vendorlibexp but may differ on
+       those systems using AFS. For extra portability, only this variable
+       should be used in makefiles.
+
 intsize (intsize.U):
        This variable contains the value of the INTSIZE symbol, which
        indicates to the C program how many bytes there are in an int.
@@ -2109,8 +2168,13 @@ ldflags (ccflags.U):
        This variable contains any additional C loader flags desired by
        the user.  It is up to the Makefile to use this.
 
+ldlibpthname (libperl.U):
+       This variable holds the name of the shared library
+       search path, often LD_LIBRARY_PATH.  To get an empty
+       string, the hints file must set this to 'none'.
+
 less (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the less program.  After Configure runs,
        the value is reset to a plain "less" and is not useful.
 
@@ -2154,7 +2218,7 @@ lkflags (ccflags.U):
        the user.  It is up to the Makefile to use this.
 
 ln (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the ln program.  After Configure runs,
        the value is reset to a plain "ln" and is not useful.
 
@@ -2198,7 +2262,7 @@ lpr (Loc.U):
        The value is a plain '' and is not useful.
 
 ls (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the ls program.  After Configure runs,
        the value is reset to a plain "ls" and is not useful.
 
@@ -2221,7 +2285,7 @@ mailx (Loc.U):
        The value is a plain '' and is not useful.
 
 make (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the make program.  After Configure runs,
        the value is reset to a plain "make" and is not useful.
 
@@ -2233,7 +2297,7 @@ make_set_make (make.U):
        make_set_make='#'               # If your make program handles this for you,
        make_set_make="MAKE=$make"      # if it doesn't.
        I used a comment character so that we can distinguish a
-       'set' value (from a previous config.sh or Configure -D option)
+       'set' value (from a previous config.sh or Configure '-D' option)
        from an uncomputed value.
 
 mallocobj (mallocsrc.U):
@@ -2282,7 +2346,7 @@ man3ext (man3dir.U):
        See man3dir.
 
 Mcc (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the Mcc program.  After Configure runs,
        the value is reset to a plain "Mcc" and is not useful.
 
@@ -2297,7 +2361,7 @@ mips_type (usrinc.U):
        Possible values are "BSD 4.3" and "System V".
 
 mkdir (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the mkdir program.  After Configure runs,
        the value is reset to a plain "mkdir" and is not useful.
 
@@ -2317,10 +2381,15 @@ modetype (modetype.U):
        modes for system calls.
 
 more (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the more program.  After Configure runs,
        the value is reset to a plain "more" and is not useful.
 
+multiarch (multiarch.U):
+       This variable conditionally defines the MULTIARCH symbol
+       which signifies the presence of multiplatform files.
+       This is normally set by hints files.
+
 mv (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
@@ -2348,7 +2417,7 @@ myuname (Oldconfig.U):
        whole thing is then lower-cased.
 
 n (n.U):
-       This variable contains the -n flag if that is what causes the echo
+       This variable contains the '-n' flag if that is what causes the echo
        command to suppress newline.  Otherwise it is null.  Correct usage is
        $echo $n "prompt for a question: $c".
 
@@ -2374,7 +2443,7 @@ netdb_net_type (netdbtype.U):
        This is only useful if you have getnetbyaddr(), naturally.
 
 nm (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the nm program.  After Configure runs,
        the value is reset to a plain "nm" and is not useful.
 
@@ -2394,7 +2463,7 @@ nonxs_ext (Extensions.U):
        in the package.  All of them will be built.
 
 nroff (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the nroff program.  After Configure runs,
        the value is reset to a plain "nroff" and is not useful.
 
@@ -2472,7 +2541,7 @@ perlpath (perlpath.U):
        shell scripts and in the "eval 'exec'" idiom.
 
 pg (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the pg program.  After Configure runs,
        the value is reset to a plain "pg" and is not useful.
 
@@ -2553,7 +2622,7 @@ rd_nodata (nblock_io.U):
        no data and an EOF.. Sigh!
 
 rm (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the rm program.  After Configure runs,
        the value is reset to a plain "rm" and is not useful.
 
@@ -2582,7 +2651,7 @@ scriptdirexp (scriptdir.U):
        at configuration time, for programs not wanting to bother with it.
 
 sed (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the sed program.  After Configure runs,
        the value is reset to a plain "sed" and is not useful.
 
@@ -2613,9 +2682,9 @@ sh (sh.U):
        /bin/sh, though it's possible that some systems will have /bin/ksh,
        /bin/pdksh, /bin/ash, /bin/bash, or even something such as
        D:/bin/sh.exe.
-       This unit comes before Options.U, so you can't set sh with a -D
+       This unit comes before Options.U, so you can't set sh with a '-D'
        option, though you can override this (and startsh)
-       with -O -Dsh=/bin/whatever -Dstartsh=whatever
+       with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
 
 shar (Loc.U):
        This variable is defined but not used by Configure.
@@ -2653,6 +2722,10 @@ shsharp (spitshell.U):
        This variable tells further Configure units whether your sh can
        handle # comments.
 
+sig_count (sig_name.U):
+       This variable holds a number larger than the largest valid
+       signal number.  This is usually the same as the NSIG macro.
+
 sig_name (sig_name.U):
        This variable holds the signal names, space separated. The leading
        SIG in signal name is removed.  A ZERO is prepended to the
@@ -2701,6 +2774,14 @@ sitelibexp (sitelib.U):
        This variable is the ~name expanded version of sitelib, so that you
        may use it directly in Makefiles or shell scripts.
 
+siteprefix (siteprefix.U):
+       This variable holds the full absolute path of the directory below
+       which the user will install add-on packages.
+
+siteprefixexp (siteprefix.U):
+       This variable holds the full absolute path of the directory below
+       which the user will install add-on packages.  Derived from siteprefix.
+
 sizetype (sizetype.U):
        This variable defines sizetype to be something like size_t, 
        unsigned long, or whatever type is used to declare length 
@@ -2730,7 +2811,7 @@ socketlib (d_socket.U):
        This variable has the names of any libraries needed for socket support.
 
 sort (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the sort program.  After Configure runs,
        the value is reset to a plain "sort" and is not useful.
 
@@ -2741,7 +2822,7 @@ spackage (package.U):
 
 spitshell (spitshell.U):
        This variable contains the command necessary to spit out a runnable
-       shell on this system.  It is either cat or a grep -v for # comments.
+       shell on this system.  It is either cat or a grep '-v' for # comments.
 
 split (models.U):
        This variable contains a flag which will tell the C compiler and loader
@@ -2749,6 +2830,54 @@ split (models.U):
        machines that support separation of instruction and data space.  It is
        up to the Makefile to use this.
 
+sPRId64 (quadfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format 64-bit decimal numbers (format 'd') for output.
+
+sPRIeldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'e') for output.
+
+sPRIEldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'E') for output.
+
+sPRIfldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'f') for output.
+
+sPRIFldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'F') for output.
+
+sPRIgldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'g') for output.
+
+sPRIGldbl (longdblfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format long doubles (format 'G') for output.
+
+sPRIi64 (quadfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format 64-bit decimal numbers (format 'i') for output.
+
+sPRIo64 (quadfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format 64-bit octal numbers (format 'o') for output.
+
+sPRIu64 (quadfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format 64-bit unsigned decimal numbers (format 'u') for output.
+
+sPRIx64 (quadfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format 64-bit hexadecimal numbers (format 'x') for output.
+
+sPRIX64 (quadfio.U):
+       This variable, if defined, contains the string used by stdio to
+       format 64-bit hExADECimAl numbers (format 'X') for output.
+
 src (src.U):
        This variable holds the path to the package source. It is up to
        the Makefile to use this variable and set VPATH accordingly to
@@ -2809,6 +2938,10 @@ stdio_ptr (d_stdstdio.U):
        _ptr field (or equivalent) of stdio.h's FILE structure.  This will
        be used to define the macro FILE_ptr(fp).
 
+stdio_stream_array (stdio_streams.U):
+       This variable tells the name of the array holding the stdio streams.
+       Usual values include _iob, __iob, and __sF.
+
 strings (i_string.U):
        This variable holds the full path of the string header that will be
        used. Typically /usr/include/string.h or /usr/include/strings.h.
@@ -2841,12 +2974,11 @@ tbl (Loc.U):
        The value is a plain '' and is not useful.
 
 tee (Loc.U):
-       This variable is be used internally by Configure to determine the
-       full pathname (if any) of the tee program.  After Configure runs,
-       the value is reset to a plain "tee" and is not useful.
+       This variable is defined but not used by Configure.
+       The value is a plain '' and is not useful.
 
 test (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the test program.  After Configure runs,
        the value is reset to a plain "test" and is not useful.
 
@@ -2859,12 +2991,12 @@ timetype (d_time.U):
        included). Anyway, the type Time_t should be used.
 
 touch (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the touch program.  After Configure runs,
        the value is reset to a plain "touch" and is not useful.
 
 tr (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the tr program.  After Configure runs,
        the value is reset to a plain "tr" and is not useful.
 
@@ -2883,12 +3015,12 @@ uidtype (uidtype.U):
        ushort, or whatever type is used to declare user ids in the kernel.
 
 uname (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the uname program.  After Configure runs,
        the value is reset to a plain "uname" and is not useful.
 
 uniq (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the uniq program.  After Configure runs,
        the value is reset to a plain "uniq" and is not useful.
 
@@ -2901,6 +3033,20 @@ usedl (dlsrc.U):
        This variable indicates if the the system supports dynamic
        loading of some sort.  See also dlsrc and dlobj.
 
+uselargefiles (uselfs.U):
+       This variable conditionally defines the USE_LARGE_FILES symbol,
+       and indicates that large file interfaces should be used when
+       available.  The use64bits symbol will also be turned on if necessary.
+
+uselongdouble (uselongdbl.U):
+       This variable conditionally defines the USE_LONG_DOUBLE symbol,
+       and indicates that long doubles should be used when available.
+
+usemorebits (usemorebits.U):
+       This variable conditionally defines the USE_MORE_BITS symbol,
+       and indicates that explicit 64-bit interfaces and long doubles
+       should be used when available.
+
 usemultiplicity (usemultiplicity.U):
        This variable conditionally defines the MULTIPLICITY symbol,
        and indicates that Perl should be built to use multiplicity.
@@ -2946,10 +3092,18 @@ useshrplib (libperl.U):
        This variable is set to 'yes' if the user wishes
        to build a shared libperl, and 'no' otherwise.
 
+usesocks (usesocks.U):
+       This variable conditionally defines the USE_SOCKS symbol,
+       and indicates that Perl should be built to use SOCKS.
+
 usethreads (usethreads.U):
        This variable conditionally defines the USE_THREADS symbol,
        and indicates that Perl should be built to use threads.
 
+usevendorprefix (vendorprefix.U):
+       This variable tells whether the vendorprefix
+       and consequently other vendor* paths are in use.
+
 usevfork (d_vfork.U):
        This variable is set to true when the user accepts to use vfork.
        It is set to false when no vfork is available or when the user
@@ -2963,6 +3117,26 @@ uuname (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
 
+vendorlib (vendorlib.U):
+       This variable contains the eventual value of the VENDORLIB symbol,
+       which is the name of the private library for this package.  It may
+       have a ~ on the front. It is up to the makefile to eventually create
+       this directory while performing installation (with ~ substitution).
+       Vendors who distribute perl binaries may place their own
+       extensions and modules in this directory.
+
+vendorlibexp (vendorlib.U):
+       This variable is the ~name expanded version of vendorlib, so that you
+       may use it directly in Makefiles or shell scripts.
+
+vendorprefix (vendorprefix.U):
+       This variable holds the full absolute path of the directory below
+       which the vendor will install add-on packages.
+
+vendorprefixexp (vendorprefix.U):
+       This variable holds the full absolute path of the directory below
+       which the vendor will install add-on packages.  Derived from vendorprefix.
+
 version (patchlevel.U):
        The full version number of this package.  This combines
        baserev, patchlevel, and subversion to get the full
@@ -2989,7 +3163,7 @@ zcat (Loc.U):
        The value is a plain '' and is not useful.
 
 zip (Loc.U):
-       This variable is be used internally by Configure to determine the
+       This variable is used internally by Configure to determine the
        full pathname (if any) of the zip program.  After Configure runs,
        the value is reset to a plain "zip" and is not useful.