This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update IO-Compress to CPAN version 2.093
[perl5.git] / Porting / Glossary
index dc37f2a..16acb5e 100644 (file)
@@ -108,13 +108,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
@@ -393,6 +393,10 @@ d__fwalk (d__fwalk.U):
        This variable conditionally defines HAS__FWALK if _fwalk() is
        available to apply a function to all the file handles.
 
+d_accept4 (d_accept4.U):
+       This variable conditionally defines HAS_ACCEPT4 if accept4() is
+       available to accept socket connections.
+
 d_access (d_access.U):
        This variable conditionally defines HAS_ACCESS if the access() system
        call is available to check for access permissions using real IDs.
@@ -580,11 +584,6 @@ d_cmsghdr_s (d_cmsghdr_s.U):
        This variable conditionally defines the HAS_STRUCT_CMSGHDR symbol,
        which indicates that the struct cmsghdr is supported.
 
-d_const (d_const.U):
-       This variable conditionally defines the HASCONST symbol, which
-       indicates to the C program that this C compiler knows about the
-       const type.
-
 d_copysign (d_copysign.U):
        This variable conditionally defines the HAS_COPYSIGN symbol, which
        indicates to the C program that the copysign() routine is available.
@@ -642,14 +641,14 @@ d_dbminitproto (d_dbminitproto.U):
        a prototype for the dbminit() function.  Otherwise, it is
        up to the program to supply one.
 
-d_difftime64 (d_timefuncs64.U):
-       This variable conditionally defines the HAS_DIFFTIME64 symbol, which
-       indicates to the C program that the difftime64 () routine is available.
-
 d_difftime (d_difftime.U):
        This variable conditionally defines the HAS_DIFFTIME symbol, which
        indicates to the C program that the difftime() routine is available.
 
+d_difftime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_DIFFTIME64 symbol, which
+       indicates to the C program that the difftime64 () routine is available.
+
 d_dir_dd_fd (d_dir_dd_fd.U):
        This variable conditionally defines the HAS_DIR_DD_FD symbol, which
        indicates that the DIR directory stream type contains a member
@@ -735,6 +734,10 @@ d_dup2 (d_dup2.U):
        This variable conditionally defines HAS_DUP2 if dup2() is
        available to duplicate file descriptors.
 
+d_dup3 (d_dup3.U):
+       This variable conditionally defines HAS_DUP3 if dup3() is
+       available to duplicate file descriptors.
+
 d_duplocale (d_newlocale.U):
        This variable conditionally defines the HAS_DUPLOCALE symbol, which
        indicates to the C program that the duplocale() routine is available
@@ -1225,15 +1228,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
@@ -1355,6 +1358,10 @@ d_grpasswd (i_grp.U):
        This variable conditionally defines GRPASSWD, which indicates
        that struct group in <grp.h> contains gr_passwd.
 
+d_has_C_UTF8 (d_setlocale.U):
+       This variable is set to either "true" or "false" depending on
+       whether the compilation system supports the C.UTF-8 locale.
+
 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
@@ -1707,6 +1714,11 @@ d_mkfifo (d_mkfifo.U):
        This variable conditionally defines the HAS_MKFIFO symbol, which
        indicates to the C program that the mkfifo() routine is available.
 
+d_mkostemp (d_mkostemp.U):
+       This variable conditionally defines HAS_MKOSTEMP if mkostemp() is
+       available to exclusively create and open a uniquely named (with a
+       suffix) temporary file.
+
 d_mkstemp (d_mkstemp.U):
        This variable conditionally defines the HAS_MKSTEMP symbol, which
        indicates to the C program that the mkstemp() routine is available
@@ -1718,14 +1730,14 @@ d_mkstemps (d_mkstemps.U):
        to exclusively create and open a uniquely named (with a suffix)
        temporary file.
 
-d_mktime64 (d_timefuncs64.U):
-       This variable conditionally defines the HAS_MKTIME64 symbol, which
-       indicates to the C program that the mktime64 () routine is available.
-
 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_mktime64 (d_timefuncs64.U):
+       This variable conditionally defines the HAS_MKTIME64 symbol, which
+       indicates to the C program that the mktime64 () routine is available.
+
 d_mmap (d_mmap.U):
        This variable conditionally defines HAS_MMAP if mmap() is
        available to map a file into memory.
@@ -1919,6 +1931,11 @@ d_pipe (d_pipe.U):
        indicates to the C program that the pipe() routine is available
        to create an inter-process channel.
 
+d_pipe2 (d_pipe2.U):
+       This variable conditionally defines the HAS_PIPE2 symbol, which
+       indicates to the C program that the pipe2() routine is available
+       to create an inter-process channel.
+
 d_poll (d_poll.U):
        This variable conditionally defines the HAS_POLL symbol, which
        indicates to the C program that the poll() routine is available
@@ -2083,15 +2100,15 @@ d_re_comp (d_regcmp.U):
        for regular patern matching (usally on BSD). If so, it is likely that
        re_exec() exists.
 
+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()
@@ -2267,6 +2284,10 @@ d_setlocale (d_setlocale.U):
        This variable conditionally defines HAS_SETLOCALE if setlocale() is
        available to handle locale-specific ctype implementations.
 
+d_setlocale_accepts_any_locale_name (d_setlocale.U):
+       This variable conditionally defines SETLOCALE_ACCEPTS_ANY_LOCALE_NAME
+       if setlocale() accepts any locale name.
+
 d_setlocale_r (d_setlocale_r.U):
        This variable conditionally defines the HAS_SETLOCALE_R symbol,
        which indicates to the C program that the setlocale_r()
@@ -2289,15 +2310,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.
@@ -2456,6 +2477,11 @@ d_sitearch (sitearch.U):
        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_sockaddr_in6 (d_socket.U):
        This variable conditionally defines the HAS_SOCKADDR_IN6 symbol, which
        indicates the availability of a struct sockaddr_in6.
@@ -2612,6 +2638,10 @@ d_strtod (d_strtod.U):
        indicates to the C program that the strtod() routine is available
        to provide better numeric string conversion than atof().
 
+d_strtod_l (d_strtod_l.U):
+       This variable conditionally defines the HAS_STRTOD_L symbol, which
+       indicates to the C program that the strtod_l() routine is available.
+
 d_strtol (d_strtol.U):
        This variable conditionally defines the HAS_STRTOL symbol, which
        indicates to the C program that the strtol() routine is available
@@ -2743,6 +2773,14 @@ d_tmpnam_r (d_tmpnam_r.U):
        which indicates to the C program that the tmpnam_r()
        routine is available.
 
+d_towlower (d_towlower.U):
+       This variable conditionally defines the HAS_TOWLOWER symbol, which
+       indicates to the C program that the towlower() routine is available.
+
+d_towupper (d_towupper.U):
+       This variable conditionally defines the HAS_TOWUPPER symbol, which
+       indicates to the C program that the towupper() routine is available.
+
 d_trunc (d_trunc.U):
        This variable conditionally defines the HAS_TRUNC symbol, which
        indicates to the C program that the trunc() routine is available
@@ -2851,6 +2889,11 @@ d_voidtty (i_sysioctl.U):
        Otherwise (on USG probably), it is enough to close the standard file
        descriptors and do a setpgrp().
 
+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.
@@ -3644,8 +3687,8 @@ i_syslog (i_syslog.U):
        and indicates whether a C program should include <syslog.h>.
 
 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>.
+       This variable conditionally defines the I_SYS_MMAN symbol,
+       and indicates whether a C program should include <sys/mman.h>.
 
 i_sysmode (i_sysmode.U):
        This variable conditionally defines the I_SYSMODE symbol,
@@ -3769,6 +3812,10 @@ i_wchar (i_wchar.U):
        This variable conditionally defines the I_WCHAR symbol,
        that indicates whether a C program may include <wchar.h>.
 
+i_wctype (i_wctype.U):
+       This variable conditionally defines the I_WCTYPE symbol,
+       that indicates whether a C program may include <wctype.h>.
+
 i_xlocale (d_newlocale.U):
        This symbol, if defined, indicates to the C program that it should
        include <xlocale.h> to get uselocale() and its friends
@@ -4245,7 +4292,7 @@ make_set_make (make.U):
        make_set_make="MAKE=$make"      # if it doesn't.
 
        This uses 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):
@@ -4357,7 +4404,7 @@ myuname (Oldconfig.U):
        removed.
 
 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".
 
@@ -4537,16 +4584,16 @@ 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.
 
-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 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 "perl" 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_API_REVISION (patchlevel.h):
        This number describes the earliest compatible PERL_REVISION of
        Perl ("compatibility" here being defined as sufficient binary/API
@@ -4572,6 +4619,11 @@ 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,
        as defined by whichever source code maintenance system
@@ -4580,11 +4632,6 @@ perl_patchlevel (patchlevel.U):
        the maintenance versus development dichotomy except
        by also being increasing.
 
-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_REVISION (Oldsyms.U):
        In a Perl version number such as 5.6.2, this is the 5.
        This value is manually set in patchlevel.h
@@ -4861,9 +4908,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.
@@ -4893,6 +4940,7 @@ shrpenv (libperl.U):
        or
        shrpenv=''
        See the main perl Makefile.SH for actual working usage.
+
        Alternatively, we might be able to use a command line option such
        as -R $archlibexp/CORE (Solaris) or -Wl,-rpath
        $archlibexp/CORE (Linux).
@@ -5122,7 +5170,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.
 
 sPRId64 (quadfio.U):
        This variable, if defined, contains the string used by stdio to
@@ -5509,6 +5557,12 @@ usekernprocpathname (usekernprocpathname.U):
        KERN_PROC_PATHNAME to get a full path for the executable, and hence
        convert $^X to an absolute path.
 
+uselanginfo (Extensions.U):
+       This variable holds either 'true' or 'false' to indicate
+       whether the I18N::Langinfo extension should be used.  The sole
+       use for this currently is to allow an easy mechanism for users to skip
+       this extension from the Configure command line.
+
 uselargefiles (uselfs.U):
        This variable conditionally defines the USE_LARGE_FILES symbol,
        and indicates that large file interfaces should be used when