make make_patchnum.sh (more) portable
[p5sagit/p5-mst-13.2.git] / Porting / Glossary
index 79abd06..53a44c4 100644 (file)
@@ -34,7 +34,7 @@ afsroot (afs.U):
        This variable is by default set to '/afs'. In the unlikely case
        this is not the correct root, it is possible to override this with
        a hint value or command line option.  This will be used in subsequent
-       tests for AFSness in the Perl configure and test process.
+       tests for AFSness in the configure and test process.
 
 alignbytes (alignbytes.U):
        This variable holds the number of bytes required to align a
@@ -142,7 +142,7 @@ baserev (baserev.U):
 
 bash (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 bin (bin.U):
        This variable holds the name of the directory in which the user wants
@@ -244,13 +244,9 @@ 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.
 
-charsize (charsize.U):
-       This variable contains the value of the CHARSIZE symbol, which
-       indicates to the C program how many bytes there are in a character.
-
 chgrp (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 chmod (Loc.U):
        This variable is used internally by Configure to determine the
@@ -259,7 +255,7 @@ chmod (Loc.U):
 
 chown (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 clocktype (d_times.U):
        This variable holds the type returned by times(). It can be long,
@@ -273,7 +269,7 @@ 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.
 
 contains (contains.U):
        This variable holds the command to do a grep with a proper return
@@ -288,7 +284,7 @@ cp (Loc.U):
 
 cpio (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 cpp (Loc.U):
        This variable is used internally by Configure to determine the
@@ -393,6 +389,10 @@ d_archlib (archlib.U):
        of architecture-dependent library files for $package.  If
        $archlib is the same as $privlib, then this is set to undef.
 
+d_asctime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_ASCTIME64 symbol, which
+       indicates to the C program that the asctime64 () routine is available.
+
 d_asctime_r (d_asctime_r.U):
        This variable conditionally defines the HAS_ASCTIME_R symbol,
        which indicates to the C program that the asctime_r()
@@ -406,6 +406,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.
@@ -482,6 +487,11 @@ d_bzero (d_bzero.U):
        This variable conditionally defines the HAS_BZERO symbol if
        the bzero() routine is available to set memory to 0.
 
+d_c99_variadic_macros (d_c99_variadic.U):
+       This variable conditionally defines the HAS_C99_VARIADIC_MACROS
+       symbol, which indicates to the C program that C99 variadic macros
+       are available.
+
 d_casti32 (d_casti32.U):
        This variable conditionally defines CASTI32, which indicates
        whether the C compiler can cast large floats to 32-bit ints.
@@ -534,6 +544,11 @@ d_copysignl (d_copysignl.U):
        indicates to the C program that the copysignl() routine is available.
        If aintl is also present we can emulate modfl.
 
+d_cplusplus (d_cplusplus.U):
+       This variable conditionally defines the USE_CPLUSPLUS symbol, which
+       indicates that a C++ compiler was used to compiled Perl and will be
+       used to compile extensions.
+
 d_crypt (d_crypt.U):
        This variable conditionally defines the CRYPT symbol, which
        indicates to the C program that the crypt() routine is available
@@ -548,11 +563,19 @@ d_csh (d_csh.U):
        This variable conditionally defines the CSH symbol, which
        indicates to the C program that the C-shell exists.
 
+d_ctermid (d_ctermid.U):
+       This variable conditionally defines CTERMID if ctermid() is
+       available to generate filename for terminal.
+
 d_ctermid_r (d_ctermid_r.U):
        This variable conditionally defines the HAS_CTERMID_R symbol,
        which indicates to the C program that the ctermid_r()
        routine is available.
 
+d_ctime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_CTIME64 symbol, which
+       indicates to the C program that the ctime64 () routine is available.
+
 d_ctime_r (d_ctime_r.U):
        This variable conditionally defines the HAS_CTIME_R symbol,
        which indicates to the C program that the ctime_r()
@@ -578,6 +601,15 @@ d_difftime (d_difftime.U):
        This variable conditionally defines the HAS_DIFFTIME symbol, which
        indicates to the C program that the difftime() routine is available.
 
+d_difftime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_DIFFTIME64 symbol, which
+       indicates to the C program that the difftime64 () routine is available.
+
+d_dir_dd_fd (d_dir_dd_fd.U):
+       This variable conditionally defines the HAS_DIR_DD_FD symbol, which
+       indicates that the DIR directory stream type contains a member
+       variable called dd_fd.
+
 d_dirfd (d_dirfd.U):
        This variable conditionally defines the HAS_DIRFD constant,
        which indicates to the C program that dirfd() is available
@@ -849,6 +881,24 @@ 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_getcwd (d_getcwd.U):
        This variable conditionally defines the HAS_GETCWD symbol, which
        indicates to the C program that the getcwd() routine is available
@@ -1125,6 +1175,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()
@@ -1211,11 +1265,19 @@ d_link (d_link.U):
        This variable conditionally defines HAS_LINK if link() is
        available to create hard links.
 
+d_localtime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_LOCALTIME64 symbol, which
+       indicates to the C program that the localtime64 () routine is available.
+
 d_localtime_r (d_localtime_r.U):
        This variable conditionally defines the HAS_LOCALTIME_R symbol,
        which indicates to the C program that the localtime_r()
        routine is available.
 
+d_localtime_r_needs_tzset (d_localtime_r.U):
+       This variable conditionally defines the LOCALTIME_R_NEEDS_TZSET
+       symbol, which makes us call tzset before localtime_r()
+
 d_locconv (d_locconv.U):
        This variable conditionally defines HAS_LOCALECONV if localeconv() is
        available for numeric and monetary formatting conventions.
@@ -1323,6 +1385,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.
@@ -1410,6 +1476,23 @@ d_mymalloc (mallocsrc.U):
        of the source want to take special action if MYMALLOC is used.
        This may include different sorts of profiling or error detection.
 
+d_ndbm (i_ndbm.U):
+       This variable conditionally defines the HAS_NDBM symbol, which
+       indicates that both the ndbm.h include file and an appropriate ndbm
+       library exist.  Consult the different i_*ndbm variables
+       to find out the actual include location.  Sometimes, a system has the
+       header file but not the library.  This variable will only be set if
+       the system has both.
+
+d_ndbm_h_uses_prototypes (i_ndbm.U):
+       This variable conditionally defines the NDBM_H_USES_PROTOTYPES symbol,
+       which indicates that the ndbm.h include file uses real ANSI C
+       prototypes instead of K&R style function declarations. K&R style
+       declarations are unsupported in C++, so the include file requires
+       special handling when using a C++ compiler and this variable is
+       undefined. Consult the different d_*ndbm_h_uses_prototypes variables
+       to get the same information for alternative ndbm.h include files.
+
 d_nice (d_nice.U):
        This variable conditionally defines the HAS_NICE symbol, which
        indicates to the C program that the nice() routine is available.
@@ -1522,6 +1605,10 @@ d_PRIi64 (quadfio.U):
        This variable conditionally defines the PERL_PRIi64 symbol, which
        indiciates that stdio has a symbol to print 64-bit decimal numbers.
 
+d_printf_format_null (d_attribut.U):
+       This variable conditionally defines PRINTF_FORMAT_NULL_OK, which
+       indicates the C compiler allows printf-like formats to be null.
+
 d_PRIo64 (quadfio.U):
        This variable conditionally defines the PERL_PRIo64 symbol, which
        indiciates that stdio has a symbol to print 64-bit octal numbers.
@@ -1545,6 +1632,10 @@ d_procselfexe (d_procselfexe.U):
        Defined if $procselfexe is symlink to the absolute
        pathname of the executing program.
 
+d_pseudofork (d_vfork.U):
+       This variable conditionally defines the HAS_PSEUDOFORK symbol,
+       which indicates that an emulation of the fork routine is available.
+
 d_pthread_atfork (d_pthread_atfork.U):
        This variable conditionally defines the HAS_PTHREAD_ATFORK symbol,
        which indicates to the C program that the pthread_atfork()
@@ -1906,6 +1997,11 @@ d_sigaction (d_sigaction.U):
        This variable conditionally defines the HAS_SIGACTION symbol, which
        indicates that the Vr4 sigaction() routine is available.
 
+d_signbit (d_signbit.U):
+       This variable conditionally defines the HAS_SIGNBIT symbol, which
+       indicates to the C program that the signbit() routine is available
+       and safe to use with perl's intern NV type.
+
 d_sigprocmask (d_sigprocmask.U):
        This variable conditionally defines HAS_SIGPROCMASK
        if sigprocmask() is available to examine or change the signal mask
@@ -2173,6 +2269,10 @@ d_time (d_time.U):
        that the time() routine exists.  The time() routine is normaly
        provided on UNIX systems.
 
+d_timegm (d_timegm.U):
+       This variable conditionally defines the HAS_TIMEGM symbol, which
+       indicates to the C program that the timegm () routine is available.
+
 d_times (d_times.U):
        This variable conditionally defines the HAS_TIMES symbol, which indicates
        that the times() routine exists.  The times() routine is normaly
@@ -2382,6 +2482,9 @@ drand48_r_proto (d_drand48_r.U):
        REENTRANT_PROTO_T_ABC macros of reentr.h if d_drand48_r
        is defined.
 
+dtrace (usedtrace.U):
+       This variable holds the location of the dtrace executable.
+
 dynamic_ext (Extensions.U):
        This variable holds a list of XS extension files we want to
        link dynamically into the package.  It is used by Makefile.
@@ -2409,7 +2512,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.
@@ -2466,6 +2569,10 @@ extensions (Extensions.U):
        and is typically used to test whether a particular extesion
        is available.
 
+extern_C (Csym.U):
+       ANSI C requires 'extern' where C++ requires 'extern "C"'. This
+       variable can be used in Configure to do the right thing.
+
 extras (Extras.U):
        This variable holds a list of extra modules to install.
 
@@ -2482,7 +2589,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,
@@ -2492,7 +2599,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.
@@ -2792,6 +2899,11 @@ i_arpainet (i_arpainet.U):
        This variable conditionally defines the I_ARPA_INET symbol,
        and indicates whether a C program should include <arpa/inet.h>.
 
+i_assert (i_assert.U):
+       This variable conditionally defines the I_ASSERT symbol, which
+       indicates to the C program that <assert.h> exists and could be
+       included.
+
 i_bsdioctl (i_sysioctl.U):
        This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
        indicates to the C program that <sys/bsdioctl.h> exists and should
@@ -2846,6 +2958,18 @@ i_gdbm (i_gdbm.U):
        indicates to the C program that <gdbm.h> exists and should
        be included.
 
+i_gdbm_ndbm (i_ndbm.U):
+       This variable conditionally defines the I_GDBM_NDBM symbol, which
+       indicates to the C program that <gdbm-ndbm.h> exists and should
+       be included.  This is the location of the ndbm.h compatibility file
+       in Debian 4.0.
+
+i_gdbmndbm (i_ndbm.U):
+       This variable conditionally defines the I_GDBMNDBM symbol, which
+       indicates to the C program that <gdbm/ndbm.h> exists and should
+       be included.  This was the location of the ndbm.h compatibility file
+       in RedHat 7.1.
+
 i_grp (i_grp.U):
        This variable conditionally defines the I_GRP symbol, and indicates
        whether a C program should include <grp.h>.
@@ -2883,6 +3007,10 @@ i_malloc (i_malloc.U):
        This variable conditionally defines the I_MALLOC symbol, and indicates
        whether a C program should include <malloc.h>.
 
+i_mallocmalloc (i_mallocmalloc.U):
+       This variable conditionally defines the I_MALLOCMALLOC symbol,
+       and indicates whether a C program should include <malloc/malloc.h>.
+
 i_math (i_math.U):
        This variable conditionally defines the I_MATH symbol, and indicates
        whether a C program may include <math.h>.
@@ -3030,6 +3158,10 @@ i_sysparam (i_sysparam.U):
        This variable conditionally defines the I_SYS_PARAM symbol, and indicates
        whether a C program should include <sys/param.h>.
 
+i_syspoll (i_syspoll.U):
+       This variable conditionally defines the I_SYS_POLL symbol, which
+       indicates to the C program that it should include <sys/poll.h>.
+
 i_sysresrc (i_sysresrc.U):
        This variable conditionally defines the I_SYS_RESOURCE symbol,
        and indicates whether a C program should include <sys/resource.h>.
@@ -3173,7 +3305,7 @@ incpath (usrinc.U):
 
 inews (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 initialinstalllocation (bin.U):
        When userelocatableinc is true, this variable holds the location
@@ -3387,7 +3519,7 @@ known_extensions (Extensions.U):
 
 ksh (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 ld (dlsrc.U):
        This variable indicates the program to be used to link
@@ -3469,11 +3601,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
@@ -3523,11 +3655,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
@@ -3562,11 +3694,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
@@ -3583,8 +3715,8 @@ make_set_make (make.U):
 
        make_set_make="MAKE=$make"      # if it doesn't.
 
-       This uses a comment character to distinguish a
-       'set' value (from a previous config.sh or Configure -D option)
+       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.
 
 mallocobj (mallocsrc.U):
@@ -3632,11 +3764,6 @@ man3ext (man3dir.U):
        have: one of 'n', 'l', or '3'.  The Makefile must supply the '.'.
        See man3dir.
 
-Mcc (Loc.U):
-       This variable is used internally by Configure to determine the
-       full pathname (if any) of the Mcc program.  After Configure runs,
-       the value is reset to a plain "Mcc" and is not useful.
-
 mips_type (usrinc.U):
        This variable holds the environment type for the mips system.
        Possible values are "BSD 4.3" and "System V".
@@ -3676,7 +3803,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
@@ -3701,7 +3828,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".
 
@@ -3760,6 +3887,11 @@ nroff (Loc.U):
        full pathname (if any) of the nroff program.  After Configure runs,
        the value is reset to a plain "nroff" and is not useful.
 
+nv_overflows_integers_at (perlxv.U):
+       This variable gives the largest integer value that NVs can hold
+       as a constant floating point expression.
+       If it could not be determined, it holds the value 0.
+
 nv_preserves_uv_bits (perlxv.U):
        This variable indicates how many of bits type uvtype
        a variable nvtype can preserve.
@@ -3871,13 +4003,43 @@ path_sep (Unix.U):
 
 perl (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.
 
 perl5 (perl5.U):
        This variable contains the full path (if any) to a previously
        installed perl5.005 or later suitable for running the script
        to determine inc_version_list.
 
+PERL_API_REVISION (patchlevel.h):
+       This number describes the earliest compatible PERL_REVISION of
+       Perl ("compatibility" here being defined as sufficient binary/API
+       compatibility to run XS code built with the older version).
+       Normally this does not change across maintenance releases.
+       Please read the comment in patchlevel.h.
+
+PERL_API_SUBVERSION (patchlevel.h):
+       This number describes the earliest compatible PERL_SUBVERSION of
+       Perl ("compatibility" here being defined as sufficient binary/API
+       compatibility to run XS code built with the older version).
+       Normally this does not change across maintenance releases.
+       Please read the comment in patchlevel.h.
+
+PERL_API_VERSION (patchlevel.h):
+       This number describes the earliest compatible PERL_VERSION of
+       Perl ("compatibility" here being defined as sufficient binary/API
+       compatibility to run XS code built with the older version).
+       Normally this does not change across maintenance releases.
+       Please read the comment in patchlevel.h.
+
+PERL_CONFIG_SH (Oldsyms.U):
+       This is set to 'true' in config.sh so that a shell script
+       sourcing config.sh can tell if it has been sourced already.
+
+PERL_PATCHLEVEL (Oldsyms.U):
+       This symbol reflects the patchlevel, if available. Will usually
+       come from the .patch file, which is available when the perl
+       source tree was fetched with rsync.
+
 perl_patchlevel (patchlevel.U):
        This is the Perl patch level, a numeric change identifier,
        as defined by whichever source code maintenance system
@@ -3940,11 +4102,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
@@ -4040,9 +4202,13 @@ rm (Loc.U):
        full pathname (if any) of the rm program.  After Configure runs,
        the value is reset to a plain "rm" and is not useful.
 
+rm_try (Unix.U):
+       This is a cleanup variable for try test programs.
+       Internal Configure use only.
+
 rmail (Loc.U):
        This variable is defined but not used by Configure.
-       The value is a plain '' and is not useful.
+       The value is the empty string and is not useful.
 
 run (Cross.U):
        This variable contains the command used by Configure
@@ -4094,7 +4260,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.
@@ -4138,19 +4304,27 @@ 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
        /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.
-       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
@@ -4364,11 +4538,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
@@ -4397,7 +4579,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.
 
 sPRId64 (quadfio.U):
        This variable, if defined, contains the string used by stdio to
@@ -4468,9 +4650,9 @@ srandom_r_proto (d_srandom_r.U):
        is defined.
 
 src (src.U):
-       This variable holds the path to the package source. It is up to
-       the Makefile to use this variable and set VPATH accordingly to
-       find the sources remotely.
+       This variable holds the (possibly relative) path of the package source.
+       It is up to the Makefile to use this variable and set VPATH accordingly
+       to find the sources remotely.  Use $pkgsrc to have an absolute path.
 
 sSCNfldbl (longdblfio.U):
        This variable, if defined, contains the string used by stdio to
@@ -4547,7 +4729,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.
@@ -4564,11 +4746,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.
@@ -4576,11 +4758,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
@@ -4625,7 +4807,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.
@@ -4689,7 +4871,7 @@ uquadtype (quadtype.U):
 use5005threads (usethreads.U):
        This variable conditionally defines the USE_5005THREADS symbol,
        and indicates that Perl should be built to use the 5.005-based
-       threading implementation.
+       threading implementation. Only valid up to 5.8.x.
 
 use64bitall (use64bits.U):
        This variable conditionally defines the USE_64_BIT_ALL symbol,
@@ -4713,10 +4895,18 @@ usecrosscompile (Cross.U):
        This variable conditionally defines the USE_CROSS_COMPILE symbol,
        and indicates that Perl has been cross-compiled.
 
+usedevel (Devel.U):
+       This variable indicates that Perl was configured with development
+       features enabled.  This should not be done for production builds.
+
 usedl (dlsrc.U):
        This variable indicates if the system supports dynamic
        loading of some sort.  See also dlsrc and dlobj.
 
+usedtrace (usedtrace.U):
+       This variable indicates whether we are compiling with dtrace
+       support. See also dtrace.
+
 usefaststdio (usefaststdio.U):
        This variable conditionally defines the USE_FAST_STDIO symbol,
        and indicates that Perl should be built to use 'fast stdio'.
@@ -4832,7 +5022,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
@@ -5004,7 +5194,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,
@@ -5026,7 +5216,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