X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=Porting%2FGlossary;h=99b8e34e7a043ed0d957e9c5c18c52f279ec3689;hb=c74ace89800a81a764294e9f6eacc04bbed5a568;hp=9058be0d76009eb367263f5343fbb199e2bdf60a;hpb=f05fc11dca96b2991d1e73772c29eaf3c9254ec4;p=p5sagit%2Fp5-mst-13.2.git diff --git a/Porting/Glossary b/Porting/Glossary index 9058be0..99b8e34 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -8,25 +8,6 @@ programs (e.g. I_UNISTD) are already described in config_h.SH. [`configpm' generates pod documentation for Config.pm from this file--please try to keep the formatting regular.] -Mcc (Loc.U): - This variable is used internally by Configure to determine the - full pathname (if any) of the Mcc program. After Configure runs, - the value is reset to a plain "Mcc" and is not useful. - -PERL_REVISION (Oldsyms.U): - In a Perl version number such as 5.6.2, this is the 5. - This value is manually set in patchlevel.h - -PERL_SUBVERSION (Oldsyms.U): - In a Perl version number such as 5.6.2, this is the 2. - Values greater than 50 represent potentially unstable - development subversions. - This value is manually set in patchlevel.h - -PERL_VERSION (Oldsyms.U): - In a Perl version number such as 5.6.2, this is the 6. - This value is manually set in patchlevel.h - _a (Unix.U): This variable defines the extension used for ordinary library files. For unix, it is '.a'. The '.' is included. Other possible @@ -315,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): @@ -386,88 +367,6 @@ ctime_r_proto (d_ctime_r.U): REENTRANT_PROTO_T_ABC macros of reentr.h if d_ctime_r is defined. -d_Gconvert (d_gconvert.U): - This variable holds what Gconvert is defined as to convert - floating point numbers into strings. By default, Configure - sets this macro to use the first of gconvert, gcvt, or sprintf - that pass sprintf-%g-like behaviour tests. If perl is using - long doubles, the macro uses the first of the following - functions that pass Configure's tests: qgcvt, sprintf (if - Configure knows how to make sprintf format long doubles--see - sPRIgldbl), gconvert, gcvt, and sprintf (casting to double). - The gconvert_preference and gconvert_ld_preference variables - can be used to alter Configure's preferences, for doubles and - 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- - 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 - loss of precision. - -d_PRIEUldbl (longdblfio.U): - This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. - The 'U' in the name is to separate this from d_PRIeldbl so that even - case-blind systems can see the difference. - -d_PRIFUldbl (longdblfio.U): - This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. - The 'U' in the name is to separate this from d_PRIfldbl so that even - case-blind systems can see the difference. - -d_PRIGUldbl (longdblfio.U): - This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. - The 'U' in the name is to separate this from d_PRIgldbl so that even - case-blind systems can see the difference. - -d_PRIXU64 (quadfio.U): - This variable conditionally defines the PERL_PRIXU64 symbol, which - indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers. - The 'U' in the name is to separate this from d_PRIx64 so that even - case-blind systems can see the difference. - -d_PRId64 (quadfio.U): - This variable conditionally defines the PERL_PRId64 symbol, which - indiciates that stdio has a symbol to print 64-bit decimal numbers. - -d_PRIeldbl (longdblfio.U): - This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. - -d_PRIfldbl (longdblfio.U): - This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. - -d_PRIgldbl (longdblfio.U): - This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to print long doubles. - -d_PRIi64 (quadfio.U): - This variable conditionally defines the PERL_PRIi64 symbol, which - indiciates that stdio has a symbol to print 64-bit decimal numbers. - -d_PRIo64 (quadfio.U): - This variable conditionally defines the PERL_PRIo64 symbol, which - indiciates that stdio has a symbol to print 64-bit octal numbers. - -d_PRIu64 (quadfio.U): - This variable conditionally defines the PERL_PRIu64 symbol, which - indiciates that stdio has a symbol to print 64-bit unsigned decimal - numbers. - -d_PRIx64 (quadfio.U): - This variable conditionally defines the PERL_PRIx64 symbol, which - indiciates that stdio has a symbol to print 64-bit hexadecimal numbers. - -d_SCNfldbl (longdblfio.U): - This variable conditionally defines the PERL_PRIfldbl symbol, which - indiciates that stdio has a symbol to scan long doubles. - d__fwalk (d__fwalk.U): This variable conditionally defines HAS__FWALK if _fwalk() is available to apply a function to all the file handles. @@ -480,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. @@ -502,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 @@ -575,6 +511,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 @@ -730,6 +671,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. @@ -860,6 +806,27 @@ d_ftime (d_ftime.U): that the ftime() routine exists. The ftime() routine is basically a sub-second accuracy clock. +d_Gconvert (d_gconvert.U): + This variable holds what Gconvert is defined as to convert + floating point numbers into strings. By default, Configure + sets this macro to use the first of gconvert, gcvt, or sprintf + that pass sprintf-%g-like behaviour tests. If perl is using + long doubles, the macro uses the first of the following + functions that pass Configure's tests: qgcvt, sprintf (if + Configure knows how to make sprintf format long doubles--see + sPRIgldbl), gconvert, gcvt, and sprintf (casting to double). + The gconvert_preference and gconvert_ld_preference variables + can be used to alter Configure's preferences, for doubles and + 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- + 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 + loss of precision. + d_getcwd (d_getcwd.U): This variable conditionally defines the HAS_GETCWD symbol, which indicates to the C program that the getcwd() routine is available @@ -1157,6 +1124,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. @@ -1399,10 +1371,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. @@ -1473,6 +1441,63 @@ d_portable (d_portable.U): indicates to the C program that it should not assume that it is running on the machine it was compiled on. +d_PRId64 (quadfio.U): + This variable conditionally defines the PERL_PRId64 symbol, which + indiciates that stdio has a symbol to print 64-bit decimal numbers. + +d_PRIeldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldbl symbol, which + indiciates that stdio has a symbol to print long doubles. + +d_PRIEUldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldbl symbol, which + indiciates that stdio has a symbol to print long doubles. + The 'U' in the name is to separate this from d_PRIeldbl so that even + case-blind systems can see the difference. + +d_PRIfldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldbl symbol, which + indiciates that stdio has a symbol to print long doubles. + +d_PRIFUldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldbl symbol, which + indiciates that stdio has a symbol to print long doubles. + The 'U' in the name is to separate this from d_PRIfldbl so that even + case-blind systems can see the difference. + +d_PRIgldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldbl symbol, which + indiciates that stdio has a symbol to print long doubles. + +d_PRIGUldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldbl symbol, which + indiciates that stdio has a symbol to print long doubles. + The 'U' in the name is to separate this from d_PRIgldbl so that even + case-blind systems can see the difference. + +d_PRIi64 (quadfio.U): + This variable conditionally defines the PERL_PRIi64 symbol, which + indiciates that stdio has a symbol to print 64-bit decimal numbers. + +d_PRIo64 (quadfio.U): + This variable conditionally defines the PERL_PRIo64 symbol, which + indiciates that stdio has a symbol to print 64-bit octal numbers. + +d_PRIu64 (quadfio.U): + This variable conditionally defines the PERL_PRIu64 symbol, which + indiciates that stdio has a symbol to print 64-bit unsigned decimal + numbers. + +d_PRIx64 (quadfio.U): + This variable conditionally defines the PERL_PRIx64 symbol, which + indiciates that stdio has a symbol to print 64-bit hexadecimal numbers. + +d_PRIXU64 (quadfio.U): + This variable conditionally defines the PERL_PRIXU64 symbol, which + indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers. + The 'U' in the name is to separate this from d_PRIx64 so that even + case-blind systems can see the difference. + d_procselfexe (d_procselfexe.U): Defined if $procselfexe is symlink to the absolute pathname of the executing program. @@ -1482,6 +1507,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 @@ -1593,6 +1623,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 @@ -1603,6 +1638,10 @@ d_scm_rights (d_socket.U): which indicates that the SCM_RIGHTS is available. #ifdef is not enough because it may be an enum, glibc has been known to do this. +d_SCNfldbl (longdblfio.U): + This variable conditionally defines the PERL_PRIfldbl symbol, which + indiciates that stdio has a symbol to scan long doubles. + d_seekdir (d_readdir.U): This variable conditionally defines HAS_SEEKDIR if seekdir() is available. @@ -1967,6 +2006,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 @@ -2354,10 +2401,6 @@ extensions (Extensions.U): extras (Extras.U): This variable holds a list of extra modules to install. -fflushNULL (fflushall.U): - This symbol, if defined, tells that fflush(NULL) does flush - all pending stdio output. - fflushall (fflushall.U): This symbol, if defined, tells that to flush all pending stdio output one must loop through all @@ -2365,6 +2408,10 @@ fflushall (fflushall.U): Note that if fflushNULL is defined, fflushall will not even be probed for and will be left undefined. +fflushNULL (fflushall.U): + This symbol, if defined, tells that fflush(NULL) does flush + all pending stdio output. + find (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. @@ -3119,14 +3166,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. @@ -3136,14 +3183,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. @@ -3204,13 +3251,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. @@ -3219,13 +3266,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. @@ -3488,10 +3535,23 @@ man3ext (man3dir.U): have: one of 'n', 'l', or '3'. The Makefile must supply the '.'. See man3dir. +Mcc (Loc.U): + This variable is used internally by Configure to determine the + full pathname (if any) of the Mcc program. After Configure runs, + the value is reset to a plain "Mcc" and is not useful. + mips_type (usrinc.U): This variable holds the environment type for the mips system. Possible values are "BSD 4.3" and "System V". +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, @@ -3603,18 +3663,6 @@ 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. -nvEUformat (perlxvf.U): - This variable contains the format string used for printing - a Perl NV using %E-ish floating point format. - -nvFUformat (perlxvf.U): - This variable confains the format string used for printing - a Perl NV using %F-ish floating point format. - -nvGUformat (perlxvf.U): - This variable contains the format string used for printing - a Perl NV using %G-ish floating point format. - nv_preserves_uv_bits (perlxv.U): This variable indicates how many of bits type uvtype a variable nvtype can preserve. @@ -3623,14 +3671,26 @@ nveformat (perlxvf.U): This variable contains the format string used for printing a Perl NV using %e-ish floating point format. +nvEUformat (perlxvf.U): + This variable contains the format string used for printing + a Perl NV using %E-ish floating point format. + nvfformat (perlxvf.U): This variable confains the format string used for printing a Perl NV using %f-ish floating point format. +nvFUformat (perlxvf.U): + This variable confains the format string used for printing + a Perl NV using %F-ish floating point format. + nvgformat (perlxvf.U): This variable contains the format string used for printing a Perl NV using %g-ish floating point format. +nvGUformat (perlxvf.U): + This variable contains the format string used for printing + a Perl NV using %G-ish floating point format. + nvsize (perlxv.U): This variable is the size of an NV in bytes. @@ -3717,11 +3777,6 @@ perl5 (perl5.U): installed perl5.005 or later suitable for running the script to determine inc_version_list. -perl5 (perl5.U): - This variable contains the full path (if any) to a previously - installed perl5.005 or later suitable for running the script - to determine inc_version_list. - perl (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. @@ -3734,6 +3789,20 @@ perl_patchlevel (patchlevel.U): the maintenance versus development dichotomy except by also being increasing. +PERL_REVISION (Oldsyms.U): + In a Perl version number such as 5.6.2, this is the 5. + This value is manually set in patchlevel.h + +PERL_SUBVERSION (Oldsyms.U): + In a Perl version number such as 5.6.2, this is the 2. + Values greater than 50 represent potentially unstable + development subversions. + This value is manually set in patchlevel.h + +PERL_VERSION (Oldsyms.U): + In a Perl version number such as 5.6.2, this is the 6. + This value is manually set in patchlevel.h + perladmin (perladmin.U): Electronic mail address of the perl5 administrator. @@ -3772,21 +3841,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. @@ -3904,66 +3958,6 @@ runnm (usenm.U): nm extraction should be performed or not, according to the value of usenm and the flags on the Configure command line. -sPRIEUldbl (longdblfio.U): - This variable, if defined, contains the string used by stdio to - format long doubles (format 'E') for output. - The 'U' in the name is to separate this from sPRIeldbl so that even - case-blind systems can see the difference. - -sPRIFUldbl (longdblfio.U): - This variable, if defined, contains the string used by stdio to - format long doubles (format 'F') for output. - The 'U' in the name is to separate this from sPRIfldbl so that even - case-blind systems can see the difference. - -sPRIGUldbl (longdblfio.U): - This variable, if defined, contains the string used by stdio to - format long doubles (format 'G') for output. - The 'U' in the name is to separate this from sPRIgldbl so that even - case-blind systems can see the difference. - -sPRIXU64 (quadfio.U): - This variable, if defined, contains the string used by stdio to - format 64-bit hExADECimAl numbers (format 'X') for output. - The 'U' in the name is to separate this from sPRIx64 so that even - case-blind systems can see the difference. - -sPRId64 (quadfio.U): - This variable, if defined, contains the string used by stdio to - format 64-bit decimal numbers (format 'd') for output. - -sPRIeldbl (longdblfio.U): - This variable, if defined, contains the string used by stdio to - format long doubles (format 'e') for output. - -sPRIfldbl (longdblfio.U): - This variable, if defined, contains the string used by stdio to - format long doubles (format 'f') for output. - -sPRIgldbl (longdblfio.U): - This variable, if defined, contains the string used by stdio to - format long doubles (format 'g') for output. - -sPRIi64 (quadfio.U): - This variable, if defined, contains the string used by stdio to - format 64-bit decimal numbers (format 'i') for output. - -sPRIo64 (quadfio.U): - This variable, if defined, contains the string used by stdio to - format 64-bit octal numbers (format 'o') for output. - -sPRIu64 (quadfio.U): - This variable, if defined, contains the string used by stdio to - format 64-bit unsigned decimal numbers (format 'u') for output. - -sPRIx64 (quadfio.U): - This variable, if defined, contains the string used by stdio to - format 64-bit hexadecimal numbers (format 'x') for output. - -sSCNfldbl (longdblfio.U): - This variable, if defined, contains the string used by stdio to - format long doubles (format 'f') for input. - sched_yield (d_pthread_y.U): This variable defines the way to yield the execution of the current thread. @@ -4159,7 +4153,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. @@ -4170,11 +4164,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. @@ -4185,8 +4179,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): @@ -4209,7 +4203,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. @@ -4220,11 +4214,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. @@ -4235,8 +4229,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): @@ -4308,6 +4302,62 @@ spitshell (spitshell.U): This variable contains the command necessary to spit out a runnable shell on this system. It is either cat or a grep '-v' for # comments. +sPRId64 (quadfio.U): + This variable, if defined, contains the string used by stdio to + format 64-bit decimal numbers (format 'd') for output. + +sPRIeldbl (longdblfio.U): + This variable, if defined, contains the string used by stdio to + format long doubles (format 'e') for output. + +sPRIEUldbl (longdblfio.U): + This variable, if defined, contains the string used by stdio to + format long doubles (format 'E') for output. + The 'U' in the name is to separate this from sPRIeldbl so that even + case-blind systems can see the difference. + +sPRIfldbl (longdblfio.U): + This variable, if defined, contains the string used by stdio to + format long doubles (format 'f') for output. + +sPRIFUldbl (longdblfio.U): + This variable, if defined, contains the string used by stdio to + format long doubles (format 'F') for output. + The 'U' in the name is to separate this from sPRIfldbl so that even + case-blind systems can see the difference. + +sPRIgldbl (longdblfio.U): + This variable, if defined, contains the string used by stdio to + format long doubles (format 'g') for output. + +sPRIGUldbl (longdblfio.U): + This variable, if defined, contains the string used by stdio to + format long doubles (format 'G') for output. + The 'U' in the name is to separate this from sPRIgldbl so that even + case-blind systems can see the difference. + +sPRIi64 (quadfio.U): + This variable, if defined, contains the string used by stdio to + format 64-bit decimal numbers (format 'i') for output. + +sPRIo64 (quadfio.U): + This variable, if defined, contains the string used by stdio to + format 64-bit octal numbers (format 'o') for output. + +sPRIu64 (quadfio.U): + This variable, if defined, contains the string used by stdio to + format 64-bit unsigned decimal numbers (format 'u') for output. + +sPRIx64 (quadfio.U): + This variable, if defined, contains the string used by stdio to + format 64-bit hexadecimal numbers (format 'x') for output. + +sPRIXU64 (quadfio.U): + This variable, if defined, contains the string used by stdio to + format 64-bit hExADECimAl numbers (format 'X') for output. + The 'U' in the name is to separate this from sPRIx64 so that even + case-blind systems can see the difference. + 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 @@ -4325,6 +4375,10 @@ src (src.U): the Makefile to use this variable and set VPATH accordingly to find the sources remotely. +sSCNfldbl (longdblfio.U): + This variable, if defined, contains the string used by stdio to + format long doubles (format 'f') for input. + ssizetype (ssizetype.U): This variable defines ssizetype to be something like ssize_t, long or int. It is used by functions that return a count @@ -4566,6 +4620,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 @@ -4580,6 +4639,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 @@ -4626,6 +4689,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 @@ -4662,10 +4732,6 @@ uuname (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. -uvXUformat (perlxvf.U): - This variable contains the format string used for printing - a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF. - uvoformat (perlxvf.U): This variable contains the format string used for printing a Perl UV as an unsigned octal integer. @@ -4684,6 +4750,10 @@ uvxformat (perlxvf.U): This variable contains the format string used for printing a Perl UV as an unsigned hexadecimal integer in lowercase abcdef. +uvXUformat (perlxvf.U): + This variable contains the format string used for printing + a Perl UV as an unsigned hexadecimal integer in uppercase ABCDEF. + vendorarch (vendorarch.U): This variable contains the value of the PERL_VENDORARCH symbol. It may have a ~ on the front. @@ -4710,7 +4780,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. @@ -4719,11 +4789,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. @@ -4732,8 +4802,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): @@ -4754,7 +4824,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. @@ -4763,11 +4833,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. @@ -4776,8 +4846,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): @@ -4844,22 +4914,9 @@ 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. yaccflags (yacc.U): This variable contains any additional yacc flags desired by the