Glossary now mostly fixed.
Jarkko Hietaniemi [Sat, 20 Feb 1999 13:55:41 +0000 (13:55 +0000)]
p4raw-id: //depot/cfgperl@2996

Configure
Porting/Glossary
Porting/config.sh
Porting/config_H
config_h.SH

index 8c5b835..745c9cc 100755 (executable)
--- a/Configure
+++ b/Configure
@@ -20,7 +20,7 @@
 
 # $Id: Head.U,v 3.0.1.9 1997/02/28 15:02:09 ram Exp $
 #
-# Generated on Fri Feb 19 22:20:20 EET 1999 [metaconfig 3.0 PL70]
+# Generated on Sat Feb 20 15:44:46 EET 1999 [metaconfig 3.0 PL70]
 # (with additional metaconfig patches by perlbug@perl.com)
 
 cat >/tmp/c1$$ <<EOF
@@ -818,24 +818,6 @@ if test -f /etc/unixtovms.exe; then
 fi
 
 i_whoami=''
-: change the next line if compiling for Xenix/286 on Xenix/386
-xlibpth='/usr/lib/386 /lib/386'
-
-: Possible local library directories to search.
-loclibpth="/usr/local/lib /opt/local/lib /usr/gnu/lib"
-loclibpth="$loclibpth /opt/gnu/lib /usr/GNU/lib /opt/GNU/lib"
-
-: general looking path for locating libraries
-glibpth="/shlib /usr/shlib /lib/pa1.1 /usr/lib/large"
-glibpth="$glibpth /lib /usr/lib $xlibpth"
-glibpth="$glibpth /lib/large /usr/lib/small /lib/small"
-glibpth="$glibpth /usr/ccs/lib /usr/ucblib /usr/local/lib"
-
-: Private path used by Configure to find libraries.  Its value
-: is prepended to libpth. This variable takes care of special
-: machines, like the mips.  Usually, it should be empty.
-plibpth=''
-
 : Possible local include directories to search.
 : Set locincpth to "" in a hint file to defeat local include searches.
 locincpth="/usr/local/include /opt/local/include /usr/gnu/include"
@@ -914,6 +896,24 @@ _exe=''
 : Extra object files, if any, needed on this platform.
 archobjs=''
 groupstype=''
+: change the next line if compiling for Xenix/286 on Xenix/386
+xlibpth='/usr/lib/386 /lib/386'
+
+: Possible local library directories to search.
+loclibpth="/usr/local/lib /opt/local/lib /usr/gnu/lib"
+loclibpth="$loclibpth /opt/gnu/lib /usr/GNU/lib /opt/GNU/lib"
+
+: general looking path for locating libraries
+glibpth="/shlib /usr/shlib /lib/pa1.1 /usr/lib/large"
+glibpth="$glibpth /lib /usr/lib $xlibpth"
+glibpth="$glibpth /lib/large /usr/lib/small /lib/small"
+glibpth="$glibpth /usr/ccs/lib /usr/ucblib /usr/local/lib"
+
+: Private path used by Configure to find libraries.  Its value
+: is prepended to libpth. This variable takes care of special
+: machines, like the mips.  Usually, it should be empty.
+plibpth=''
+
 : default library list
 libswanted=''
 : some systems want to use only the non-versioned libso:s
@@ -4219,7 +4219,7 @@ echo " "
 echo "Checking your choice of C compiler and flags for coherency..." >&4
 $cat > try.c <<'EOF'
 #include <stdio.h>
-main() { printf("Ok\n"); exit(0); }
+int main() { printf("Ok\n"); exit(0); }
 EOF
 set X $cc $optimize $ccflags -o try $ldflags try.c $libs
 shift
@@ -10289,10 +10289,10 @@ case "$alignbytes" in
 struct foobar {
        char foo;
        double bar;
-} try;
+} try_algn;
 int main()
 {
-       printf("%d\n", (char *)&try.bar - (char *)&try.foo);
+       printf("%d\n", (char *)&try_algn.bar - (char *)&try_algn.foo);
 }
 EOCP
        set try
index 86bf253..c1b8758 100644 (file)
@@ -152,6 +152,12 @@ ccflags (ccflags.U):
        This variable contains any additional C compiler flags desired by
        the user.  It is up to the Makefile to use this.
 
+ccsymbols (Cppsym.U):
+       The variable contains the symbols defined by the C compiler alone.
+       The symbols defined by cpp or by cc when it calls cpp are not in
+       this list, see cppsymbols and cppccsymbols.
+       The list is a space-separated list of symbol=value tokens.
+
 cf_by (cf_who.U):
        Login name of the person who ran the Configure script and answered the
        questions. This is used to tag both config.sh and config_h.SH.
@@ -214,6 +220,12 @@ cpp_stuff (cpp_stuff.U):
        This variable contains an identification of the catenation mechanism
        used by the C preprocessor.
 
+cppccsymbols (Cppsym.U):
+       The variable contains the symbols defined by the C compiler when
+       when it calls cpp.  The symbols defined by the cc alone or cpp
+       alone are not in this list, see ccsymbols and cppsymbols.
+       The list is a space-separated list of symbol=value tokens.
+
 cppflags (ccflags.U):
        This variable holds the flags that will be passed to the C pre-
        processor. It is up to the Makefile to use it.
@@ -242,6 +254,12 @@ cppstdin (cppstdin.U):
        It is primarily used by other Configure units that ask about
        preprocessor symbols.
 
+cppsymbols (Cppsym.U):
+       The variable contains the symbols defined by the C preprocessor
+       alone.  The symbols defined by cc or by cc when it calls cpp are
+       not in this list, see ccsymbols and cppccsymbols.
+       The list is a space-separated list of symbol=value tokens.
+
 cryptlib (d_crypt.U):
        This variable holds -lcrypt or the path to a libcrypt.a archive if
        the crypt() function is not defined in the standard C library. It is
@@ -546,6 +564,14 @@ d_fstat64 (io64.U):
        This variable conditionally defines the HAS_FSTAT64 symbol, which
        indicates to the C program that the fstat64() routine is available.
 
+d_fstatfs (d_statfs.U):
+       This variable conditionally defines the HAS_FSTATFS symbol, which
+       indicates to the C program that the fstatfs() routine is available.
+
+d_fstatvfs (d_statvfs.U):
+       This variable conditionally defines the HAS_FSTATVFS symbol, which
+       indicates to the C program that the fstatvfs() routine is available.
+
 d_ftell64 (stdio64.U):
        This variable conditionally defines the HAS_FTELL64 symbol, which
        indicates to the C program that the ftell64() routine is available.
@@ -616,6 +642,11 @@ d_getlogin (d_getlogin.U):
        indicates to the C program that the getlogin() routine is available
        to get the login name.
 
+d_getmntent (d_getmntent.U):
+       This variable conditionally defines the HAS_GETMNTENT symbol, which
+       indicates to the C program that the getmntent() routine is available
+       to iterate through mounted files.
+
 d_getnbyaddr (d_getnbyad.U):
        This variable conditionally defines the HAS_GETNETBYADDR symbol, which
        indicates to the C program that the getnetbyaddr() routine is available
@@ -720,6 +751,11 @@ d_grpasswd (i_grp.U):
        This variable conditionally defines GRPASSWD, which indicates
        that struct group in <grp.h> contains gr_passwd.
 
+d_hasmntopt (d_hasmntopt.U):
+       This variable conditionally defines the HAS_HASMNTOPT symbol, which
+       indicates to the C program that the hasmntopt() routine is available
+       to query the mount options of file systems.
+
 d_htonl (d_htonl.U):
        This variable conditionally defines HAS_HTONL if htonl() and its
        friends are available to do network order byte swapping.
@@ -793,6 +829,10 @@ d_lstat (d_lstat.U):
        This variable conditionally defines HAS_LSTAT if lstat() is
        available to do file stats on symbolic links.
 
+d_madvise (d_madvise.U):
+       This variable conditionally defines HAS_MADVISE if madvise() is
+       available to map a file into memory.
+
 d_mblen (d_mblen.U):
        This variable conditionally defines the HAS_MBLEN symbol, which
        indicates to the C program that the mblen() routine is available
@@ -841,6 +881,14 @@ d_mktime (d_mktime.U):
        This variable conditionally defines the HAS_MKTIME symbol, which
        indicates to the C program that the mktime() routine is available.
 
+d_mmap (d_mmap.U):
+       This variable conditionally defines HAS_MMAP if mmap() is
+       available to map a file into memory.
+
+d_mprotect (d_mprotect.U):
+       This variable conditionally defines HAS_MPROTECT if mprotect() is
+       available to modify the access protection of a memory mapped file.
+
 d_msg (d_msg.U):
        This variable conditionally defines the HAS_MSG symbol, which
        indicates that the entire msg*(2) library is present.
@@ -890,6 +938,14 @@ d_msgsnd (d_msgsnd.U):
        This variable conditionally defines the HAS_MSGSND symbol, which
        indicates to the C program that the msgsnd() routine is available.
 
+d_msync (d_msync.U):
+       This variable conditionally defines HAS_MSYNC if msync() is
+       available to synchronize a mapped file.
+
+d_munmap (d_munmap.U):
+       This variable conditionally defines HAS_MUNMAP if munmap() is
+       available to unmap a region mapped by mmap().
+
 d_mymalloc (mallocsrc.U):
        This variable conditionally defines MYMALLOC in case other parts
        of the source want to take special action if MYMALLOC is used.
@@ -1261,6 +1317,20 @@ d_statblks (d_statblks.U):
        if this system has a stat structure declaring
        st_blksize and st_blocks.
 
+d_statfs (d_statfs.U):
+       This variable conditionally defines the HAS_STATFS symbol, which
+       indicates to the C program that the statfs() routine is available.
+
+d_statfsflags (d_statfs.U):
+       This variable conditionally defines the HAS_STRUCT_STATFS_FLAGS
+       symbol, which indicates to struct statfs from has f_flags member.
+       This kind of struct statfs is coming from sys/mount.h (BSD),
+       not from sys/statfs.h (SYSV).
+
+d_statvfs (d_statvfs.U):
+       This variable conditionally defines the HAS_STATVFS symbol, which
+       indicates to the C program that the statvfs() routine is available.
+
 d_stdio_cnt_lval (d_stdstdio.U):
        This variable conditionally defines STDIO_CNT_LVALUE if the
        FILE_cnt macro can be used as an lvalue.
@@ -1373,6 +1443,12 @@ d_telldir (d_readdir.U):
        This variable conditionally defines HAS_TELLDIR if telldir() is
        available.
 
+d_telldirproto (d_telldirproto.U):
+       This variable conditionally defines the HAS_TELLDIR_PROTO symbol,
+       which indicates to the C program that the system provides
+       a prototype for the telldir() function.  Otherwise, it is
+       up to the program to supply one.
+
 d_time (d_time.U):
        This variable conditionally defines the HAS_TIME symbol, which indicates
        that the time() routine exists.  The time() routine is normaly
@@ -1483,6 +1559,9 @@ db_prefixtype (i_db.U):
        in the <db.h> header file.  In older versions of DB, it was
        int, while in newer ones it is size_t.
 
+defvoidused (voidflags.U):
+       This variable contains the default value of the VOIDUSED symbol (15).
+
 direntrytype (i_dirent.U):
        This symbol is set to 'struct direct' or 'struct dirent' depending on
        whether dirent is available or not. You should use this pseudo type to
@@ -1577,6 +1656,11 @@ freetype (mallocsrc.U):
        This variable contains the return type of free().  It is usually
        void, but occasionally int.
 
+full_ar (Loc_ar.U):
+       This variable contains the full pathname to 'ar', whether or
+       not the user has specified 'portability'.  This is only used
+       in the Makefile.SH.
+
 full_csh (d_csh.U):
        This variable contains the full pathname to 'csh', whether or
        not the user has specified 'portability'.  This is only used
@@ -1601,6 +1685,11 @@ gidtype (gidtype.U):
        ushort, or whatever type is used to declare the return type
        of getgid().  Typically, it is the type of group ids in the kernel.
 
+glibpth (libpth.U):
+       This variable holds the general path (space-separated) used to
+       find libraries.  It may contain directories that do not exist on
+       this platform, libpth is the cleaned-up version.
+
 grep (Loc.U):
        This variable is be used internally by Configure to determine the
        full pathname (if any) of the grep program.  After Configure runs,
@@ -1724,6 +1813,10 @@ i_memory (i_memory.U):
        This variable conditionally defines the I_MEMORY symbol, and indicates
        whether a C program should include <memory.h>.
 
+i_mntent (i_mntent.U):
+       This variable conditionally defines the I_MNTENT symbol, and indicates
+       whether a C program should include <mntent.h>.
+
 i_ndbm (i_ndbm.U):
        This variable conditionally defines the I_NDBM symbol, which
        indicates to the C program that <ndbm.h> exists and should
@@ -1811,6 +1904,14 @@ i_sysioctl (i_sysioctl.U):
        indicates to the C program that <sys/ioctl.h> exists and should
        be included.
 
+i_sysmman (i_sysmman.U):
+       This variable conditionally defines the I_SYS_MMAN symbol, and
+       indicates whether a C program should include <sys/mman.h>.
+
+i_sysmount (i_sysmount.U):
+       This variable conditionally defines the I_SYSMOUNT symbol,
+       and indicates whether a C program should include <sys/mount.h>.
+
 i_sysndir (i_sysndir.U):
        This variable conditionally defines the I_SYS_NDIR symbol, and indicates
        whether a C program should include <sys/ndir.h>.
@@ -1841,6 +1942,10 @@ i_sysstat (i_sysstat.U):
        This variable conditionally defines the I_SYS_STAT symbol,
        and indicates whether a C program should include <sys/stat.h>.
 
+i_sysstatvfs (i_sysstatvfs.U):
+       This variable conditionally defines the I_SYSSTATVFS symbol,
+       and indicates whether a C program should include <sys/statvfs.h>.
+
 i_systime (i_time.U):
        This variable conditionally defines I_SYS_TIME, which indicates
        to the C program that it should include <sys/time.h>.
@@ -1966,6 +2071,11 @@ installsitelib (sitelib.U):
        those systems using AFS. For extra portability, only this variable
        should be used in makefiles.
 
+installusrbinperl (instubperl.U):
+       This variable tells whether Perl should be installed also as
+       /usr/bin/perl in addition to
+       $installbin/perl
+
 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.
@@ -2019,8 +2129,8 @@ libperl (libperl.U):
        library.
 
 libpth (libpth.U):
-       This variable holds the general path used to find libraries. It is
-       intended to be used by other units.
+       This variable holds the general path (space-separated) used to find
+       libraries. It is intended to be used by other units.
 
 libs (libs.U):
        This variable holds the additional libraries we want to use.
@@ -2061,9 +2171,9 @@ locincpth (ccflags.U):
        It's not much, but it parallels the loclibpth stuff in libpth.U.
 
 loclibpth (libpth.U):
-       This variable holds the paths used to find local libraries.  It is
-       prepended to libpth, and is intended to be easily set from the
-       command line.
+       This variable holds the paths (space-separated) used to find local
+       libraries.  It is prepended to libpth, and is intended to be easily
+       set from the command line.
 
 longdblsize (d_longdbl.U):
        This variable contains the value of the LONG_DOUBLESIZE symbol, which
@@ -2123,7 +2233,7 @@ make_set_make (make.U):
        make_set_make='#'               # If your make program handles this for you,
        make_set_make="MAKE=$make"      # if it doesn't.
        I used a comment character so that we can distinguish a
-       'set' value (from a previous config.sh or Configure '-D' option)
+       'set' value (from a previous config.sh or Configure -D option)
        from an uncomputed value.
 
 mallocobj (mallocsrc.U):
@@ -2191,6 +2301,11 @@ mkdir (Loc.U):
        full pathname (if any) of the mkdir program.  After Configure runs,
        the value is reset to a plain "mkdir" and is not useful.
 
+mmaptype (d_mmap.U):
+       This symbol contains the type of pointer returned by mmap()
+       (and simultaneously the type of the first argument).
+       It can be 'void *' or 'caddr_t'.
+
 models (models.U):
        This variable contains the list of memory models supported by this
        system.  Possible component values are none, split, unsplit, small,
@@ -2233,7 +2348,7 @@ myuname (Oldconfig.U):
        whole thing is then lower-cased.
 
 n (n.U):
-       This variable contains the '-n' flag if that is what causes the echo
+       This variable contains the -n flag if that is what causes the echo
        command to suppress newline.  Otherwise it is null.  Correct usage is
        $echo $n "prompt for a question: $c".
 
@@ -2258,6 +2373,11 @@ netdb_net_type (netdbtype.U):
        getnetbyaddr().  Usually, this is int or long.
        This is only useful if you have getnetbyaddr(), naturally.
 
+nm (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the nm program.  After Configure runs,
+       the value is reset to a plain "nm" and is not useful.
+
 nm_opt (usenm.U):
        This variable holds the options that may be necessary for nm.
 
@@ -2493,9 +2613,9 @@ sh (sh.U):
        /bin/sh, though it's possible that some systems will have /bin/ksh,
        /bin/pdksh, /bin/ash, /bin/bash, or even something such as
        D:/bin/sh.exe.
-       This unit comes before Options.U, so you can't set sh with a '-D'
+       This unit comes before Options.U, so you can't set sh with a -D
        option, though you can override this (and startsh)
-       with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
+       with -O -Dsh=/bin/whatever -Dstartsh=whatever
 
 shar (Loc.U):
        This variable is defined but not used by Configure.
@@ -2621,7 +2741,7 @@ 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.
 
 split (models.U):
        This variable contains a flag which will tell the C compiler and loader
@@ -2720,6 +2840,11 @@ tbl (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
 
+tee (Loc.U):
+       This variable is be used internally by Configure to determine the
+       full pathname (if any) of the tee program.  After Configure runs,
+       the value is reset to a plain "tee" and is not useful.
+
 test (Loc.U):
        This variable is be used internally by Configure to determine the
        full pathname (if any) of the test program.  After Configure runs,
@@ -2854,6 +2979,11 @@ voidflags (voidflags.U):
        which indicates how much support of the void type is given by this
        compiler.  See VOIDFLAGS for more info.
 
+xlibpth (libpth.U):
+       This variable holds extra path (space-separated) used to find
+       libraries on this platform, for example CPU-specific libraries
+       (on multi-CPU platforms) may be listed here.
+
 zcat (Loc.U):
        This variable is defined but not used by Configure.
        The value is a plain '' and is not useful.
index d850c56..d1f4393 100644 (file)
@@ -8,7 +8,7 @@
 
 # Package name      : perl5
 # Source directory  : .
-# Configuration time: Fri Feb 19 22:09:06 EET 1999
+# Configuration time: Sat Feb 20 15:45:59 EET 1999
 # Configured by     : jhi
 # Target system     : osf1 alpha.hut.fi v4.0 878 alpha 
 
@@ -55,7 +55,7 @@ ccflags='-pthread -std -DLANGUAGE_C'
 ccsymbols='__LANGUAGE_C__=1 _LONGLONG=1 LANGUAGE_C=1 SYSTYPE_BSD=1'
 cf_by='jhi'
 cf_email='yourname@yourhost.yourplace.com'
-cf_time='Fri Feb 19 22:09:06 EET 1999'
+cf_time='Sat Feb 20 15:45:59 EET 1999'
 chgrp=''
 chmod=''
 chown=''
index 8bfd151..54c7e60 100644 (file)
@@ -17,7 +17,7 @@
 /*
  * Package name      : perl5
  * Source directory  : .
- * Configuration time: Fri Feb 19 22:09:06 EET 1999
+ * Configuration time: Sat Feb 20 15:45:59 EET 1999
  * Configured by     : jhi
  * Target system     : osf1 alpha.hut.fi v4.0 878 alpha 
  */
 
 /* HAS_FSTATFS:
  *     This symbol, if defined, indicates that the fstatfs routine is
- *     available to do stat filesystems of file descriptors.
+ *     available to stat filesystems of file descriptors.
  */
 /* HAS_STRUCT_STATFS_FLAGS:
  *     This symbol, if defined, indicates that the struct statfs
  *     does have the f_flags member containing the mount flags of
  *     the filesystem holding the file.
- *     This kind of struct statfs is coming from sys/mount.h (BSD)
- *     and not from sys/statfs.h (SYSV).
+ *     This kind of struct statfs is coming from sys/mount.h (BSD),
+ *     not from sys/statfs.h (SYSV).
  */
 #define HAS_FSTATFS            /**/
 #define HAS_STRUCT_STATFS_FLAGS                /**/
 
 /* HAS_FSTATVFS:
  *     This symbol, if defined, indicates that the fstatvfs routine is
- *     available to do stat filesystems of file descriptors.
+ *     available to stat filesystems of file descriptors.
  */
 #define HAS_FSTATVFS           /**/
 
index 7047dfa..842b2c6 100644 (file)
@@ -2062,6 +2062,18 @@ sed <<!GROK!THIS! >config.h -e 's!^#undef\(.*/\)\*!/\*#define\1 \*!' -e 's!^#un-
  */
 #$d_ftello HAS_FTELLO          /**/
 
+/* HAS_GETMNTENT:
+ *     This symbol, if defined, indicates that the getmntent routine is
+ *     available to iterate through mounted file systems.
+ */
+#$d_getmntent HAS_GETMNTENT            /**/
+
+/* HAS_HASMNTOPT:
+ *     This symbol, if defined, indicates that the hasmntopt routine is
+ *     available to query the mount options of file systems.
+ */
+#$d_hasmntopt HAS_HASMNTOPT            /**/
+
 /* HAS_MADVISE:
  *     This symbol, if defined, indicates that the madvise system call is
  *     available to map a file into memory.
@@ -2089,21 +2101,21 @@ sed <<!GROK!THIS! >config.h -e 's!^#undef\(.*/\)\*!/\*#define\1 \*!' -e 's!^#un-
 
 /* HAS_FSTATFS:
  *     This symbol, if defined, indicates that the fstatfs routine is
- *     available to do stat filesystems of file descriptors.
+ *     available to stat filesystems of file descriptors.
  */
 /* HAS_STRUCT_STATFS_FLAGS:
  *     This symbol, if defined, indicates that the struct statfs
  *     does have the f_flags member containing the mount flags of
  *     the filesystem holding the file.
- *     This kind of struct statfs is coming from sys/mount.h (BSD)
- *     and not from sys/statfs.h (SYSV).
+ *     This kind of struct statfs is coming from sys/mount.h (BSD),
+ *     not from sys/statfs.h (SYSV).
  */
 #$d_fstatfs HAS_FSTATFS                /**/
 #$d_statfsflags HAS_STRUCT_STATFS_FLAGS                /**/
 
 /* HAS_FSTATVFS:
  *     This symbol, if defined, indicates that the fstatvfs routine is
- *     available to do stat filesystems of file descriptors.
+ *     available to stat filesystems of file descriptors.
  */
 #$d_fstatvfs HAS_FSTATVFS              /**/