X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=Porting%2FGlossary;h=a3d52e689e03011a507744d510259dd5bf94c51c;hb=92a3e63c3aba23d356cf70f5886c704d07f8067d;hp=6ce51f5549a5d24f191e5bfaa91c54c2ca89b626;hpb=44b9449181a08e79439a4e3a78b60d92a3fe84bf;p=p5sagit%2Fp5-mst-13.2.git diff --git a/Porting/Glossary b/Porting/Glossary index 6ce51f5..a3d52e6 100644 --- a/Porting/Glossary +++ b/Porting/Glossary @@ -1399,6 +1399,10 @@ 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. @@ -2143,6 +2147,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. @@ -2408,13 +2415,18 @@ 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. @@ -2616,6 +2628,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. @@ -3032,6 +3065,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 @@ -3076,11 +3119,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. +installsitehtml1 (sitehtml1.U): + This variable is really the same as sitehtml1exp, 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 + 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. +installsiteman1 (siteman1.U): + This variable is really the same as siteman1exp, 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 + 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 @@ -3094,6 +3166,22 @@ installstyle (installstyle.U): is useful if $prefix is shared by many packages, e.g. if $prefix=/usr/local. + 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. @@ -3116,11 +3204,36 @@ 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 + 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 + 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. +installvendorman1 (vendorman1.U): + This variable is really the same as vendorman1exp 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 + 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. @@ -3981,8 +4094,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 @@ -3993,10 +4106,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 @@ -4006,7 +4119,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). @@ -4041,6 +4154,36 @@ 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): + 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. + +sitehtml1exp (sitehtml1.U): + This variable is the same as the sitehtml1 variable, but is filename + expanded at configuration time, for convenient use in makefiles. + +sitehtml3 (sitehtml3.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. + +sitehtml3exp (sitehtml3.U): + This variable is the same as the sitehtml3 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 @@ -4061,6 +4204,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. +siteman1 (siteman1.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. + +siteman1exp (siteman1.U): + This variable is the same as the siteman1 variable, but is filename + expanded at configuration time, for convenient use in makefiles. + +siteman3 (siteman3.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. + +siteman3exp (siteman3.U): + This variable is the same as the siteman3 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. @@ -4070,6 +4243,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. @@ -4113,9 +4301,9 @@ spackage (package.U): 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. - shell on this system. It is either cat or a grep '-v' for # comments. + +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 @@ -4441,8 +4629,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, @@ -4517,6 +4705,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. +vendorhtml1 (vendorhtml1.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. + +vendorhtml1exp (vendorhtml1.U): + This variable is the ~name expanded version of vendorhtml1, so that you + may use it directly in Makefiles or shell scripts. + +vendorhtml3 (vendorhtml3.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. + +vendorhtml3exp (vendorhtml3.U): + This variable is the ~name expanded version of vendorhtml3, 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. @@ -4535,6 +4749,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. +vendorman1 (vendorman1.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. + +vendorman1exp (vendorman1.U): + This variable is the ~name expanded version of vendorman1, so that you + may use it directly in Makefiles or shell scripts. + +vendorman3 (vendorman3.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. + +vendorman3exp (vendorman3.U): + This variable is the ~name expanded version of vendorman3, 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. @@ -4544,6 +4784,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