X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=Porting%2FGlossary;h=43723bb230d6f6f588772dbb8d6c9649655cbebd;hb=236afa0aa46ede1fe5f6b4825a5e6c14d27b0929;hp=abf9756631a4a6615cd76013dabd93c23541099d;hpb=d620c7b31fc6dbd13dded070810962b5b0782c28;p=p5sagit%2Fp5-mst-13.2.git diff --git a/Porting/Glossary b/Porting/Glossary index abf9756..43723bb 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -112,13 +112,13 @@ archlibexp (archlib.U): This variable is the same as the archlib variable, but is filename expanded at configuration time, for convenient use. -archname64 (use64bits.U): - This variable is used for the 64-bitness part of $archname. - archname (archname.U): This variable is a short name to characterize the current architecture. It is used mainly to construct the default archlib. +archname64 (use64bits.U): + This variable is used for the 64-bitness part of $archname. + archobjs (Unix.U): This variable defines any additional objects that must be linked in with the program on this architecture. On unix, it is usually @@ -406,38 +406,38 @@ 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_attribute_format (d_attribut_format.U): +d_attribute_format (d_attribut.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): +d_attribute_malloc (d_attribut.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): +d_attribute_nonnull (d_attribut.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): +d_attribute_noreturn (d_attribut.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): +d_attribute_pure (d_attribut.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): +d_attribute_unused (d_attribut.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): +d_attribute_warn_unused_result (d_attribut.U): This variable conditionally defines HASATTRIBUTE_WARN_UNUSED_RESULT, which indicates that the C compiler can know that certain functions have a return values @@ -482,6 +482,11 @@ d_bzero (d_bzero.U): This variable conditionally defines the HAS_BZERO symbol if the bzero() routine is available to set memory to 0. +d_c99_variadic_macros (d_c99_variadic.U): + This variable conditionally defines the HAS_C99_VARIADIC_MACROS + symbol, which indicates to the C program that C99 variadic macros + are available. + d_casti32 (d_casti32.U): This variable conditionally defines CASTI32, which indicates whether the C compiler can cast large floats to 32-bit ints. @@ -824,7 +829,7 @@ d_ftime (d_ftime.U): that the ftime() routine exists. The ftime() routine is basically a sub-second accuracy clock. -d_futimes (f_futimes.U): +d_futimes (d_futimes.U): This variable conditionally defines the HAS_FUTIMES symbol, which indicates to the C program that the futimes() routine is available. @@ -1011,15 +1016,15 @@ d_getpgid (d_getpgid.U): indicates to the C program that the getpgid(pid) function is available to get the process group id. +d_getpgrp (d_getpgrp.U): + This variable conditionally defines HAS_GETPGRP if getpgrp() is + available to get the current process group. + d_getpgrp2 (d_getpgrp2.U): This variable conditionally defines the HAS_GETPGRP2 symbol, which indicates to the C program that the getpgrp2() (as in DG/UX) routine is available to get the current process group. -d_getpgrp (d_getpgrp.U): - This variable conditionally defines HAS_GETPGRP if getpgrp() is - available to get the current process group. - d_getppid (d_getppid.U): This variable conditionally defines the HAS_GETPPID symbol, which indicates to the C program that the getppid() routine is available @@ -1151,6 +1156,10 @@ d_ilogbl (d_ilogbl.U): indicates to the C program that the ilogbl() routine is available. If scalbnl is also present we can emulate frexpl. +d_inc_version_list (inc_version_list.U): + This variable conditionally defines PERL_INC_VERSION_LIST. + It is set to undef when PERL_INC_VERSION_LIST is empty. + d_index (d_strchr.U): This variable conditionally defines HAS_INDEX if index() and rindex() are available for string searching. @@ -1198,6 +1207,11 @@ d_ldbl_dig (d_ldbl_dig.U): header files provide LDBL_DIG, which is the number of significant digits in a long double precision number. +d_libm_lib_version (d_libm_lib_version.U): + This variable conditionally defines the LIBM_LIB_VERSION symbol, + which indicates to the C program that math.h defines _LIB_VERSION + being available in libm + d_link (d_link.U): This variable conditionally defines HAS_LINK if link() is available to create hard links. @@ -1237,12 +1251,12 @@ d_madvise (d_madvise.U): This variable conditionally defines HAS_MADVISE if madvise() is available to map a file into memory. -d_malloc_size (d_malloc_size.U): - This symbol, if defined, indicates that the malloc_size +d_malloc_good_size (d_malloc_size.U): + This symbol, if defined, indicates that the malloc_good_size routine is available for use. -d_malloc_good_size (d_malloc_good_size.U): - This symbol, if defined, indicates that the malloc_good_size +d_malloc_size (d_malloc_size.U): + This symbol, if defined, indicates that the malloc_size routine is available for use. d_mblen (d_mblen.U): @@ -1596,15 +1610,15 @@ d_random_r (d_random_r.U): which indicates to the C program that the random_r() routine is available. +d_readdir (d_readdir.U): + This variable conditionally defines HAS_READDIR if readdir() is + available to read directory entries. + d_readdir64_r (d_readdir64_r.U): This variable conditionally defines the HAS_READDIR64_R symbol, which indicates to the C program that the readdir64_r() routine is available. -d_readdir (d_readdir.U): - This variable conditionally defines HAS_READDIR if readdir() is - available to read directory entries. - d_readdir_r (d_readdir_r.U): This variable conditionally defines the HAS_READDIR_R symbol, which indicates to the C program that the readdir_r() @@ -1783,15 +1797,15 @@ d_setpgid (d_setpgid.U): This variable conditionally defines the HAS_SETPGID symbol if the setpgid(pid, gpid) function is available to set process group ID. +d_setpgrp (d_setpgrp.U): + This variable conditionally defines HAS_SETPGRP if setpgrp() is + available to set the current process group. + d_setpgrp2 (d_setpgrp2.U): This variable conditionally defines the HAS_SETPGRP2 symbol, which indicates to the C program that the setpgrp2() (as in DG/UX) routine is available to set the current process group. -d_setpgrp (d_setpgrp.U): - This variable conditionally defines HAS_SETPGRP if setpgrp() is - available to set the current process group. - d_setprior (d_setprior.U): This variable conditionally defines HAS_SETPRIORITY if setpriority() is available to set a process's priority. @@ -1907,6 +1921,16 @@ d_sigsetjmp (d_sigsetjmp.U): which indicates that the sigsetjmp() routine is available to call setjmp() and optionally save the process's signal mask. +d_sitearch (sitearch.U): + This variable conditionally defines SITEARCH to hold the pathname + of architecture-dependent library files for $package. If + $sitearch is the same as $archlib, then this is set to undef. + +d_snprintf (d_snprintf.U): + This variable conditionally defines the HAS_SNPRINTF symbol, which + indicates to the C program that the snprintf () library function + is available. + d_sockatmark (d_sockatmark.U): This variable conditionally defines the HAS_SOCKATMARK symbol, which indicates to the C program that the sockatmark() routine is available. @@ -1932,7 +1956,7 @@ d_socks5_init (d_socks5_init.U): This variable conditionally defines the HAS_SOCKS5_INIT symbol, which indicates to the C program that the socks5_init() routine is available. -d_sprintf_returns_strlen (d_sprintf_returns_strlen.U): +d_sprintf_returns_strlen (d_sprintf_len.U): This variable defines whether sprintf returns the length of the string (as per the ANSI spec). Some C libraries retain compatibility with pre-ANSI C and return a pointer to the passed in buffer; for these @@ -2270,6 +2294,11 @@ d_vprintf (d_vprintf.U): indicates to the C program that the vprintf() routine is available to printf with a pointer to an argument list. +d_vsnprintf (d_snprintf.U): + This variable conditionally defines the HAS_VSNPRINTF symbol, which + indicates to the C program that the vsnprintf () library function + is available. + d_wait4 (d_wait4.U): This variable conditionally defines the HAS_WAIT4 symbol, which indicates the wait4() routine is available. @@ -3132,6 +3161,11 @@ inc_version_list (inc_version_list.U): site_perl directory was introduced in 5.005, so that is the lowest possible value. + This list includes architecture-dependent directories back to + version $api_versionstring (e.g. 5.5.640) and + architecture-independent directories all the way back to + 5.005. + inc_version_list_init (inc_version_list.U): This variable holds the same list as inc_version_list, but each item is enclosed in double quotes and separated by commas, @@ -3146,6 +3180,14 @@ inews (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. +initialinstalllocation (bin.U): + When userelocatableinc is true, this variable holds the location + that make install should copy the perl binary to, with all the + run-time relocatable paths calculated from this at install time. + When used, it is initialised to the original value of binexp, and + then binexp is set to '.../', as the other binaries are found + relative to the perl binary. + installarchlib (archlib.U): This variable is really the same as archlibexp but may differ on those systems using AFS. For extra portability, only this variable @@ -3511,6 +3553,18 @@ mad (mad.U): This variable indicates that the Misc Attribute Definition code is to be compiled. +madlyh (mad.U): + If the Misc Attribute Decoration is to be compiled, this variable is + set to the name of the extra header files to be used, else it is '' + +madlyobj (mad.U): + If the Misc Attribute Decoration is to be compiled, this variable is + set to the name of the extra object files to be used, else it is '' + +madlysrc (mad.U): + If the Misc Attribute Decoration is to be compiled, this variable is + set to the name of the extra C source files to be used, else it is '' + mail (Loc.U): This variable is defined but not used by Configure. The value is a plain '' and is not useful. @@ -3820,14 +3874,44 @@ path_sep (Unix.U): This is an old synonym for p_ in Head.U, the character used to separate elements in the command shell search PATH. +perl (Loc.U): + This variable is defined but not used by Configure. + The value is a plain '' and is not useful. + 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. +PERL_API_REVISION (patchlevel.h): + This number describes the earliest compatible PERL_REVISION of + Perl ("compatibility" here being defined as sufficient binary/API + compatibility to run XS code built with the older version). + Normally this does not change across maintenance releases. + Please read the comment in patchlevel.h. + +PERL_API_SUBVERSION (patchlevel.h): + This number describes the earliest compatible PERL_SUBVERSION of + Perl ("compatibility" here being defined as sufficient binary/API + compatibility to run XS code built with the older version). + Normally this does not change across maintenance releases. + Please read the comment in patchlevel.h. + +PERL_API_VERSION (patchlevel.h): + This number describes the earliest compatible PERL_VERSION of + Perl ("compatibility" here being defined as sufficient binary/API + compatibility to run XS code built with the older version). + Normally this does not change across maintenance releases. + Please read the comment in patchlevel.h. + +PERL_CONFIG_SH (Oldsyms.U): + This is set to 'true' in config.sh so that a shell script + sourcing config.sh can tell if it has been sourced already. + +PERL_PATCHLEVEL (Oldsyms.U): + This symbol reflects the patchlevel, if available. Will usually + come from the .patch file, which is available when the perl + source tree was fetched with rsync. perl_patchlevel (patchlevel.U): This is the Perl patch level, a numeric change identifier, @@ -4737,7 +4821,7 @@ usereentrant (usethreads.U): meaningful if usethreads is set and is very experimental, it is not even prompted for. -userelocatableinc (XXX.U): +userelocatableinc (bin.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 @@ -4755,6 +4839,11 @@ useshrplib (libperl.U): This variable is set to 'true' if the user wishes to build a shared libperl, and 'false' otherwise. +usesitecustomize (d_sitecustomize.U): + This variable is set to true when the user requires a mechanism that + allows the sysadmin to add entries to @INC at runtime. This variable + being set, makes perl run '$sitelib/sitecustomize.pl' at startup. + usesocks (usesocks.U): This variable conditionally defines the USE_SOCKS symbol, and indicates that Perl should be built to use SOCKS.