diff options
Diffstat (limited to 'Master/tlpkg/tlperl/lib/Config.pod')
| -rw-r--r-- | Master/tlpkg/tlperl/lib/Config.pod | 141 |
1 files changed, 111 insertions, 30 deletions
diff --git a/Master/tlpkg/tlperl/lib/Config.pod b/Master/tlpkg/tlperl/lib/Config.pod index baca2658073..c4bcd0f14f0 100644 --- a/Master/tlpkg/tlperl/lib/Config.pod +++ b/Master/tlpkg/tlperl/lib/Config.pod @@ -63,6 +63,33 @@ printed on a separate line in the form: Names which are unknown are output as C<name='UNKNOWN';>. See also C<-V:name> in L<perlrun/Switches>. +=item bincompat_options() + +Returns a list of C pre-processor options used when compiling this F<perl> +binary, which affect its binary compatibility with extensions. +C<bincompat_options()> and C<non_bincompat_options()> are shown together in +the output of C<perl -V> as I<Compile-time options>. + +=item non_bincompat_options() + +Returns a list of C pre-processor options used when compiling this F<perl> +binary, which do not affect binary compatibility with extensions. + +=item compile_date() + +Returns the compile date (as a string), equivalent to what is shown by +C<perl -V> + +=item local_patches() + +Returns a list of the names of locally applied patches, equivalent to what +is shown by C<perl -V>. + +=item header_files() + +Returns a list of the header files that should be used as dependencies for +XS code, for this version of Perl on this platform. + =back =head1 EXAMPLE @@ -592,7 +619,7 @@ command, as reported by the shell in the $0 variable. From F<Options.U>: -This variable countains the number of command-line arguments +This variable contains the number of command-line arguments passed to Configure, as reported by the shell in the $# variable. The individual arguments are stored as variables config_argc1, config_argc2, etc. @@ -982,7 +1009,7 @@ whether the C compiler can cast large floats to 32-bit ints. From F<d_castneg.U>: This variable conditionally defines C<CASTNEG>, which indicates -wether the C compiler can cast negative float to unsigned. +whether the C compiler can cast negative float to unsigned. =item C<d_charvspr> @@ -1347,7 +1374,7 @@ when reading from a non-blocking I/O source. From F<Guess.U>: This variable conditionally defines the symbols C<EUNICE> and C<VAX>, which -alerts the C program that it must deal with ideosyncracies of C<VMS>. +alerts the C program that it must deal with idiosyncrasies of C<VMS>. =item C<d_faststdio> @@ -1653,7 +1680,7 @@ to get the current working directory. From F<d_getespwnam.U>: This variable conditionally defines C<HAS_GETESPWNAM> if getespwnam() is -available to retrieve enchanced (shadow) password entries by name. +available to retrieve enhanced (shadow) password entries by name. =item C<d_getfsstat> @@ -2402,7 +2429,7 @@ From F<d_memmove.U>: This variable conditionally defines the C<HAS_MEMMOVE> symbol, which indicates to the C program that the memmove() routine is available -to copy potentatially overlapping blocks of memory. +to copy potentially overlapping blocks of memory. =item C<d_memset> @@ -2755,26 +2782,41 @@ This variable conditionally defines the C<PORTABLE> symbol, which indicates to the C program that it should not assume that it is running on the machine it was compiled on. +=item C<d_prctl> + +From F<d_prctl.U>: + +This variable conditionally defines the C<HAS_PRCTL> symbol, which +indicates to the C program that the prctl() routine is available. + +=item C<d_prctl_set_name> + +From F<d_prctl.U>: + +This variable conditionally defines the C<HAS_PRCTL_SET_NAME> symbol, +which indicates to the C program that the prctl() routine supports +the C<PR_SET_NAME> option. + =item C<d_PRId64> From F<quadfio.U>: This variable conditionally defines the PERL_PRId64 symbol, which -indiciates that stdio has a symbol to print 64-bit decimal numbers. +indicates that stdio has a symbol to print 64-bit decimal numbers. =item C<d_PRIeldbl> From F<longdblfio.U>: This variable conditionally defines the PERL_PRIfldbl symbol, which -indiciates that stdio has a symbol to print long doubles. +indicates that stdio has a symbol to print long doubles. =item C<d_PRIEUldbl> From F<longdblfio.U>: This variable conditionally defines the PERL_PRIfldbl symbol, which -indiciates that stdio has a symbol to print long doubles. +indicates that stdio has a symbol to print long doubles. The C<U> in the name is to separate this from d_PRIeldbl so that even case-blind systems can see the difference. @@ -2783,14 +2825,14 @@ case-blind systems can see the difference. From F<longdblfio.U>: This variable conditionally defines the PERL_PRIfldbl symbol, which -indiciates that stdio has a symbol to print long doubles. +indicates that stdio has a symbol to print long doubles. =item C<d_PRIFUldbl> From F<longdblfio.U>: This variable conditionally defines the PERL_PRIfldbl symbol, which -indiciates that stdio has a symbol to print long doubles. +indicates that stdio has a symbol to print long doubles. The C<U> in the name is to separate this from d_PRIfldbl so that even case-blind systems can see the difference. @@ -2799,14 +2841,14 @@ case-blind systems can see the difference. From F<longdblfio.U>: This variable conditionally defines the PERL_PRIfldbl symbol, which -indiciates that stdio has a symbol to print long doubles. +indicates that stdio has a symbol to print long doubles. =item C<d_PRIGUldbl> From F<longdblfio.U>: This variable conditionally defines the PERL_PRIfldbl symbol, which -indiciates that stdio has a symbol to print long doubles. +indicates that stdio has a symbol to print long doubles. The C<U> in the name is to separate this from d_PRIgldbl so that even case-blind systems can see the difference. @@ -2815,7 +2857,7 @@ case-blind systems can see the difference. From F<quadfio.U>: This variable conditionally defines the PERL_PRIi64 symbol, which -indiciates that stdio has a symbol to print 64-bit decimal numbers. +indicates that stdio has a symbol to print 64-bit decimal numbers. =item C<d_printf_format_null> @@ -2829,14 +2871,14 @@ indicates the C compiler allows printf-like formats to be null. From F<quadfio.U>: This variable conditionally defines the PERL_PRIo64 symbol, which -indiciates that stdio has a symbol to print 64-bit octal numbers. +indicates that stdio has a symbol to print 64-bit octal numbers. =item C<d_PRIu64> From F<quadfio.U>: This variable conditionally defines the PERL_PRIu64 symbol, which -indiciates that stdio has a symbol to print 64-bit unsigned decimal +indicates that stdio has a symbol to print 64-bit unsigned decimal numbers. =item C<d_PRIx64> @@ -2844,14 +2886,14 @@ numbers. From F<quadfio.U>: This variable conditionally defines the PERL_PRIx64 symbol, which -indiciates that stdio has a symbol to print 64-bit hexadecimal numbers. +indicates that stdio has a symbol to print 64-bit hexadecimal numbers. =item C<d_PRIXU64> From F<quadfio.U>: This variable conditionally defines the PERL_PRIXU64 symbol, which -indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers. +indicates that stdio has a symbol to print 64-bit hExADECimAl numbers. The C<U> in the name is to separate this from d_PRIx64 so that even case-blind systems can see the difference. @@ -3100,7 +3142,7 @@ not enough because it may be an enum, glibc has been known to do this. From F<longdblfio.U>: This variable conditionally defines the PERL_PRIfldbl symbol, which -indiciates that stdio has a symbol to scan long doubles. +indicates that stdio has a symbol to scan long doubles. =item C<d_seekdir> @@ -3494,6 +3536,14 @@ This variable conditionally defines the C<HAS_SIGSETJMP> symbol, which indicates that the sigsetjmp() routine is available to call setjmp() and optionally save the process's signal mask. +=item C<d_sin6_scope_id> + +From F<d_socket.U>: + +This variable conditionally defines the HAS_SIN6_SCOPE_ID symbol, which +indicates that a struct sockaddr_in6 structure has the sin6_scope_id +member. + =item C<d_sitearch> From F<sitearch.U>: @@ -3510,6 +3560,14 @@ This variable conditionally defines the C<HAS_SNPRINTF> symbol, which indicates to the C program that the snprintf () library function is available. +=item C<d_sockaddr_sa_len> + +From F<d_socket.U>: + +This variable conditionally defines the C<HAS_SOCKADDR_SA_LEN> symbol, +which indicates that a struct sockaddr structure has the sa_len +member. + =item C<d_sockatmark> From F<d_sockatmark.U>: @@ -3627,6 +3685,15 @@ From F<d_statfs_s.U>: This variable conditionally defines the C<HAS_STRUCT_STATFS> symbol, which indicates that the struct statfs is supported. +=item C<d_static_inline> + +From F<d_static_inline.U>: + +This variable conditionally defines the C<HAS_STATIC_INLINE> symbol, +which indicates that the C compiler supports C99-style static +inline. That is, the function can't be called from another +translation unit. + =item C<d_statvfs> From F<d_statvfs.U>: @@ -3916,7 +3983,7 @@ up to the program to supply one. From F<d_time.U>: This variable conditionally defines the C<HAS_TIME> symbol, which indicates -that the time() routine exists. The time() routine is normaly +that the time() routine exists. The time() routine is normally provided on C<UNIX> systems. =item C<d_timegm> @@ -3931,7 +3998,7 @@ indicates to the C program that the timegm () routine is available. From F<d_times.U>: This variable conditionally defines the C<HAS_TIMES> symbol, which indicates -that the times() routine exists. The times() routine is normaly +that the times() routine exists. The times() routine is normally provided on C<UNIX> systems. You may have to include <sys/times.h>. =item C<d_tm_tm_gmtoff> @@ -4105,7 +4172,7 @@ From F<i_sysioctl.U>: This variable conditionally defines C<USE_IOCNOTTY> to indicate that the ioctl() call with C<TIOCNOTTY> should be used to void tty association. Otherwise (on C<USG> probably), it is enough to close the standard file -decriptors and do a setpgrp(). +descriptors and do a setpgrp(). =item C<d_volatile> @@ -4421,7 +4488,7 @@ From F<Extensions.U>: This variable holds a list of all extension files (both C<XS> and non-xs linked into the package. It is propagated to F<Config.pm> -and is typically used to test whether a particular extesion +and is typically used to test whether a particular extension is available. =item C<extern_C> @@ -5662,7 +5729,7 @@ suitable for use in the C<PERL_INC_VERSION_LIST> initialization. From F<usrinc.U>: -This variable must preceed the normal include path to get hte +This variable must precede the normal include path to get the right one, as in F<$F<incpath/usr/include>> or F<$F<incpath/usr/lib>>. Value can be "" or F</bsd43> on mips. @@ -5697,7 +5764,7 @@ should be used in makefiles. From F<bin.U>: This variable is the same as binexp unless C<AFS> is running in which case -the user is explicitely prompted for it. This variable should always +the user is explicitly prompted for it. This variable should always be used in your makefiles for maximum portability. =item C<installhtml1dir> @@ -6827,8 +6894,9 @@ used to separate elements in the command shell search C<PATH>. From F<Loc.U>: -This variable is defined but not used by Configure. -The value is the empty string and is not useful. +This variable is used internally by Configure to determine the +full pathname (if any) of the perl program. After Configure runs, +the value is reset to a plain C<perl> and is not useful. =item C<perl5> @@ -6911,6 +6979,19 @@ From F<Oldsyms.U>: In a Perl version number such as 5.6.2, this is the 5. This value is manually set in F<patchlevel.h> +=item C<perl_static_inline> + +From F<d_static_inline.U>: + +This variable defines the C<PERL_STATIC_INLINE> symbol to +the best-guess incantation to use for static inline functions. +Possibilities include +static inline (c99) +static __inline__ (gcc -ansi) +static __inline (C<MSVC>) +static _inline (older C<MSVC>) +static (c89 compilers) + =item C<PERL_SUBVERSION> From F<Oldsyms.U>: @@ -7906,7 +7987,7 @@ perl idiom: eval 'exec perl -S $0 ${1+C<$@>}' if $running_under_some_shell; to guarantee perl startup should the shell execute the script. Note -that this magic incatation is not understood by csh. +that this magic incantation is not understood by csh. =item C<startsh> @@ -8373,7 +8454,7 @@ From F<mallocsrc.U>: This variable contains y if the malloc that comes with this package is desired over the system's version of malloc. People often include -special versions of malloc for effiency, but such versions are often +special versions of malloc for efficiency, but such versions are often less portable. See also mallocsrc and mallocobj. If this is C<y>, then -lmalloc is removed from $libs. @@ -8438,7 +8519,7 @@ From F<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 -explicitely requests not to use sfio. It is here primarily so +explicitly requests not to use sfio. It is here primarily so that command-line settings can override the auto-detection of d_sfio without running into a "WHOA THERE". @@ -8484,7 +8565,7 @@ From F<d_vfork.U>: This variable is set to true when the user accepts to use vfork. It is set to false when no vfork is available or when the user -explicitely requests not to use vfork. +explicitly requests not to use vfork. =item C<usrinc> |