This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Re: Reworked Trie Patch
[perl5.git] / Porting / Glossary
index b5b24a9..41eec75 100644 (file)
@@ -1339,10 +1339,6 @@ 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_nanosleep (d_nanosleep.U):
-       This variable conditionally defines HAS_NANOSLEEP
-       if nanosleep() is available to sleep with 1E-9 sec accuracy.
-
 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.
@@ -1978,6 +1974,14 @@ d_strftime (d_strftime.U):
        This variable conditionally defines the HAS_STRFTIME symbol, which
        indicates to the C program that the strftime() routine is available.
 
+d_strlcat (d_strlcat.U):
+       This variable conditionally defines the HAS_STRLCAT symbol, which
+       indicates to the C program that the strlcat () routine is available.
+
+d_strlcpy (d_strlcpy.U):
+       This variable conditionally defines the HAS_STRLCPY symbol, which
+       indicates to the C program that the strlcpy () routine is available.
+
 d_strtod (d_strtod.U):
        This variable conditionally defines the HAS_STRTOD symbol, which
        indicates to the C program that the strtod() routine is available
@@ -3130,14 +3134,14 @@ installsitebin (sitebin.U):
        a system running AFS, in which case they may differ slightly. You
        should always use this variable within your makefiles for portability.
 
-installsitehtml1 (sitehtml1.U):
-       This variable is really the same as sitehtml1exp, unless you are using
+installsitehtml1dir (sitehtml1dir.U):
+       This variable is really the same as sitehtml1direxp, unless you are using
        AFS in which case it points to the read/write location whereas
        html1direxp only points to the read-only access location. For extra
        portability, you should only use this variable within your makefiles.
 
-installsitehtml3 (sitehtml3.U):
-       This variable is really the same as sitehtml3exp, unless you are using
+installsitehtml3dir (sitehtml3dir.U):
+       This variable is really the same as sitehtml3direxp, unless you are using
        AFS in which case it points to the read/write location whereas
        html3direxp only points to the read-only access location. For extra
        portability, you should only use this variable within your makefiles.
@@ -3147,14 +3151,14 @@ installsitelib (sitelib.U):
        those systems using AFS. For extra portability, only this variable
        should be used in makefiles.
 
-installsiteman1 (siteman1.U):
-       This variable is really the same as siteman1exp, unless you are using
+installsiteman1dir (siteman1dir.U):
+       This variable is really the same as siteman1direxp, unless you are using
        AFS in which case it points to the read/write location whereas
        man1direxp only points to the read-only access location. For extra
        portability, you should only use this variable within your makefiles.
 
-installsiteman3 (siteman3.U):
-       This variable is really the same as siteman3exp, unless you are using
+installsiteman3dir (siteman3dir.U):
+       This variable is really the same as siteman3direxp, unless you are using
        AFS in which case it points to the read/write location whereas
        man3direxp only points to the read-only access location. For extra
        portability, you should only use this variable within your makefiles.
@@ -3215,13 +3219,13 @@ installvendorbin (vendorbin.U):
        those systems using AFS. For extra portability, only this variable
        should be used in makefiles.
 
-installvendorhtml1 (vendorhtml1.U):
-       This variable is really the same as vendorhtml1exp but may differ on
+installvendorhtml1dir (vendorhtml1dir.U):
+       This variable is really the same as vendorhtml1direxp but may differ on
        those systems using AFS. For extra portability, only this variable
        should be used in makefiles.
 
-installvendorhtml3 (vendorhtml3.U):
-       This variable is really the same as vendorhtml3exp but may differ on
+installvendorhtml3dir (vendorhtml3dir.U):
+       This variable is really the same as vendorhtml3direxp but may differ on
        those systems using AFS. For extra portability, only this variable
        should be used in makefiles.
 
@@ -3230,13 +3234,13 @@ installvendorlib (vendorlib.U):
        those systems using AFS. For extra portability, only this variable
        should be used in makefiles.
 
-installvendorman1 (vendorman1.U):
-       This variable is really the same as vendorman1exp but may differ on
+installvendorman1dir (vendorman1dir.U):
+       This variable is really the same as vendorman1direxp but may differ on
        those systems using AFS. For extra portability, only this variable
        should be used in makefiles.
 
-installvendorman3 (vendorman3.U):
-       This variable is really the same as vendorman3exp but may differ on
+installvendorman3dir (vendorman3dir.U):
+       This variable is really the same as vendorman3direxp but may differ on
        those systems using AFS. For extra portability, only this variable
        should be used in makefiles.
 
@@ -3508,6 +3512,14 @@ mips_type (usrinc.U):
        This variable holds the environment type for the mips system.
        Possible values are "BSD 4.3" and "System V".
 
+mistrustnm (Csym.U):
+       This variable can be used to establish a fallthrough for the cases
+       where nm fails to find a symbol.  If usenm is false or usenm is true
+       and mistrustnm is false, this variable has no effect.  If usenm is true
+       and mistrustnm is "compile", a test program will be compiled to try to
+       find any symbol that can't be located via nm lookup.  If mistrustnm is
+       "run", the test program will be run as well as being compiled.
+
 mkdir (Loc.U):
        This variable is used internally by Configure to determine the
        full pathname (if any) of the mkdir program.  After Configure runs,
@@ -3797,21 +3809,6 @@ plibpth (libpth.U):
        Its value is prepend to libpth. This variable takes care of special
        machines, like the mips.  Usually, it should be empty.
 
-pm_apiversion (xs_apiversion.U):
-       This variable contains the version of the oldest perl
-       compatible with the present perl.  (That is, pure perl modules
-       written for $pm_apiversion will still work for the current
-       version).  perl.c:incpush() and lib/lib.pm will automatically
-       search in $sitelib for older directories across major versions
-       back to pm_apiversion.  This is only useful if you have a perl
-       library directory tree structured like the default one.  The
-       versioned site_perl library was introduced in 5.005, so that's
-       the default setting for this variable.  It's hard to imagine
-       it changing before Perl6.  It is included here for symmetry
-       with xs_apiveprsion -- the searching algorithms will
-       (presumably) be similar.
-       See the INSTALL file for how this works.
-
 pmake (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
@@ -4124,7 +4121,7 @@ sitebinexp (sitebin.U):
        This is the same as the sitebin variable, but is filename expanded at
        configuration time, for use in your makefiles.
 
-sitehtml1 (sitehtml1.U):
+sitehtml1dir (sitehtml1dir.U):
        This variable contains the name of the directory in which site-specific
        html source pages are to be put.  It is the responsibility of the
        Makefile.SH to get the value of this into the proper command.
@@ -4135,11 +4132,11 @@ sitehtml1 (sitehtml1.U):
        MakeMaker Makefile.PL
        or equivalent.  See INSTALL for details.
 
-sitehtml1exp (sitehtml1.U):
-       This variable is the same as the sitehtml1 variable, but is filename
+sitehtml1direxp (sitehtml1dir.U):
+       This variable is the same as the sitehtml1dir variable, but is filename
        expanded at configuration time, for convenient use in makefiles.
 
-sitehtml3 (sitehtml3.U):
+sitehtml3dir (sitehtml3dir.U):
        This variable contains the name of the directory in which site-specific
        library html source pages are to be put.  It is the responsibility of the
        Makefile.SH to get the value of this into the proper command.
@@ -4150,8 +4147,8 @@ sitehtml3 (sitehtml3.U):
        MakeMaker Makefile.PL
        or equivalent.  See INSTALL for details.
 
-sitehtml3exp (sitehtml3.U):
-       This variable is the same as the sitehtml3 variable, but is filename
+sitehtml3direxp (sitehtml3dir.U):
+       This variable is the same as the sitehtml3dir variable, but is filename
        expanded at configuration time, for convenient use in makefiles.
 
 sitelib (sitelib.U):
@@ -4174,7 +4171,7 @@ sitelibexp (sitelib.U):
        This variable is the ~name expanded version of sitelib, so that you
        may use it directly in Makefiles or shell scripts.
 
-siteman1 (siteman1.U):
+siteman1dir (siteman1dir.U):
        This variable contains the name of the directory in which site-specific
        manual source pages are to be put.  It is the responsibility of the
        Makefile.SH to get the value of this into the proper command.
@@ -4185,11 +4182,11 @@ siteman1 (siteman1.U):
        MakeMaker Makefile.PL
        or equivalent.  See INSTALL for details.
 
-siteman1exp (siteman1.U):
-       This variable is the same as the siteman1 variable, but is filename
+siteman1direxp (siteman1dir.U):
+       This variable is the same as the siteman1dir variable, but is filename
        expanded at configuration time, for convenient use in makefiles.
 
-siteman3 (siteman3.U):
+siteman3dir (siteman3dir.U):
        This variable contains the name of the directory in which site-specific
        library man source pages are to be put.  It is the responsibility of the
        Makefile.SH to get the value of this into the proper command.
@@ -4200,8 +4197,8 @@ siteman3 (siteman3.U):
        MakeMaker Makefile.PL
        or equivalent.  See INSTALL for details.
 
-siteman3exp (siteman3.U):
-       This variable is the same as the siteman3 variable, but is filename
+siteman3direxp (siteman3dir.U):
+       This variable is the same as the siteman3dir variable, but is filename
        expanded at configuration time, for convenient use in makefiles.
 
 siteprefix (siteprefix.U):
@@ -4610,6 +4607,10 @@ uselongdouble (uselongdbl.U):
        This variable conditionally defines the USE_LONG_DOUBLE symbol,
        and indicates that long doubles should be used when available.
 
+usemallocwrap (mallocsrc.U):
+       This variable contains y if we are wrapping malloc to prevent
+       integer overflow during size calculations.
+
 usemorebits (usemorebits.U):
        This variable conditionally defines the USE_MORE_BITS symbol,
        and indicates that explicit 64-bit interfaces and long doubles
@@ -4656,6 +4657,13 @@ usereentrant (usethreads.U):
        meaningful if usethreads is set and is very experimental, it is
        not even prompted for.
 
+userelocatableinc (XXX.U):
+       This variable is set to true to indicate that perl should relocate
+       @INC entries at runtime based on the path to the perl binary.
+       Any @INC paths starting ".../" are relocated relative to the directory
+       containing the perl binary, and a logical cleanup of the path is then
+       made around the join point (removing "dir/../" pairs)
+
 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
@@ -4740,7 +4748,7 @@ vendorbinexp (vendorbin.U):
        This variable is the ~name expanded version of vendorbin, so that you
        may use it directly in Makefiles or shell scripts.
 
-vendorhtml1 (vendorhtml1.U):
+vendorhtml1dir (vendorhtml1dir.U):
        This variable contains the name of the directory for html 
        pages.  It may have a ~ on the front.
        The standard distribution will put nothing in this directory.
@@ -4749,11 +4757,11 @@ vendorhtml1 (vendorhtml1.U):
        MakeMaker Makefile.PL INSTALLDIRS=vendor 
        or equivalent.  See INSTALL for details.
 
-vendorhtml1exp (vendorhtml1.U):
-       This variable is the ~name expanded version of vendorhtml1, so that you
+vendorhtml1direxp (vendorhtml1dir.U):
+       This variable is the ~name expanded version of vendorhtml1dir, so that you
        may use it directly in Makefiles or shell scripts.
 
-vendorhtml3 (vendorhtml3.U):
+vendorhtml3dir (vendorhtml3dir.U):
        This variable contains the name of the directory for html 
        library pages.  It may have a ~ on the front.
        The standard distribution will put nothing in this directory.
@@ -4762,8 +4770,8 @@ vendorhtml3 (vendorhtml3.U):
        MakeMaker Makefile.PL INSTALLDIRS=vendor 
        or equivalent.  See INSTALL for details.
 
-vendorhtml3exp (vendorhtml3.U):
-       This variable is the ~name expanded version of vendorhtml3, so that you
+vendorhtml3direxp (vendorhtml3dir.U):
+       This variable is the ~name expanded version of vendorhtml3dir, so that you
        may use it directly in Makefiles or shell scripts.
 
 vendorlib (vendorlib.U):
@@ -4784,7 +4792,7 @@ vendorlibexp (vendorlib.U):
        This variable is the ~name expanded version of vendorlib, so that you
        may use it directly in Makefiles or shell scripts.
 
-vendorman1 (vendorman1.U):
+vendorman1dir (vendorman1dir.U):
        This variable contains the name of the directory for man1 
        pages.  It may have a ~ on the front.
        The standard distribution will put nothing in this directory.
@@ -4793,11 +4801,11 @@ vendorman1 (vendorman1.U):
        MakeMaker Makefile.PL INSTALLDIRS=vendor 
        or equivalent.  See INSTALL for details.
 
-vendorman1exp (vendorman1.U):
-       This variable is the ~name expanded version of vendorman1, so that you
+vendorman1direxp (vendorman1dir.U):
+       This variable is the ~name expanded version of vendorman1dir, so that you
        may use it directly in Makefiles or shell scripts.
 
-vendorman3 (vendorman3.U):
+vendorman3dir (vendorman3dir.U):
        This variable contains the name of the directory for man3 
        pages.  It may have a ~ on the front.
        The standard distribution will put nothing in this directory.
@@ -4806,8 +4814,8 @@ vendorman3 (vendorman3.U):
        MakeMaker Makefile.PL INSTALLDIRS=vendor 
        or equivalent.  See INSTALL for details.
 
-vendorman3exp (vendorman3.U):
-       This variable is the ~name expanded version of vendorman3, so that you
+vendorman3direxp (vendorman3dir.U):
+       This variable is the ~name expanded version of vendorman3dir, so that you
        may use it directly in Makefiles or shell scripts.
 
 vendorprefix (vendorprefix.U):
@@ -4874,23 +4882,6 @@ xlibpth (libpth.U):
        libraries on this platform, for example CPU-specific libraries
        (on multi-CPU platforms) may be listed here.
 
-xs_apiversion (xs_apiversion.U):
-       This variable contains the version of the oldest perl binary
-       compatible with the present perl.  perl.c:incpush() and
-       lib/lib.pm will automatically search in $sitearch for older
-       directories across major versions back to xs_apiversion.
-       This is only useful if you have a perl library directory tree
-       structured like the default one.
-       See INSTALL for how this works.
-       The versioned site_perl directory was introduced in 5.005,
-       so that is the lowest possible value.
-       Since this can depend on compile time options
-       it is set by Configure.  Other non-default sources
-       of potential incompatibility, such as multiplicity, threads,
-       debugging, 64bits, sfio, etc., are not checked for currently,
-       though in principle we could go snooping around in old
-       Config.pm files.
-
 yacc (yacc.U):
        This variable holds the name of the compiler compiler we
        want to use in the Makefile. It can be yacc, byacc, or bison -y.