X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=Porting%2FGlossary;h=99b8e34e7a043ed0d957e9c5c18c52f279ec3689;hb=c74ace89800a81a764294e9f6eacc04bbed5a568;hp=771820a5b8d1e163ba5d8f0ef443c5720f2f7143;hpb=5129fff43c4fe08cb17d8789b8a5c778039a25c3;p=p5sagit%2Fp5-mst-13.2.git diff --git a/Porting/Glossary b/Porting/Glossary index 771820a..99b8e34 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -406,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 @@ -1339,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. @@ -1978,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 @@ -3130,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. @@ -3147,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. @@ -3215,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. @@ -3230,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. @@ -3508,7 +3544,7 @@ mips_type (usrinc.U): This variable holds the environment type for the mips system. Possible values are "BSD 4.3" and "System V". -mistrustnm (usenm.U): +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 @@ -3805,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. @@ -4132,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. @@ -4143,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. @@ -4158,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): @@ -4182,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. @@ -4193,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. @@ -4208,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): @@ -4618,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 @@ -4664,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 @@ -4748,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. @@ -4757,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. @@ -4770,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): @@ -4792,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. @@ -4801,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. @@ -4814,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): @@ -4882,23 +4914,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.