Enough changes to Configure and metaunits warrant an update.

[perl5.git] / Porting / Glossary

diff --git a/Porting/Glossary b/Porting/Glossary
index 79da8e1..75a044f 100644 (file)
--- 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.
 
        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.
 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.


@@ -2408,13 +2412,18 @@ full_sed (Loc_sed.U):
        can share this executable will have the same full pathname to
        'sed.'
 
        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):
 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):
        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.
 
        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.
 


@@ -3094,6 +3103,22 @@ installstyle (installstyle.U):
        is useful if $prefix is shared by many packages, e.g. if
        $prefix=/usr/local.
 
        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.
 
        This may later be extended to include other information, so
        be careful with pattern-matching on the results.
 


@@ -4113,7 +4138,7 @@ spackage (package.U):
 
 spitshell (spitshell.U):
        This variable contains the command necessary to spit out a runnable
 
 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.
 
 srand48_r_proto (d_srand48_r.U):
        This variable encodes the prototype of srand48_r.