X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=Porting%2FGlossary;h=91f315b35e56ba076e70cc0318416248a1c3e2ec;hb=9483776f29dbf67c9f5f68dcc7dd77bf0eb0eeb5;hp=a9b86e2fad650d7c5416f4a368b997535fd57592;hpb=53133ed1c5068175ce48d34c24e23b1aa3a97766;p=p5sagit%2Fp5-mst-13.2.git diff --git a/Porting/Glossary b/Porting/Glossary index a9b86e2..91f315b 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' @@ -5,13 +9,15 @@ generates pod documentation for Config.pm from this file--please try to keep the formatting regular.] _a (Unix.U): - This variable defines the extension used for ordinary libraries. + This variable defines the extension used for ordinary library files. For unix, it is '.a'. The '.' is included. Other possible values include '.lib'. _exe (Unix.U): This variable defines the extension used for executable files. - For unix it is empty. Other possible values include '.exe'. + DJGPP, Cygwin and OS/2 use '.exe'. Stratus VOS uses '.pm'. + On operating systems which do not require a specific extension + for executable files, this variable is empty. _o (Unix.U): This variable defines the extension used for object files. @@ -51,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. @@ -59,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. @@ -120,6 +128,9 @@ archobjs (Unix.U): asctime_r_proto (d_asctime_r.U): This variable encodes the prototype of asctime_r. + It is zero if d_asctime_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_asctime_r + is defined. awk (Loc.U): This variable is used internally by Configure to determine the @@ -139,10 +150,6 @@ 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 this version of Perl 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. @@ -158,10 +165,10 @@ byacc (Loc.U): the value is reset to a plain "byacc" and is not useful. byteorder (byteorder.U): - This variable holds the byte order. In the following, larger digits - indicate more significance. The variable byteorder is either 4321 - on a big-endian machine, or 1234 on a little-endian, or 87654321 - on a Cray ... or 3412 with weird order ! + This variable holds the byte order in a UV. In the following, + larger digits indicate more significance. The variable byteorder + is either 4321 on a big-endian machine, or 1234 on a little-endian, + or 87654321 on a Cray ... or 3412 with weird order ! c (n.U): This variable contains the \c string if that is what causes the echo @@ -289,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): @@ -334,6 +341,9 @@ cppsymbols (Cppsym.U): crypt_r_proto (d_crypt_r.U): This variable encodes the prototype of crypt_r. + It is zero if d_crypt_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_crypt_r + is defined. cryptlib (d_crypt.U): This variable holds -lcrypt or the path to a libcrypt.a archive if @@ -347,9 +357,15 @@ csh (Loc.U): ctermid_r_proto (d_ctermid_r.U): This variable encodes the prototype of ctermid_r. + It is zero if d_ctermid_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_ctermid_r + is defined. ctime_r_proto (d_ctime_r.U): This variable encodes the prototype of ctime_r. + It is zero if d_ctime_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_ctime_r + is defined. d__fwalk (d__fwalk.U): This variable conditionally defines HAS__FWALK if _fwalk() is @@ -363,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. @@ -398,13 +419,6 @@ 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 this version of Perl 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. @@ -465,6 +479,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 @@ -620,6 +639,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. @@ -764,7 +788,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 @@ -1067,6 +1092,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. @@ -1237,6 +1267,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. @@ -1315,10 +1351,6 @@ 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. -nv_preserves_uv_bits (perlxv.U): - This variable indicates how many of bits type uvtype - a variable nvtype can preserve. - d_off64_t (d_off64_t.U): This symbol will be defined if the C compiler supports off64_t. @@ -1443,6 +1475,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 @@ -1554,6 +1591,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 @@ -2112,6 +2154,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. @@ -2225,6 +2270,9 @@ drand01 (randfunc.U): drand48_r_proto (d_drand48_r.U): This variable encodes the prototype of drand48_r. + It is zero if d_drand48_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_drand48_r + is defined. dynamic_ext (Extensions.U): This variable holds a list of XS extension files we want to @@ -2257,21 +2305,39 @@ emacs (Loc.U): endgrent_r_proto (d_endgrent_r.U): This variable encodes the prototype of endgrent_r. + It is zero if d_endgrent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_endgrent_r + is defined. endhostent_r_proto (d_endhostent_r.U): This variable encodes the prototype of endhostent_r. + It is zero if d_endhostent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_endhostent_r + is defined. endnetent_r_proto (d_endnetent_r.U): This variable encodes the prototype of endnetent_r. + It is zero if d_endnetent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_endnetent_r + is defined. endprotoent_r_proto (d_endprotoent_r.U): This variable encodes the prototype of endprotoent_r. + It is zero if d_endprotoent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_endprotoent_r + is defined. endpwent_r_proto (d_endpwent_r.U): This variable encodes the prototype of endpwent_r. + It is zero if d_endpwent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_endpwent_r + is defined. endservent_r_proto (d_endservent_r.U): This variable encodes the prototype of endservent_r. + It is zero if d_endservent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_endservent_r + is defined. eunicefix (Init.U): When running under Eunice this variable contains a command which will @@ -2356,75 +2422,140 @@ 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. getgrent_r_proto (d_getgrent_r.U): This variable encodes the prototype of getgrent_r. + It is zero if d_getgrent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getgrent_r + is defined. getgrgid_r_proto (d_getgrgid_r.U): This variable encodes the prototype of getgrgid_r. + It is zero if d_getgrgid_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getgrgid_r + is defined. getgrnam_r_proto (d_getgrnam_r.U): This variable encodes the prototype of getgrnam_r. + It is zero if d_getgrnam_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getgrnam_r + is defined. gethostbyaddr_r_proto (d_gethostbyaddr_r.U): This variable encodes the prototype of gethostbyaddr_r. + It is zero if d_gethostbyaddr_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_gethostbyaddr_r + is defined. gethostbyname_r_proto (d_gethostbyname_r.U): This variable encodes the prototype of gethostbyname_r. + It is zero if d_gethostbyname_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_gethostbyname_r + is defined. gethostent_r_proto (d_gethostent_r.U): This variable encodes the prototype of gethostent_r. + It is zero if d_gethostent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_gethostent_r + is defined. getlogin_r_proto (d_getlogin_r.U): This variable encodes the prototype of getlogin_r. + It is zero if d_getlogin_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getlogin_r + is defined. getnetbyaddr_r_proto (d_getnetbyaddr_r.U): This variable encodes the prototype of getnetbyaddr_r. + It is zero if d_getnetbyaddr_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getnetbyaddr_r + is defined. getnetbyname_r_proto (d_getnetbyname_r.U): This variable encodes the prototype of getnetbyname_r. + It is zero if d_getnetbyname_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getnetbyname_r + is defined. getnetent_r_proto (d_getnetent_r.U): This variable encodes the prototype of getnetent_r. + It is zero if d_getnetent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getnetent_r + is defined. getprotobyname_r_proto (d_getprotobyname_r.U): This variable encodes the prototype of getprotobyname_r. + It is zero if d_getprotobyname_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getprotobyname_r + is defined. getprotobynumber_r_proto (d_getprotobynumber_r.U): This variable encodes the prototype of getprotobynumber_r. + It is zero if d_getprotobynumber_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getprotobynumber_r + is defined. getprotoent_r_proto (d_getprotoent_r.U): This variable encodes the prototype of getprotoent_r. + It is zero if d_getprotoent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getprotoent_r + is defined. getpwent_r_proto (d_getpwent_r.U): This variable encodes the prototype of getpwent_r. + It is zero if d_getpwent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getpwent_r + is defined. getpwnam_r_proto (d_getpwnam_r.U): This variable encodes the prototype of getpwnam_r. + It is zero if d_getpwnam_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getpwnam_r + is defined. getpwuid_r_proto (d_getpwuid_r.U): This variable encodes the prototype of getpwuid_r. + It is zero if d_getpwuid_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getpwuid_r + is defined. getservbyname_r_proto (d_getservbyname_r.U): This variable encodes the prototype of getservbyname_r. + It is zero if d_getservbyname_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getservbyname_r + is defined. getservbyport_r_proto (d_getservbyport_r.U): This variable encodes the prototype of getservbyport_r. + It is zero if d_getservbyport_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getservbyport_r + is defined. getservent_r_proto (d_getservent_r.U): This variable encodes the prototype of getservent_r. + It is zero if d_getservent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getservent_r + is defined. getspnam_r_proto (d_getspnam_r.U): This variable encodes the prototype of getspnam_r. + It is zero if d_getspnam_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_getspnam_r + is defined. gidformat (gidf.U): This variable contains the format string used for printing a Gid_t. @@ -2453,6 +2584,14 @@ gmake (Loc.U): gmtime_r_proto (d_gmtime_r.U): This variable encodes the prototype of gmtime_r. + It is zero if d_gmtime_r is undef, and one of the + 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 @@ -2496,6 +2635,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. @@ -2912,6 +3072,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 @@ -2956,11 +3126,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 @@ -2973,9 +3172,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". @@ -2994,11 +3211,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. @@ -3076,7 +3318,7 @@ libpth (libpth.U): libs (libs.U): This variable holds the additional libraries we want to use. - It is up to the Makefile to deal with it. + It is up to the Makefile to deal with it. The list can be empty. libsdirs (libs.U): This variable holds the directory names aka dirnames of the libraries @@ -3128,6 +3370,9 @@ lns (lns.U): localtime_r_proto (d_localtime_r.U): This variable encodes the prototype of localtime_r. + It is zero if d_localtime_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_localtime_r + is defined. locincpth (ccflags.U): This variable contains a list of additional directories to be @@ -3196,9 +3441,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. @@ -3256,6 +3504,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, @@ -3367,6 +3623,10 @@ 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_preserves_uv_bits (perlxv.U): + This variable indicates how many of bits type uvtype + a variable nvtype can preserve. + nveformat (perlxvf.U): This variable contains the format string used for printing a Perl NV using %e-ish floating point format. @@ -3513,7 +3773,13 @@ perllibs (End.U): perlpath (perlpath.U): This variable contains the eventual value of the PERLPATH symbol, which contains the name of the perl interpreter to be used in - shell scripts and in the "eval 'exec'" idiom. + shell scripts and in the "eval 'exec'" idiom. This variable is + not necessarily the pathname of the file containing the perl + interpreter; you must append the executable extension (_exe) if + it is not already present. Note that Perl code that runs during + the Perl build process cannot reference this variable, as Perl + may not have been installed, or even if installed, may be a + different version of Perl. pg (Loc.U): This variable is used internally by Configure to determine the @@ -3612,6 +3878,9 @@ randfunc (randfunc.U): random_r_proto (d_random_r.U): This variable encodes the prototype of random_r. + It is zero if d_random_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_random_r + is defined. randseedtype (randfunc.U): Indicates the type of the argument of the seedfunc. @@ -3629,9 +3898,15 @@ rd_nodata (nblock_io.U): readdir64_r_proto (d_readdir64_r.U): This variable encodes the prototype of readdir64_r. + It is zero if d_readdir64_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_readdir64_r + is defined. readdir_r_proto (d_readdir_r.U): This variable encodes the prototype of readdir_r. + It is zero if d_readdir_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_readdir_r + is defined. revision (patchlevel.U): The value of revision comes from the patchlevel.h file. @@ -3701,24 +3976,45 @@ sendmail (Loc.U): setgrent_r_proto (d_setgrent_r.U): This variable encodes the prototype of setgrent_r. + It is zero if d_setgrent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_setgrent_r + is defined. sethostent_r_proto (d_sethostent_r.U): This variable encodes the prototype of sethostent_r. + It is zero if d_sethostent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_sethostent_r + is defined. setlocale_r_proto (d_setlocale_r.U): This variable encodes the prototype of setlocale_r. + It is zero if d_setlocale_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_setlocale_r + is defined. setnetent_r_proto (d_setnetent_r.U): This variable encodes the prototype of setnetent_r. + It is zero if d_setnetent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_setnetent_r + is defined. setprotoent_r_proto (d_setprotoent_r.U): This variable encodes the prototype of setprotoent_r. + It is zero if d_setprotoent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_setprotoent_r + is defined. setpwent_r_proto (d_setpwent_r.U): This variable encodes the prototype of setpwent_r. + It is zero if d_setpwent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_setpwent_r + is defined. setservent_r_proto (d_setservent_r.U): This variable encodes the prototype of setservent_r. + It is zero if d_setservent_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_setservent_r + is defined. sh (sh.U): This variable contains the full pathname of the shell used @@ -3772,8 +4068,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 @@ -3784,10 +4080,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 @@ -3797,7 +4093,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). @@ -3832,6 +4128,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 @@ -3852,6 +4178,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. @@ -3861,6 +4217,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. @@ -3964,9 +4335,15 @@ sPRIXU64 (quadfio.U): srand48_r_proto (d_srand48_r.U): This variable encodes the prototype of srand48_r. + It is zero if d_srand48_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_srand48_r + is defined. srandom_r_proto (d_srandom_r.U): This variable encodes the prototype of srandom_r. + It is zero if d_srandom_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_srandom_r + is defined. src (src.U): This variable holds the path to the package source. It is up to @@ -4038,6 +4415,9 @@ stdio_stream_array (stdio_streams.U): strerror_r_proto (d_strerror_r.U): This variable encodes the prototype of strerror_r. + It is zero if d_strerror_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_strerror_r + is defined. strings (i_string.U): This variable holds the full path of the string header that will be @@ -4095,6 +4475,9 @@ timetype (d_time.U): tmpnam_r_proto (d_tmpnam_r.U): This variable encodes the prototype of tmpnam_r. + It is zero if d_tmpnam_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_tmpnam_r + is defined. to (Cross.U): This variable contains the command used by Configure @@ -4124,6 +4507,9 @@ troff (Loc.U): ttyname_r_proto (d_ttyname_r.U): This variable encodes the prototype of ttyname_r. + It is zero if d_ttyname_r is undef, and one of the + REENTRANT_PROTO_T_ABC macros of reentr.h if d_ttyname_r + is defined. u16size (perlxv.U): This variable is the size of an U16 in bytes. @@ -4209,6 +4595,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 @@ -4277,8 +4668,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, @@ -4353,6 +4744,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. @@ -4371,6 +4788,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. @@ -4380,6 +4823,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 @@ -4432,8 +4888,8 @@ xs_apiversion (xs_apiversion.U): 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 (such as - bincompat) it is set by Configure. Other non-default sources + 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