X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=Porting%2FGlossary;h=bcd3a972e86bdbb51cc73ebaeb227ccc65ebaa83;hb=ff8dabfa5b87d11f875cfd5faa30b45d10989866;hp=0d18d49418ad88eeb8b974be8728c5710999bf72;hpb=a10d74f301e9c83108aa701b20914b6bb55d9310;p=p5sagit%2Fp5-mst-13.2.git diff --git a/Porting/Glossary b/Porting/Glossary index 0d18d49..bcd3a97 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -1,3 +1,7 @@ + +!!!!!!! DO NOT EDIT THIS FILE !!!!!!! +This file is built by metaconfig. + This file contains a description of all the shell variables whose value is determined by the Configure script. Variables intended for use in C programs (e.g. I_UNISTD) are already described in config_h.SH. [`configpm' @@ -53,7 +57,8 @@ api_revision (patchlevel.U): such as '5.6.1', api_revision is the '5'. Prior to 5.5.640, the format was a floating point number, like 5.00563. - perl.c:incpush() and lib/lib.pm will automatically search in + + perl.c:incpush() and lib/lib.pm will automatically search in $sitelib/.. for older directories back to the limit specified by these api_ variables. This is only useful if you have a perl library directory tree structured like the default one. @@ -61,7 +66,8 @@ api_revision (patchlevel.U): directory was introduced in 5.005, so that is the lowest possible value. The version list appropriate for the current system is determined in inc_version_list.U. - XXX To do: Since compatibility can depend on compile time + + XXX To do: Since compatibility can depend on compile time options (such as bincompat, longlong, etc.) it should (perhaps) be set by Configure, but currently it isn't. Currently, we read a hard-wired value from patchlevel.h. @@ -290,7 +296,7 @@ cpp (Loc.U): the value is reset to a plain "cpp" and is not useful. cpp_stuff (cpp_stuff.U): - This variable contains an identification of the catenation mechanism + This variable contains an identification of the concatenation mechanism used by the C preprocessor. cppccsymbols (Cppsym.U): @@ -373,6 +379,11 @@ d_accessx (d_accessx.U): This variable conditionally defines the HAS_ACCESSX symbol, which indicates to the C program that the accessx() routine is available. +d_aintl (d_aintl.U): + This variable conditionally defines the HAS_AINTL symbol, which + indicates to the C program that the aintl() routine is available. + If copysignl is also present we can emulate modfl. + d_alarm (d_alarm.U): This variable conditionally defines the HAS_ALARM symbol, which indicates to the C program that the alarm() routine is available. @@ -395,10 +406,42 @@ 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, - such as printf formats. +d_attribute_format (d_attribut_format.U): + This variable conditionally defines HASATTRIBUTE_FORMAT, which + indicates the C compiler can check for printf-like formats. + +d_attribute_malloc (d_attribute_malloc.U): + This variable conditionally defines HASATTRIBUTE_MALLOC, which + indicates the C compiler can understand functions as having + malloc-like semantics. + +d_attribute_nonnull (d_attribute_nonnull.U): + This variable conditionally defines HASATTRIBUTE_NONNULL, which + indicates that the C compiler can know that certain arguments + must not be NULL, and will check accordingly at compile time. + +d_attribute_noreturn (d_attribute_noreturn.U): + This variable conditionally defines HASATTRIBUTE_NORETURN, which + indicates that the C compiler can know that certain functions + are guaranteed never to return. + +d_attribute_pure (d_attribute_pure.U): + This variable conditionally defines HASATTRIBUTE_PURE, which + indicates that the C compiler can know that certain functions + are "pure" functions, meaning that they have no side effects, and + only rely on function input and/or global data for their results. + +d_attribute_unused (d_attribute_unused.U): + This variable conditionally defines HASATTRIBUTE_UNUSED, which + indicates that the C compiler can know that certain variables + and arguments may not always be used, and to not throw warnings + if they don't get used. + +d_attribute_warn_unused_result (d_attribute_warn_unused_result.U): + This variable conditionally defines + HASATTRIBUTE_WARN_UNUSED_RESULT, which indicates that the C + compiler can know that certain functions have a return values + that must not be ignored, such as malloc() or open(). d_bcmp (d_bcmp.U): This variable conditionally defines the HAS_BCMP symbol if @@ -455,6 +498,10 @@ d_class (d_class.U): This variable conditionally defines the HAS_CLASS symbol, which indicates to the C program that the class() routine is available. +d_clearenv (d_clearenv.U): + This variable conditionally defines the HAS_CLEARENV symbol, which + indicates to the C program that the clearenv () routine is available. + d_closedir (d_closedir.U): This variable conditionally defines HAS_CLOSEDIR if closedir() is available. @@ -468,6 +515,11 @@ d_const (d_const.U): indicates to the C program that this C compiler knows about the const type. +d_copysignl (d_copysignl.U): + This variable conditionally defines the HAS_COPYSIGNL symbol, which + indicates to the C program that the copysignl() routine is available. + If aintl is also present we can emulate modfl. + d_crypt (d_crypt.U): This variable conditionally defines the CRYPT symbol, which indicates to the C program that the crypt() routine is available @@ -623,6 +675,11 @@ d_eunice (Guess.U): This variable conditionally defines the symbols EUNICE and VAX, which alerts the C program that it must deal with ideosyncracies of VMS. +d_faststdio (d_faststdio.U): + This variable conditionally defines the HAS_FAST_STDIO symbol, + which indicates to the C program that the "fast stdio" is available + to manipulate the stdio buffers directly. + d_fchdir (d_fchdir.U): This variable conditionally defines the HAS_FCHDIR symbol, which indicates to the C program that the fchdir() routine is available. @@ -753,6 +810,10 @@ d_ftime (d_ftime.U): that the ftime() routine exists. The ftime() routine is basically a sub-second accuracy clock. +d_futimes (f_futimes.U): + This variable conditionally defines the HAS_FUTIMES symbol, which + indicates to the C program that the futimes() routine is available. + d_Gconvert (d_gconvert.U): This variable holds what Gconvert is defined as to convert floating point numbers into strings. By default, Configure @@ -767,7 +828,8 @@ d_Gconvert (d_gconvert.U): long doubles, respectively. If present, they contain a space-separated list of one or more of the above function names in the order they should be tried. - d_Gconvert may be set to override Configure with a platform- + + d_Gconvert may be set to override Configure with a platform- specific function. If this function expects a double, a different value may need to be set by the uselongdouble.cbu call-back unit so that long doubles can be formatted without @@ -1070,6 +1132,11 @@ d_htonl (d_htonl.U): This variable conditionally defines HAS_HTONL if htonl() and its friends are available to do network order byte swapping. +d_ilogbl (d_ilogbl.U): + This variable conditionally defines the HAS_ILOGBL symbol, which + indicates to the C program that the ilogbl() routine is available. + If scalbnl is also present we can emulate frexpl. + d_index (d_strchr.U): This variable conditionally defines HAS_INDEX if index() and rindex() are available for string searching. @@ -1156,6 +1223,14 @@ d_madvise (d_madvise.U): This variable conditionally defines HAS_MADVISE if madvise() is available to map a file into memory. +d_malloc_size (d_malloc_size.U): + This symbol, if defined, indicates that the malloc_size + routine is available for use. + +d_malloc_good_size (d_malloc_good_size.U): + This symbol, if defined, indicates that the malloc_good_size + routine is available for use. + d_mblen (d_mblen.U): This variable conditionally defines the HAS_MBLEN symbol, which indicates to the C program that the mblen() routine is available @@ -1240,6 +1315,12 @@ d_modfl_pow32_bug (d_modfl.U): and 1.150000. The bug has been seen in certain versions of glibc, release 2.2.2 is known to be okay. +d_modflproto (d_modfl.U): + This symbol, if defined, indicates that the system provides + a prototype for the modfl() function. Otherwise, it is up + to the program to supply one. C99 says it should be + long double modfl(long double, long double *); + d_mprotect (d_mprotect.U): This variable conditionally defines HAS_MPROTECT if mprotect() is available to modify the access protection of a memory mapped file. @@ -1318,6 +1399,10 @@ d_nv_preserves_uv (perlxv.U): This variable indicates whether a variable of type nvtype can preserve all the bits a variable of type uvtype. +d_nv_zero_is_allbits_zero (perlxv.U): + This variable indicates whether a variable of type nvtype + stores 0.0 in memory as all bits zero. + d_off64_t (d_off64_t.U): This symbol will be defined if the C compiler supports off64_t. @@ -1442,6 +1527,11 @@ d_pthread_atfork (d_pthread_atfork.U): which indicates to the C program that the pthread_atfork() routine is available. +d_pthread_attr_setscope (d_pthread_attr_ss.U): + This variable conditionally defines HAS_PTHREAD_ATTR_SETSCOPE if + pthread_attr_setscope() is available to set the contention scope + attribute of a thread attribute object. + 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 @@ -1553,6 +1643,11 @@ d_sbrkproto (d_sbrkproto.U): a prototype for the sbrk() function. Otherwise, it is up to the program to supply one. +d_scalbnl (d_scalbnl.U): + This variable conditionally defines the HAS_SCALBNL symbol, which + indicates to the C program that the scalbnl() routine is available. + If ilogbl is also present we can emulate frexpl. + d_sched_yield (d_pthread_y.U): This variable conditionally defines the HAS_SCHED_YIELD symbol if the sched_yield routine is available to yield @@ -1823,6 +1918,12 @@ d_socks5_init (d_socks5_init.U): This variable conditionally defines the HAS_SOCKS5_INIT symbol, which indicates to the C program that the socks5_init() routine is available. +d_sprintf_returns_strlen (d_sprintf_returns_strlen.U): + This variable defines whether sprintf returns the length of the string + (as per the ANSI spec). Some C libraries retain compatibility with + pre-ANSI C and return a pointer to the passed in buffer; for these + this variable will be undef. + d_sqrtl (d_sqrtl.U): This variable conditionally defines the HAS_SQRTL symbol, which indicates to the C program that the sqrtl() routine is available. @@ -1931,6 +2032,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 @@ -2088,6 +2197,10 @@ d_unordered (d_unordered.U): This variable conditionally defines the HAS_UNORDERED symbol, which indicates to the C program that the unordered() routine is available. +d_unsetenv (d_unsetenv.U): + This variable conditionally defines the HAS_UNSETENV symbol, which + indicates to the C program that the unsetenv () routine is available. + d_usleep (d_usleep.U): This variable conditionally defines HAS_USLEEP if usleep() is available to do high granularity sleeps. @@ -2111,6 +2224,9 @@ d_vendorbin (vendorbin.U): d_vendorlib (vendorlib.U): This variable conditionally defines PERL_VENDORLIB. +d_vendorscript (vendorscript.U): + This variable conditionally defines PERL_VENDORSCRIPT. + d_vfork (d_vfork.U): This variable conditionally defines the HAS_VFORK symbol, which indicates the vfork() routine is available. @@ -2376,13 +2492,18 @@ full_sed (Loc_sed.U): can share this executable will have the same full pathname to 'sed.' +gccansipedantic (gccvers.U): + If GNU cc (gcc) is used, this variable will enable (if set) the + -ansi and -pedantic ccflags for building core files (through + cflags script). (See Porting/pumpkin.pod for full description). + gccosandvers (gccvers.U): - If GNU cc (gcc) is used, this variable the operating system and - version used to compile the gcc. It is set to '' if not gcc, + If GNU cc (gcc) is used, this variable holds the operating system + and version used to compile gcc. It is set to '' if not gcc, or if nothing useful can be parsed as the os version. gccversion (gccvers.U): - If GNU cc (gcc) is used, this variable holds '1' or '2' to + If GNU cc (gcc) is used, this variable holds '1' or '2' to indicate whether the compiler is version 1 or 2. This is used in setting some of the default cflags. It is set to '' if not gcc. @@ -2537,6 +2658,11 @@ gmtime_r_proto (d_gmtime_r.U): REENTRANT_PROTO_T_ABC macros of reentr.h if d_gmtime_r is defined. +gnulibc_version (d_gnulibc.U): + This variable contains the version number of the GNU C library. + It is usually something like '2.2.5'. It is a plain '' if this + is not the GNU C library, or if the version is unknown. + grep (Loc.U): This variable is used internally by Configure to determine the full pathname (if any) of the grep program. After Configure runs, @@ -2579,6 +2705,27 @@ hostcat (nis.U): On some systems, such as os390, there may be no equivalent command, in which case this variable is unset. +html1dir (html1dir.U): + This variable contains the name of the directory in which html + source pages are to be put. This directory is for pages + that describe whole programs, not libraries or modules. It + is intended to correspond roughly to section 1 of the Unix + manuals. + +html1direxp (html1dir.U): + This variable is the same as the html1dir variable, but is filename + expanded at configuration time, for convenient use in makefiles. + +html3dir (html3dir.U): + This variable contains the name of the directory in which html + source pages are to be put. This directory is for pages + that describe libraries or modules. It is intended to + correspond roughly to section 3 of the Unix manuals. + +html3direxp (html3dir.U): + This variable is the same as the html3dir variable, but is filename + expanded at configuration time, for convenient use in makefiles. + i16size (perlxv.U): This variable is the size of an I16 in bytes. @@ -2995,6 +3142,16 @@ installbin (bin.U): the user is explicitely prompted for it. This variable should always be used in your makefiles for maximum portability. +installhtml1dir (html1dir.U): + This variable is really the same as html1direxp, unless you are + using a different installprefix. For extra portability, you + should only use this variable within your makefiles. + +installhtml3dir (html3dir.U): + This variable is really the same as html3direxp, unless you are + using a different installprefix. For extra portability, you + should only use this variable within your makefiles. + installman1dir (man1dir.U): This variable is really the same as man1direxp, unless you are using AFS in which case it points to the read/write location whereas @@ -3039,11 +3196,40 @@ 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. +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. + +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. + installsitelib (sitelib.U): This variable is really the same as sitelibexp but may differ on those systems using AFS. For extra portability, only this variable should be used in makefiles. +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. + +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. + +installsitescript (sitescript.U): + This variable is usually the same as sitescriptexp, unless you are on + a system running AFS, in which case they may differ slightly. You + should always use this variable within your makefiles for portability. + installstyle (installstyle.U): This variable describes the "style" of the perl installation. This is intended to be useful for tools that need to @@ -3056,9 +3242,27 @@ installstyle (installstyle.U): 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 + + Unfortunately, while this "style" variable is used to set + defaults for all three directory hierarchies (core, vendor, and + site), there is no guarantee that the same style is actually + appropriate for all those directories. For example, $prefix + might be /opt/perl, but $siteprefix might be /usr/local. + (Perhaps, in retrospect, the "lib" style should never have been + supported, but it did seem like a nice idea at the time.) + + The situation is even less clear for tools such as MakeMaker + that can be used to install additional modules into + non-standard places. For example, if a user intends to install + a module into a private directory (perhaps by setting PREFIX on + the Makefile.PL command line), then there is no reason to + assume that the Configure-time $installstyle setting will be + relevant for that PREFIX. + + 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 + + For compatibility with perl5.005 and earlier, the default setting is based on whether or not $prefix contains the string "perl". @@ -3077,11 +3281,36 @@ installvendorbin (vendorbin.U): those systems using AFS. For extra portability, only this variable should be used in makefiles. +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. + +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. + 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. +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. + +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. + +installvendorscript (vendorscript.U): + This variable is really the same as vendorscriptexp 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. @@ -3282,9 +3511,12 @@ make_set_make (make.U): This variable contains the string to be included in Makefile.SH so that MAKE is set if needed, and not if not needed. Possible values are: + 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 + + This uses a comment character to distinguish a 'set' value (from a previous config.sh or Configure '-D' option) from an uncomputed value. @@ -3342,6 +3574,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, @@ -3631,21 +3871,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. @@ -3898,8 +4123,8 @@ sig_count (sig_name.U): 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 - list. This is currently not used. + SIG in signal name is removed. A ZERO is prepended to the list. + This is currently not used, sig_name_init is used instead. sig_name_init (sig_name.U): This variable holds the signal names, enclosed in double quotes and @@ -3910,10 +4135,10 @@ sig_name_init (sig_name.U): sig_num (sig_name.U): This variable holds the signal numbers, space separated. A ZERO is - prepended to the list (corresponding to the fake SIGZERO), and - the list is terminated with a 0. Those numbers correspond to - the value of the signal listed in the same place within the - sig_name list. + prepended to the list (corresponding to the fake SIGZERO). + Those numbers correspond to the value of the signal listed + in the same place within the sig_name list. + This is currently not used, sig_num_init is used instead. sig_num_init (sig_name.U): This variable holds the signal numbers, enclosed in double quotes and @@ -3923,7 +4148,7 @@ sig_num_init (sig_name.U): sig_size (sig_name.U): This variable contains the number of elements of the sig_name - and sig_num arrays, excluding the final NULL entry. + and sig_num arrays. signal_t (d_voidsig.U): This variable holds the type of the signal handler (void or int). @@ -3958,6 +4183,36 @@ sitebinexp (sitebin.U): This is the same as the sitebin variable, but is filename expanded at configuration time, for use in your makefiles. +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. + You must be prepared to do the ~name expansion yourself. + The standard distribution will put nothing in this directory. + After perl has been installed, users may install their own local + html pages in this directory with + MakeMaker Makefile.PL + or equivalent. See INSTALL for details. + +sitehtml1direxp (sitehtml1dir.U): + This variable is the same as the sitehtml1dir variable, but is filename + expanded at configuration time, for convenient use in makefiles. + +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. + You must be prepared to do the ~name expansion yourself. + The standard distribution will put nothing in this directory. + After perl has been installed, users may install their own local + library html pages in this directory with + MakeMaker Makefile.PL + or equivalent. See INSTALL for details. + +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): This variable contains the eventual value of the SITELIB symbol, which is the name of the private library for this package. It may @@ -3978,6 +4233,36 @@ sitelibexp (sitelib.U): This variable is the ~name expanded version of sitelib, so that you may use it directly in Makefiles or shell scripts. +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. + You must be prepared to do the ~name expansion yourself. + The standard distribution will put nothing in this directory. + After perl has been installed, users may install their own local + man1 pages in this directory with + MakeMaker Makefile.PL + or equivalent. See INSTALL for details. + +siteman1direxp (siteman1dir.U): + This variable is the same as the siteman1dir variable, but is filename + expanded at configuration time, for convenient use in makefiles. + +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. + You must be prepared to do the ~name expansion yourself. + The standard distribution will put nothing in this directory. + After perl has been installed, users may install their own local + man3 pages in this directory with + MakeMaker Makefile.PL + or equivalent. See INSTALL for details. + +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): This variable holds the full absolute path of the directory below which the user will install add-on packages. @@ -3987,6 +4272,21 @@ 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. +sitescript (sitescript.U): + This variable holds the name of the directory in which the user wants + to put add-on publicly executable files for the package in question. It + is most often a local directory such as /usr/local/bin. Programs using + this variable must be prepared to deal with ~name substitution. + The standard distribution will put nothing in this directory. + After perl has been installed, users may install their own local + scripts in this directory with + MakeMaker Makefile.PL + or equivalent. See INSTALL for details. + +sitescriptexp (sitescript.U): + This is the same as the sitescript variable, but is filename expanded at + configuration time, for use in your makefiles. + sizesize (sizesize.U): This variable contains the size of a sizetype in bytes. @@ -4350,6 +4650,11 @@ usedl (dlsrc.U): This variable indicates if the system supports dynamic loading of some sort. See also dlsrc and dlobj. +usefaststdio (usefaststdio.U): + This variable conditionally defines the USE_FAST_STDIO symbol, + and indicates that Perl should be built to use 'fast stdio'. + Defaults to define in Perls 5.8 and earlier, to undef later. + useithreads (usethreads.U): This variable conditionally defines the USE_ITHREADS symbol, and indicates that Perl should be built to use the interpreter-based @@ -4364,6 +4669,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 @@ -4410,6 +4719,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 @@ -4418,8 +4734,8 @@ usesfio (d_sfio.U): d_sfio without running into a "WHOA THERE". useshrplib (libperl.U): - This variable is set to 'yes' if the user wishes - to build a shared libperl, and 'no' otherwise. + This variable is set to 'true' if the user wishes + to build a shared libperl, and 'false' otherwise. usesocks (usesocks.U): This variable conditionally defines the USE_SOCKS symbol, @@ -4494,6 +4810,32 @@ vendorbinexp (vendorbin.U): This variable is the ~name expanded version of vendorbin, so that you may use it directly in Makefiles or shell scripts. +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. + Vendors who distribute perl may wish to place their own + html pages in this directory with + MakeMaker Makefile.PL INSTALLDIRS=vendor + or equivalent. See INSTALL for details. + +vendorhtml1direxp (vendorhtml1dir.U): + This variable is the ~name expanded version of vendorhtml1dir, so that you + may use it directly in Makefiles or shell scripts. + +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. + Vendors who distribute perl may wish to place their own + html pages for modules and extensions in this directory with + MakeMaker Makefile.PL INSTALLDIRS=vendor + or equivalent. See INSTALL for details. + +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): This variable contains the eventual value of the VENDORLIB symbol, which is the name of the private library for this package. @@ -4512,6 +4854,32 @@ vendorlibexp (vendorlib.U): This variable is the ~name expanded version of vendorlib, so that you may use it directly in Makefiles or shell scripts. +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. + Vendors who distribute perl may wish to place their own + man1 pages in this directory with + MakeMaker Makefile.PL INSTALLDIRS=vendor + or equivalent. See INSTALL for details. + +vendorman1direxp (vendorman1dir.U): + This variable is the ~name expanded version of vendorman1dir, so that you + may use it directly in Makefiles or shell scripts. + +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. + Vendors who distribute perl may wish to place their own + man3 pages in this directory with + MakeMaker Makefile.PL INSTALLDIRS=vendor + or equivalent. See INSTALL for details. + +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): This variable holds the full absolute path of the directory below which the vendor will install add-on packages. @@ -4521,6 +4889,19 @@ 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. +vendorscript (vendorscript.U): + This variable contains the eventual value of the VENDORSCRIPT symbol. + It may have a ~ on the front. + The standard distribution will put nothing in this directory. + Vendors who distribute perl may wish to place additional + executable scripts in this directory with + MakeMaker Makefile.PL INSTALLDIRS=vendor + or equivalent. See INSTALL for details. + +vendorscriptexp (vendorscript.U): + This variable is the ~name expanded version of vendorscript, so that you + may use it directly in Makefiles or shell scripts. + version (patchlevel.U): The full version number of this package, such as 5.6.1 (or 5_6_1). This combines revision, patchlevel, and subversion to get the @@ -4563,23 +4944,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.