megalomaniac 64-bit update: most importantly,
[p5sagit/p5-mst-13.2.git] / Porting / Glossary
1 This file contains a description of all the shell variables whose value is
2 determined by the Configure script.  Variables intended for use in C
3 programs (e.g. I_UNISTD) are already described in config_h.SH.  [`configpm'
4 generates pod documentation for Config.pm from this file--please try to keep
5 the formatting regular.]
6
7 _a (Unix.U):
8         This variable defines the extension used for ordinary libraries.
9         For unix, it is '.a'.  The '.' is included.  Other possible
10         values include '.lib'.
11
12 _exe (Unix.U):
13         This variable defines the extension used for executable files.
14         For unix it is empty.  Other possible values include '.exe'.
15
16 _o (Unix.U):
17         This variable defines the extension used for object files.
18         For unix, it is '.o'.  The '.' is included.  Other possible
19         values include '.obj'.
20
21 afs (afs.U):
22         This variable is set to 'true' if AFS (Andrew File System) is used
23         on the system, 'false' otherwise.  It is possible to override this
24         with a hint value or command line option, but you'd better know
25         what you are doing.
26
27 alignbytes (alignbytes.U):
28         This variable holds the number of bytes required to align a
29         double. Usual values are 2, 4 and 8.
30
31 ansi2knr (ansi2knr.U):
32         This variable is set if the user needs to run ansi2knr.  
33         Currently, this is not supported, so we just abort.
34
35 aphostname (d_gethname.U):
36         This variable contains the command which can be used to compute the
37         host name. The command is fully qualified by its absolute path, to make
38         it safe when used by a process with super-user privileges.
39
40 api_revision (patchlevel.U):
41         The three variables, api_revision, api_version, and
42         api_subversion, specify the version of the oldest perl binary
43         compatible with the present perl.  In a full version string
44         such as '5.6.1', api_revision is the '5'.
45         Prior to 5.5.640, the format was a floating point number,
46         like 5.00563.
47                 perl.c:incpush() and lib/lib.pm will automatically search in
48         $sitelib/.. for older directories back to the limit specified
49         by these api_ variables.  This is only useful if you have a
50         perl library directory tree structured like the default one.
51         See INSTALL for how this works.  The versioned site_perl
52         directory was introduced in 5.005, so that is the lowest
53         possible value.  The version list appropriate for the current
54         system is determined in inc_version_list.U.
55                 XXX To do:  Since compatibility can depend on compile time
56         options (such as bincompat, longlong, etc.) it should
57         (perhaps) be set by Configure, but currently it isn't.
58         Currently, we read a hard-wired value from patchlevel.h.
59         Perhaps what we ought to do is take the hard-wired value from
60         patchlevel.h but then modify it if the current Configure
61         options warrant.  patchlevel.h then would use an #ifdef guard.
62
63 api_subversion (patchlevel.U):
64         The three variables, api_revision, api_version, and
65         api_subversion, specify the version of the oldest perl binary
66         compatible with the present perl.  In a full version string
67         such as '5.6.1', api_subversion is the '1'.  See api_revision for
68         full details.
69
70 api_version (patchlevel.U):
71         The three variables, api_revision, api_version, and
72         api_subversion, specify the version of the oldest perl binary
73         compatible with the present perl.  In a full version string
74         such as '5.6.1', api_version is the '6'.  See api_revision for
75         full details.  As a special case, 5.5.0 is rendered in the
76         old-style as 5.005.  (In the 5.005_0x maintenance series,
77         this was the only versioned directory in $sitelib.)
78
79 api_versionstring (patchlevel.U):
80         This variable combines api_revision, api_version, and
81         api_subversion in a format such as 5.6.1 (or 5_6_1) suitable
82         for use as a directory name.  This is filesystem dependent.
83
84 ar (Loc.U):
85         This variable is used internally by Configure to determine the
86         full pathname (if any) of the ar program.  After Configure runs,
87         the value is reset to a plain "ar" and is not useful.
88
89 archlib (archlib.U):
90         This variable holds the name of the directory in which the user wants
91         to put architecture-dependent public library files for $package.
92         It is most often a local directory such as /usr/local/lib.
93         Programs using this variable must be prepared to deal
94         with filename expansion.
95
96 archlibexp (archlib.U):
97         This variable is the same as the archlib variable, but is
98         filename expanded at configuration time, for convenient use.
99
100 archname64 (use64bits.U):
101         This variable is used for the 64-bitness part of $archname.
102
103 archname (archname.U):
104         This variable is a short name to characterize the current
105         architecture.  It is used mainly to construct the default archlib.
106
107 archobjs (Unix.U):
108         This variable defines any additional objects that must be linked
109         in with the program on this architecture.  On unix, it is usually
110         empty.  It is typically used to include emulations of unix calls
111         or other facilities.  For perl on OS/2, for example, this would
112         include os2/os2.obj.
113
114 awk (Loc.U):
115         This variable is used internally by Configure to determine the
116         full pathname (if any) of the awk program.  After Configure runs,
117         the value is reset to a plain "awk" and is not useful.
118
119 baserev (baserev.U):
120         The base revision level of this package, from the .package file.
121
122 bash (Loc.U):
123         This variable is defined but not used by Configure.
124         The value is a plain '' and is not useful.
125
126 bin (bin.U):
127         This variable holds the name of the directory in which the user wants
128         to put publicly executable images for the package in question.  It
129         is most often a local directory such as /usr/local/bin. Programs using
130         this variable must be prepared to deal with ~name substitution.
131
132 bincompat5005 (bincompat5005.U):
133         This variable contains y if Perl 5.006 should be binary-compatible
134         with Perl 5.005.
135
136 binexp (bin.U):
137         This is the same as the bin variable, but is filename expanded at
138         configuration time, for use in your makefiles.
139
140 bison (Loc.U):
141         This variable is defined but not used by Configure.
142         The value is a plain '' and is not useful.
143
144 byacc (Loc.U):
145         This variable is used internally by Configure to determine the
146         full pathname (if any) of the byacc program.  After Configure runs,
147         the value is reset to a plain "byacc" and is not useful.
148
149 byteorder (byteorder.U):
150         This variable holds the byte order. In the following, larger digits
151         indicate more significance.  The variable byteorder is either 4321
152         on a big-endian machine, or 1234 on a little-endian, or 87654321
153         on a Cray ... or 3412 with weird order !
154
155 c (n.U):
156         This variable contains the \c string if that is what causes the echo
157         command to suppress newline.  Otherwise it is null.  Correct usage is
158         $echo $n "prompt for a question: $c".
159
160 castflags (d_castneg.U):
161         This variable contains a flag that precise difficulties the
162         compiler has casting odd floating values to unsigned long:
163         0 = ok
164         1 = couldn't cast < 0
165         2 = couldn't cast >= 0x80000000
166         4 = couldn't cast in argument expression list
167
168 cat (Loc.U):
169         This variable is used internally by Configure to determine the
170         full pathname (if any) of the cat program.  After Configure runs,
171         the value is reset to a plain "cat" and is not useful.
172
173 cc (cc.U):
174         This variable holds the name of a command to execute a C compiler which
175         can resolve multiple global references that happen to have the same
176         name.  Usual values are 'cc', 'Mcc', 'cc -M', and 'gcc'.
177
178 cccdlflags (dlsrc.U):
179         This variable contains any special flags that might need to be
180         passed with 'cc -c' to compile modules to be used to create a shared
181         library that will be used for dynamic loading.  For hpux, this
182         should be +z.  It is up to the makefile to use it.
183
184 ccdlflags (dlsrc.U):
185         This variable contains any special flags that might need to be
186         passed to cc to link with a shared library for dynamic loading.
187         It is up to the makefile to use it.  For sunos 4.1, it should
188         be empty.
189
190 ccflags (ccflags.U):
191         This variable contains any additional C compiler flags desired by
192         the user.  It is up to the Makefile to use this.
193
194 ccsymbols (Cppsym.U):
195         The variable contains the symbols defined by the C compiler alone.
196         The list is a space-separated list of symbol=value tokens.
197
198 cf_by (cf_who.U):
199         Login name of the person who ran the Configure script and answered the
200         questions. This is used to tag both config.sh and config_h.SH.
201
202 cf_email (cf_email.U):
203         Electronic mail address of the person who ran Configure. This can be
204         used by units that require the user's e-mail, like MailList.U.
205
206 cf_time (cf_who.U):
207         Holds the output of the "date" command when the configuration file was
208         produced. This is used to tag both config.sh and config_h.SH.
209
210 charsize (charsize.U):
211         This variable contains the value of the CHARSIZE symbol, which
212         indicates to the C program how many bytes there are in a character.
213
214 chgrp (Loc.U):
215         This variable is defined but not used by Configure.
216         The value is a plain '' and is not useful.
217
218 chmod (Loc.U):
219         This variable is defined but not used by Configure.
220         The value is a plain '' and is not useful.
221
222 chown (Loc.U):
223         This variable is defined but not used by Configure.
224         The value is a plain '' and is not useful.
225
226 clocktype (d_times.U):
227         This variable holds the type returned by times(). It can be long,
228         or clock_t on BSD sites (in which case <sys/types.h> should be
229         included).
230
231 comm (Loc.U):
232         This variable is used internally by Configure to determine the
233         full pathname (if any) of the comm program.  After Configure runs,
234         the value is reset to a plain "comm" and is not useful.
235
236 compress (Loc.U):
237         This variable is defined but not used by Configure.
238         The value is a plain '' and is not useful.
239
240 CONFIGDOTSH (Oldsyms.U):
241         This is set to 'true' in config.sh so that a shell script
242         sourcing config.sh can tell if it has been sourced already.
243
244 contains (contains.U):
245         This variable holds the command to do a grep with a proper return
246         status.  On most sane systems it is simply "grep".  On insane systems
247         it is a grep followed by a cat followed by a test.  This variable
248         is primarily for the use of other Configure units.
249
250 cp (Loc.U):
251         This variable is used internally by Configure to determine the
252         full pathname (if any) of the cp program.  After Configure runs,
253         the value is reset to a plain "cp" and is not useful.
254
255 cpio (Loc.U):
256         This variable is defined but not used by Configure.
257         The value is a plain '' and is not useful.
258
259 cpp (Loc.U):
260         This variable is used internally by Configure to determine the
261         full pathname (if any) of the cpp program.  After Configure runs,
262         the value is reset to a plain "cpp" and is not useful.
263
264 cpp_stuff (cpp_stuff.U):
265         This variable contains an identification of the catenation mechanism
266         used by the C preprocessor.
267
268 cppccsymbols (Cppsym.U):
269         The variable contains the symbols defined by both
270         the bare C compiler and during a compilation that
271         includes stdio.h.
272         The list is a space-separated list of symbol=value tokens.
273
274 cppflags (ccflags.U):
275         This variable holds the flags that will be passed to the C pre-
276         processor. It is up to the Makefile to use it.
277
278 cpplast (cppstdin.U):
279         This variable has the same functionality as cppminus, only it applies
280         to cpprun and not cppstdin.
281
282 cppminus (cppstdin.U):
283         This variable contains the second part of the string which will invoke
284         the C preprocessor on the standard input and produce to standard
285         output.  This variable will have the value "-" if cppstdin needs
286         a minus to specify standard input, otherwise the value is "".
287
288 cpprun (cppstdin.U):
289         This variable contains the command which will invoke a C preprocessor
290         on standard input and put the output to stdout. It is guaranteed not
291         to be a wrapper and may be a null string if no preprocessor can be
292         made directly available. This preprocessor might be different from the
293         one used by the C compiler. Don't forget to append cpplast after the
294         preprocessor options.
295
296 cppstdin (cppstdin.U):
297         This variable contains the command which will invoke the C
298         preprocessor on standard input and put the output to stdout.
299         It is primarily used by other Configure units that ask about
300         preprocessor symbols.
301
302 cppsymbols (Cppsym.U):
303         The variable contains the symbols during a compilation
304         that includes stdio.h.
305         The list is a space-separated list of symbol=value tokens.
306
307 crosscompile (crosscompile.U):
308         This variable conditionally defines the CROSSCOMPILE symbol
309         which signifies that the build process is be a cross-compilation.
310         This is normally set by hints files or from Configure command line.
311
312 cryptlib (d_crypt.U):
313         This variable holds -lcrypt or the path to a libcrypt.a archive if
314         the crypt() function is not defined in the standard C library. It is
315         up to the Makefile to use this.
316
317 csh (Loc.U):
318         This variable is used internally by Configure to determine the
319         full pathname (if any) of the csh program.  After Configure runs,
320         the value is reset to a plain "csh" and is not useful.
321
322 d_access (d_access.U):
323         This variable conditionally defines HAS_ACCESS if the access() system
324         call is available to check for access permissions using real IDs.
325
326 d_accessx (d_accessx.U):
327         This variable conditionally defines the HAS_ACCESSX symbol, which
328         indicates to the C program that the accessx() routine is available.
329
330 d_alarm (d_alarm.U):
331         This variable conditionally defines the HAS_ALARM symbol, which
332         indicates to the C program that the alarm() routine is available.
333
334 d_archlib (archlib.U):
335         This variable conditionally defines ARCHLIB to hold the pathname
336         of architecture-dependent library files for $package.  If
337         $archlib is the same as $privlib, then this is set to undef.
338
339 d_atolf (atolf.U):
340         This variable conditionally defines the HAS_ATOLF symbol, which
341         indicates to the C program that the atolf() routine is available.
342
343 d_atoll (atoll.U):
344         This variable conditionally defines the HAS_ATOLL symbol, which
345         indicates to the C program that the atoll() routine is available.
346
347 d_attribut (d_attribut.U):
348         This variable conditionally defines HASATTRIBUTE, which
349         indicates the C compiler can check for function attributes,
350         such as printf formats.
351
352 d_bcmp (d_bcmp.U):
353         This variable conditionally defines the HAS_BCMP symbol if
354         the bcmp() routine is available to compare strings.
355
356 d_bcopy (d_bcopy.U):
357         This variable conditionally defines the HAS_BCOPY symbol if
358         the bcopy() routine is available to copy strings.
359
360 d_bincompat5005 (bincompat5005.U):
361         This variable conditionally defines BINCOMPAT5005 so that embed.h
362         can take special action if Perl 5.006 should be binary-compatible
363         with Perl 5.005.  This is impossible for builds that use features
364         like threads and multiplicity it is always $undef for those versions.
365
366 d_bsd (Guess.U):
367         This symbol conditionally defines the symbol BSD when running on a
368         BSD system.
369
370 d_bsdgetpgrp (d_getpgrp.U):
371         This variable conditionally defines USE_BSD_GETPGRP if
372         getpgrp needs one arguments whereas USG one needs none.
373
374 d_bsdsetpgrp (d_setpgrp.U):
375         This variable conditionally defines USE_BSD_SETPGRP if
376         setpgrp needs two arguments whereas USG one needs none.
377         See also d_setpgid for a POSIX interface.
378
379 d_bzero (d_bzero.U):
380         This variable conditionally defines the HAS_BZERO symbol if
381         the bzero() routine is available to set memory to 0.
382
383 d_casti32 (d_casti32.U):
384         This variable conditionally defines CASTI32, which indicates
385         whether the C compiler can cast large floats to 32-bit ints.
386
387 d_castneg (d_castneg.U):
388         This variable conditionally defines CASTNEG, which indicates
389         wether the C compiler can cast negative float to unsigned.
390
391 d_charvspr (d_vprintf.U):
392         This variable conditionally defines CHARVSPRINTF if this system
393         has vsprintf returning type (char*).  The trend seems to be to
394         declare it as "int vsprintf()".
395
396 d_chown (d_chown.U):
397         This variable conditionally defines the HAS_CHOWN symbol, which
398         indicates to the C program that the chown() routine is available.
399
400 d_chroot (d_chroot.U):
401         This variable conditionally defines the HAS_CHROOT symbol, which
402         indicates to the C program that the chroot() routine is available.
403
404 d_chsize (d_chsize.U):
405         This variable conditionally defines the CHSIZE symbol, which
406         indicates to the C program that the chsize() routine is available
407         to truncate files.  You might need a -lx to get this routine.
408
409 d_closedir (d_closedir.U):
410         This variable conditionally defines HAS_CLOSEDIR if closedir() is
411         available.
412
413 d_const (d_const.U):
414         This variable conditionally defines the HASCONST symbol, which
415         indicates to the C program that this C compiler knows about the
416         const type.
417
418 d_crypt (d_crypt.U):
419         This variable conditionally defines the CRYPT symbol, which
420         indicates to the C program that the crypt() routine is available
421         to encrypt passwords and the like.
422
423 d_csh (d_csh.U):
424         This variable conditionally defines the CSH symbol, which
425         indicates to the C program that the C-shell exists.
426
427 d_cuserid (d_cuserid.U):
428         This variable conditionally defines the HAS_CUSERID symbol, which
429         indicates to the C program that the cuserid() routine is available
430         to get character login names.
431
432 d_dbl_dig (d_dbl_dig.U):
433         This variable conditionally defines d_dbl_dig if this system's
434         header files provide DBL_DIG, which is the number of significant
435         digits in a double precision number.
436
437 d_difftime (d_difftime.U):
438         This variable conditionally defines the HAS_DIFFTIME symbol, which
439         indicates to the C program that the difftime() routine is available.
440
441 d_dirnamlen (i_dirent.U):
442         This variable conditionally defines DIRNAMLEN, which indicates
443         to the C program that the length of directory entry names is
444         provided by a d_namelen field.
445
446 d_dlerror (d_dlerror.U):
447         This variable conditionally defines the HAS_DLERROR symbol, which
448         indicates to the C program that the dlerror() routine is available.
449
450 d_dlopen (d_dlopen.U):
451         This variable conditionally defines the HAS_DLOPEN symbol, which
452         indicates to the C program that the dlopen() routine is available.
453
454 d_dlsymun (d_dlsymun.U):
455         This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
456         indicates that we need to prepend an underscore to the symbol
457         name before calling dlsym().
458
459 d_dosuid (d_dosuid.U):
460         This variable conditionally defines the symbol DOSUID, which
461         tells the C program that it should insert setuid emulation code
462         on hosts which have setuid #! scripts disabled.
463
464 d_drand48proto (d_drand48proto.U):
465         This variable conditionally defines the HAS_DRAND48_PROTO symbol,
466         which indicates to the C program that the system provides
467         a prototype for the drand48() function.  Otherwise, it is
468         up to the program to supply one.
469
470 d_dup2 (d_dup2.U):
471         This variable conditionally defines HAS_DUP2 if dup2() is
472         available to duplicate file descriptors.
473
474 d_eaccess (d_eaccess.U):
475         This variable conditionally defines the HAS_EACCESS symbol, which
476         indicates to the C program that the eaccess() routine is available.
477
478 d_endgrent (d_endgrent.U):
479         This variable conditionally defines the HAS_ENDGRENT symbol, which
480         indicates to the C program that the endgrent() routine is available
481         for sequential access of the group database.
482
483 d_endhent (d_endhent.U):
484         This variable conditionally defines HAS_ENDHOSTENT if endhostent() is
485         available to close whatever was being used for host queries.
486
487 d_endnent (d_endnent.U):
488         This variable conditionally defines HAS_ENDNETENT if endnetent() is
489         available to close whatever was being used for network queries.
490
491 d_endpent (d_endpent.U):
492         This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is
493         available to close whatever was being used for protocol queries.
494
495 d_endpwent (d_endpwent.U):
496         This variable conditionally defines the HAS_ENDPWENT symbol, which
497         indicates to the C program that the endpwent() routine is available
498         for sequential access of the passwd database.
499
500 d_endsent (d_endsent.U):
501         This variable conditionally defines HAS_ENDSERVENT if endservent() is
502         available to close whatever was being used for service queries.
503
504 d_endspent (d_endspent.U):
505         This variable conditionally defines HAS_ENDSPENT if endspent() is
506         available to finalize the scan of SysV shadow password entries.
507
508 d_eofnblk (nblock_io.U):
509         This variable conditionally defines EOF_NONBLOCK if EOF can be seen
510         when reading from a non-blocking I/O source.
511
512 d_eunice (Guess.U):
513         This variable conditionally defines the symbols EUNICE and VAX, which
514         alerts the C program that it must deal with ideosyncracies of VMS.
515
516 d_fchmod (d_fchmod.U):
517         This variable conditionally defines the HAS_FCHMOD symbol, which
518         indicates to the C program that the fchmod() routine is available
519         to change mode of opened files.
520
521 d_fchown (d_fchown.U):
522         This variable conditionally defines the HAS_FCHOWN symbol, which
523         indicates to the C program that the fchown() routine is available
524         to change ownership of opened files.
525
526 d_fcntl (d_fcntl.U):
527         This variable conditionally defines the HAS_FCNTL symbol, and indicates
528         whether the fcntl() function exists
529
530 d_fd_macros (d_fd_set.U):
531         This variable contains the eventual value of the HAS_FD_MACROS symbol,
532         which indicates if your C compiler knows about the macros which
533         manipulate an fd_set.
534
535 d_fd_set (d_fd_set.U):
536         This variable contains the eventual value of the HAS_FD_SET symbol,
537         which indicates if your C compiler knows about the fd_set typedef.
538
539 d_fds_bits (d_fd_set.U):
540         This variable contains the eventual value of the HAS_FDS_BITS symbol,
541         which indicates if your fd_set typedef contains the fds_bits member.
542         If you have an fd_set typedef, but the dweebs who installed it did
543         a half-fast job and neglected to provide the macros to manipulate
544         an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
545
546 d_fgetpos (d_fgetpos.U):
547         This variable conditionally defines HAS_FGETPOS if fgetpos() is
548         available to get the file position indicator.
549
550 d_flexfnam (d_flexfnam.U):
551         This variable conditionally defines the FLEXFILENAMES symbol, which
552         indicates that the system supports filenames longer than 14 characters.
553
554 d_flock (d_flock.U):
555         This variable conditionally defines HAS_FLOCK if flock() is
556         available to do file locking.
557
558 d_fork (d_fork.U):
559         This variable conditionally defines the HAS_FORK symbol, which
560         indicates to the C program that the fork() routine is available.
561
562 d_fpathconf (d_pathconf.U):
563         This variable conditionally defines the HAS_FPATHCONF symbol, which
564         indicates to the C program that the pathconf() routine is available
565         to determine file-system related limits and options associated
566         with a given open file descriptor.
567
568 d_fpos64_t (io64.U):
569         This symbol will be defined if the C compiler supports fpos64_t.
570
571 d_fs_data_s (d_fs_data_s.U):
572         This variable conditionally defines the HAS_STRUCT_FS_DATA symbol,
573         which indicates that the struct fs_data is supported.
574
575 d_fseeko (d_fseeko.U):
576         This variable conditionally defines the HAS_FSEEKO symbol, which
577         indicates to the C program that the fseeko() routine is available.
578
579 d_fsetpos (d_fsetpos.U):
580         This variable conditionally defines HAS_FSETPOS if fsetpos() is
581         available to set the file position indicator.
582
583 d_fstatfs (d_fstatfs.U):
584         This variable conditionally defines the HAS_FSTATFS symbol, which
585         indicates to the C program that the fstatfs() routine is available.
586
587 d_fstatvfs (d_statvfs.U):
588         This variable conditionally defines the HAS_FSTATVFS symbol, which
589         indicates to the C program that the fstatvfs() routine is available.
590
591 d_ftello (d_ftello.U):
592         This variable conditionally defines the HAS_FTELLO symbol, which
593         indicates to the C program that the ftello() routine is available.
594
595 d_ftime (d_ftime.U):
596         This variable conditionally defines the HAS_FTIME symbol, which indicates
597         that the ftime() routine exists.  The ftime() routine is basically
598         a sub-second accuracy clock.
599
600 d_Gconvert (d_gconvert.U):
601         This variable holds what Gconvert is defined as to convert
602         floating point numbers into strings. It could be 'gconvert'
603         or a more complex macro emulating gconvert with gcvt() or sprintf.
604         Possible values are:
605         d_Gconvert='gconvert((x),(n),(t),(b))'
606         d_Gconvert='gcvt((x),(n),(b))'
607         d_Gconvert='sprintf((b),"%.*g",(n),(x))'
608
609 d_getcwd (d_getcwd.U):
610         This variable conditionally defines the HAS_GETCWD symbol, which
611         indicates to the C program that the getcwd() routine is available
612         to get the current working directory.
613
614 d_getgrent (d_getgrent.U):
615         This variable conditionally defines the HAS_GETGRENT symbol, which
616         indicates to the C program that the getgrent() routine is available
617         for sequential access of the group database.
618
619 d_getgrps (d_getgrps.U):
620         This variable conditionally defines the HAS_GETGROUPS symbol, which
621         indicates to the C program that the getgroups() routine is available
622         to get the list of process groups.
623
624 d_gethbyaddr (d_gethbyad.U):
625         This variable conditionally defines the HAS_GETHOSTBYADDR symbol, which
626         indicates to the C program that the gethostbyaddr() routine is available
627         to look up hosts by their IP addresses.
628
629 d_gethbyname (d_gethbynm.U):
630         This variable conditionally defines the HAS_GETHOSTBYNAME symbol, which
631         indicates to the C program that the gethostbyname() routine is available
632         to look up host names in some data base or other.
633
634 d_gethent (d_gethent.U):
635         This variable conditionally defines HAS_GETHOSTENT if gethostent() is
636         available to look up host names in some data base or another.
637
638 d_gethname (d_gethname.U):
639         This variable conditionally defines the HAS_GETHOSTNAME symbol, which
640         indicates to the C program that the gethostname() routine may be
641         used to derive the host name.
642
643 d_gethostprotos (d_gethostprotos.U):
644         This variable conditionally defines the HAS_GETHOST_PROTOS symbol,
645         which indicates to the C program that <netdb.h> supplies
646         prototypes for the various gethost*() functions.  
647         See also netdbtype.U for probing for various netdb types.
648
649 d_getlogin (d_getlogin.U):
650         This variable conditionally defines the HAS_GETLOGIN symbol, which
651         indicates to the C program that the getlogin() routine is available
652         to get the login name.
653
654 d_getmnt (d_getmnt.U):
655         This variable conditionally defines the HAS_GETMNT symbol, which
656         indicates to the C program that the getmnt() routine is available
657         to retrieve one or more mount info blocks by filename.
658
659 d_getmntent (d_getmntent.U):
660         This variable conditionally defines the HAS_GETMNTENT symbol, which
661         indicates to the C program that the getmntent() routine is available
662         to iterate through mounted files to get their mount info.
663
664 d_getnbyaddr (d_getnbyad.U):
665         This variable conditionally defines the HAS_GETNETBYADDR symbol, which
666         indicates to the C program that the getnetbyaddr() routine is available
667         to look up networks by their IP addresses.
668
669 d_getnbyname (d_getnbynm.U):
670         This variable conditionally defines the HAS_GETNETBYNAME symbol, which
671         indicates to the C program that the getnetbyname() routine is available
672         to look up networks by their names.
673
674 d_getnent (d_getnent.U):
675         This variable conditionally defines HAS_GETNETENT if getnetent() is
676         available to look up network names in some data base or another.
677
678 d_getnetprotos (d_getnetprotos.U):
679         This variable conditionally defines the HAS_GETNET_PROTOS symbol,
680         which indicates to the C program that <netdb.h> supplies
681         prototypes for the various getnet*() functions.  
682         See also netdbtype.U for probing for various netdb types.
683
684 d_getpbyname (d_getprotby.U):
685         This variable conditionally defines the HAS_GETPROTOBYNAME 
686         symbol, which indicates to the C program that the 
687         getprotobyname() routine is available to look up protocols
688         by their name.
689
690 d_getpbynumber (d_getprotby.U):
691         This variable conditionally defines the HAS_GETPROTOBYNUMBER 
692         symbol, which indicates to the C program that the 
693         getprotobynumber() routine is available to look up protocols
694         by their number.
695
696 d_getpent (d_getpent.U):
697         This variable conditionally defines HAS_GETPROTOENT if getprotoent() is
698         available to look up protocols in some data base or another.
699
700 d_getpgid (d_getpgid.U):
701         This variable conditionally defines the HAS_GETPGID symbol, which
702         indicates to the C program that the getpgid(pid) function
703         is available to get the process group id.
704
705 d_getpgrp2 (d_getpgrp2.U):
706         This variable conditionally defines the HAS_GETPGRP2 symbol, which
707         indicates to the C program that the getpgrp2() (as in DG/UX) routine
708         is available to get the current process group.
709
710 d_getpgrp (d_getpgrp.U):
711         This variable conditionally defines HAS_GETPGRP if getpgrp() is
712         available to get the current process group.
713
714 d_getppid (d_getppid.U):
715         This variable conditionally defines the HAS_GETPPID symbol, which
716         indicates to the C program that the getppid() routine is available
717         to get the parent process ID.
718
719 d_getprior (d_getprior.U):
720         This variable conditionally defines HAS_GETPRIORITY if getpriority()
721         is available to get a process's priority.
722
723 d_getprotoprotos (d_getprotoprotos.U):
724         This variable conditionally defines the HAS_GETPROTO_PROTOS symbol,
725         which indicates to the C program that <netdb.h> supplies
726         prototypes for the various getproto*() functions.  
727         See also netdbtype.U for probing for various netdb types.
728
729 d_getpwent (d_getpwent.U):
730         This variable conditionally defines the HAS_GETPWENT symbol, which
731         indicates to the C program that the getpwent() routine is available
732         for sequential access of the passwd database.
733
734 d_getsbyname (d_getsrvby.U):
735         This variable conditionally defines the HAS_GETSERVBYNAME 
736         symbol, which indicates to the C program that the 
737         getservbyname() routine is available to look up services
738         by their name.
739
740 d_getsbyport (d_getsrvby.U):
741         This variable conditionally defines the HAS_GETSERVBYPORT 
742         symbol, which indicates to the C program that the 
743         getservbyport() routine is available to look up services
744         by their port.
745
746 d_getsent (d_getsent.U):
747         This variable conditionally defines HAS_GETSERVENT if getservent() is
748         available to look up network services in some data base or another.
749
750 d_getservprotos (d_getservprotos.U):
751         This variable conditionally defines the HAS_GETSERV_PROTOS symbol,
752         which indicates to the C program that <netdb.h> supplies
753         prototypes for the various getserv*() functions.  
754         See also netdbtype.U for probing for various netdb types.
755
756 d_getspent (d_getspent.U):
757         This variable conditionally defines HAS_GETSPENT if getspent() is
758         available to retrieve SysV shadow password entries sequentially.
759
760 d_getspnam (d_getspnam.U):
761         This variable conditionally defines HAS_GETSPNAM if getspnam() is
762         available to retrieve SysV shadow password entries by name.
763
764 d_gettimeod (d_ftime.U):
765         This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
766         indicates that the gettimeofday() system call exists (to obtain a
767         sub-second accuracy clock). You should probably include <sys/resource.h>.
768
769 d_gnulibc (d_gnulibc.U):
770         Defined if we're dealing with the GNU C Library.
771
772 d_grpasswd (i_grp.U):
773         This variable conditionally defines GRPASSWD, which indicates
774         that struct group in <grp.h> contains gr_passwd.
775
776 d_hasmntopt (d_hasmntopt.U):
777         This variable conditionally defines the HAS_HASMNTOPT symbol, which
778         indicates to the C program that the hasmntopt() routine is available
779         to query the mount options of file systems.
780
781 d_htonl (d_htonl.U):
782         This variable conditionally defines HAS_HTONL if htonl() and its
783         friends are available to do network order byte swapping.
784
785 d_iconv (d_iconv.U):
786         This variable conditionally defines the HAS_ICONV symbol, which
787         indicates to the C program that the iconv() routine is available.
788
789 d_index (d_strchr.U):
790         This variable conditionally defines HAS_INDEX if index() and
791         rindex() are available for string searching.
792
793 d_inetaton (d_inetaton.U):
794         This variable conditionally defines the HAS_INET_ATON symbol, which
795         indicates to the C program that the inet_aton() function is available
796         to parse IP address "dotted-quad" strings.
797
798 d_int64t (d_int64t.U):
799         This symbol will be defined if the C compiler supports int64_t.
800
801 d_isascii (d_isascii.U):
802         This variable conditionally defines the HAS_ISASCII constant,
803         which indicates to the C program that isascii() is available.
804
805 d_killpg (d_killpg.U):
806         This variable conditionally defines the HAS_KILLPG symbol, which
807         indicates to the C program that the killpg() routine is available
808         to kill process groups.
809
810 d_lchown (d_lchown.U):
811         This variable conditionally defines the HAS_LCHOWN symbol, which
812         indicates to the C program that the lchown() routine is available
813         to operate on a symbolic link (instead of following the link).
814
815 d_ldbl_dig (d_ldbl_dig.U):
816         This variable conditionally defines d_ldbl_dig if this system's
817         header files provide LDBL_DIG, which is the number of significant
818         digits in a long double precision number.
819
820 d_link (d_link.U):
821         This variable conditionally defines HAS_LINK if link() is
822         available to create hard links.
823
824 d_locconv (d_locconv.U):
825         This variable conditionally defines HAS_LOCALECONV if localeconv() is
826         available for numeric and monetary formatting conventions.
827
828 d_lockf (d_lockf.U):
829         This variable conditionally defines HAS_LOCKF if lockf() is
830         available to do file locking.
831
832 d_longdbl (d_longdbl.U):
833         This variable conditionally defines HAS_LONG_DOUBLE if 
834         the long double type is supported.
835
836 d_longlong (d_longlong.U):
837         This variable conditionally defines HAS_LONG_LONG if 
838         the long long type is supported.
839
840 d_lstat (d_lstat.U):
841         This variable conditionally defines HAS_LSTAT if lstat() is
842         available to do file stats on symbolic links.
843
844 d_mblen (d_mblen.U):
845         This variable conditionally defines the HAS_MBLEN symbol, which
846         indicates to the C program that the mblen() routine is available
847         to find the number of bytes in a multibye character.
848
849 d_mbstowcs (d_mbstowcs.U):
850         This variable conditionally defines the HAS_MBSTOWCS symbol, which
851         indicates to the C program that the mbstowcs() routine is available
852         to convert a multibyte string into a wide character string.
853
854 d_mbtowc (d_mbtowc.U):
855         This variable conditionally defines the HAS_MBTOWC symbol, which
856         indicates to the C program that the mbtowc() routine is available
857         to convert multibyte to a wide character.
858
859 d_memchr (d_memchr.U):
860         This variable conditionally defines the HAS_MEMCHR symbol, which
861         indicates to the C program that the memchr() routine is available
862         to locate characters within a C string.
863
864 d_memcmp (d_memcmp.U):
865         This variable conditionally defines the HAS_MEMCMP symbol, which
866         indicates to the C program that the memcmp() routine is available
867         to compare blocks of memory.
868
869 d_memcpy (d_memcpy.U):
870         This variable conditionally defines the HAS_MEMCPY symbol, which
871         indicates to the C program that the memcpy() routine is available
872         to copy blocks of memory.
873
874 d_memmove (d_memmove.U):
875         This variable conditionally defines the HAS_MEMMOVE symbol, which
876         indicates to the C program that the memmove() routine is available
877         to copy potentatially overlapping blocks of memory.
878
879 d_memset (d_memset.U):
880         This variable conditionally defines the HAS_MEMSET symbol, which
881         indicates to the C program that the memset() routine is available
882         to set blocks of memory.
883
884 d_mkdir (d_mkdir.U):
885         This variable conditionally defines the HAS_MKDIR symbol, which
886         indicates to the C program that the mkdir() routine is available
887         to create directories..
888
889 d_mkdtemp (d_mkdtemp.U):
890         This variable conditionally defines the HAS_MKDTEMP symbol, which
891         indicates to the C program that the mkdtemp() routine is available
892         to exclusively create a uniquely named temporary directory.
893
894 d_mkfifo (d_mkfifo.U):
895         This variable conditionally defines the HAS_MKFIFO symbol, which
896         indicates to the C program that the mkfifo() routine is available.
897
898 d_mkstemp (d_mkstemp.U):
899         This variable conditionally defines the HAS_MKSTEMP symbol, which
900         indicates to the C program that the mkstemp() routine is available
901         to exclusively create and open a uniquely named temporary file.
902
903 d_mkstemps (d_mkstemps.U):
904         This variable conditionally defines the HAS_MKSTEMPS symbol, which
905         indicates to the C program that the mkstemps() routine is available
906         to exclusively create and open a uniquely named (with a suffix)
907         temporary file.
908
909 d_mktime (d_mktime.U):
910         This variable conditionally defines the HAS_MKTIME symbol, which
911         indicates to the C program that the mktime() routine is available.
912
913 d_mmap (d_mmap.U):
914         This variable conditionally defines HAS_MMAP if mmap() is
915         available to map a file into memory.
916
917 d_mprotect (d_mprotect.U):
918         This variable conditionally defines HAS_MPROTECT if mprotect() is
919         available to modify the access protection of a memory mapped file.
920
921 d_msg (d_msg.U):
922         This variable conditionally defines the HAS_MSG symbol, which
923         indicates that the entire msg*(2) library is present.
924
925 d_msg_ctrunc (d_socket.U):
926         This variable conditionally defines the HAS_MSG_CTRUNC symbol,
927         which indicates that the MSG_CTRUNC is available.  #ifdef is
928         not enough because it may be an enum, glibc has been known to do this.
929
930 d_msg_dontroute (d_socket.U):
931         This variable conditionally defines the HAS_MSG_DONTROUTE symbol,
932         which indicates that the MSG_DONTROUTE is available.  #ifdef is
933         not enough because it may be an enum, glibc has been known to do this.
934
935 d_msg_oob (d_socket.U):
936         This variable conditionally defines the HAS_MSG_OOB symbol,
937         which indicates that the MSG_OOB is available.  #ifdef is
938         not enough because it may be an enum, glibc has been known to do this.
939
940 d_msg_peek (d_socket.U):
941         This variable conditionally defines the HAS_MSG_PEEK symbol,
942         which indicates that the MSG_PEEK is available.  #ifdef is
943         not enough because it may be an enum, glibc has been known to do this.
944
945 d_msg_proxy (d_socket.U):
946         This variable conditionally defines the HAS_MSG_PROXY symbol,
947         which indicates that the MSG_PROXY is available.  #ifdef is
948         not enough because it may be an enum, glibc has been known to do this.
949
950 d_msgctl (d_msgctl.U):
951         This variable conditionally defines the HAS_MSGCTL symbol, which
952         indicates to the C program that the msgctl() routine is available.
953
954 d_msgget (d_msgget.U):
955         This variable conditionally defines the HAS_MSGGET symbol, which
956         indicates to the C program that the msgget() routine is available.
957
958 d_msgrcv (d_msgrcv.U):
959         This variable conditionally defines the HAS_MSGRCV symbol, which
960         indicates to the C program that the msgrcv() routine is available.
961
962 d_msgsnd (d_msgsnd.U):
963         This variable conditionally defines the HAS_MSGSND symbol, which
964         indicates to the C program that the msgsnd() routine is available.
965
966 d_msync (d_msync.U):
967         This variable conditionally defines HAS_MSYNC if msync() is
968         available to synchronize a mapped file.
969
970 d_munmap (d_munmap.U):
971         This variable conditionally defines HAS_MUNMAP if munmap() is
972         available to unmap a region mapped by mmap().
973
974 d_mymalloc (mallocsrc.U):
975         This variable conditionally defines MYMALLOC in case other parts
976         of the source want to take special action if MYMALLOC is used.
977         This may include different sorts of profiling or error detection.
978
979 d_nice (d_nice.U):
980         This variable conditionally defines the HAS_NICE symbol, which
981         indicates to the C program that the nice() routine is available.
982
983 d_nv_preserves_uv (perlxv.U):
984         This variable indicates whether a variable of type nvtype
985         can preserve all the bits a variable of type uvtype.
986
987 d_off64_t (io64.U):
988         This symbol will be defined if the C compiler supports off64_t.
989
990 d_old_pthread_create_joinable (d_pthrattrj.U):
991         This variable conditionally defines pthread_create_joinable.
992         undef if pthread.h defines PTHREAD_CREATE_JOINABLE.
993
994 d_oldpthreads (usethreads.U):
995         This variable conditionally defines the OLD_PTHREADS_API symbol,
996         and indicates that Perl should be built to use the old
997         draft POSIX threads API.  This is only potentially meaningful if
998         usethreads is set.
999
1000 d_oldsock (d_socket.U):
1001         This variable conditionally defines the OLDSOCKET symbol, which
1002         indicates that the BSD socket interface is based on 4.1c and not 4.2.
1003
1004 d_open3 (d_open3.U):
1005         This variable conditionally defines the HAS_OPEN3 manifest constant,
1006         which indicates to the C program that the 3 argument version of
1007         the open(2) function is available.
1008
1009 d_pathconf (d_pathconf.U):
1010         This variable conditionally defines the HAS_PATHCONF symbol, which
1011         indicates to the C program that the pathconf() routine is available
1012         to determine file-system related limits and options associated
1013         with a given filename.
1014
1015 d_pause (d_pause.U):
1016         This variable conditionally defines the HAS_PAUSE symbol, which
1017         indicates to the C program that the pause() routine is available
1018         to suspend a process until a signal is received.
1019
1020 d_phostname (d_gethname.U):
1021         This variable conditionally defines the HAS_PHOSTNAME symbol, which
1022         contains the shell command which, when fed to popen(), may be
1023         used to derive the host name.
1024
1025 d_pipe (d_pipe.U):
1026         This variable conditionally defines the HAS_PIPE symbol, which
1027         indicates to the C program that the pipe() routine is available
1028         to create an inter-process channel.
1029
1030 d_poll (d_poll.U):
1031         This variable conditionally defines the HAS_POLL symbol, which
1032         indicates to the C program that the poll() routine is available
1033         to poll active file descriptors.
1034
1035 d_portable (d_portable.U):
1036         This variable conditionally defines the PORTABLE symbol, which
1037         indicates to the C program that it should not assume that it is
1038         running on the machine it was compiled on.
1039
1040 d_PRId64 (quadfio.U):
1041         This variable conditionally defines the PERL_PRId64 symbol, which
1042         indiciates that stdio has a symbol to print 64-bit decimal numbers.
1043
1044 d_PRIeldbl (longdblfio.U):
1045         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1046         indiciates that stdio has a symbol to print long doubles.
1047
1048 d_PRIEldbl (longdblfio.U):
1049         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1050         indiciates that stdio has a symbol to print long doubles.
1051
1052 d_PRIfldbl (longdblfio.U):
1053         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1054         indiciates that stdio has a symbol to print long doubles.
1055
1056 d_PRIFldbl (longdblfio.U):
1057         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1058         indiciates that stdio has a symbol to print long doubles.
1059
1060 d_PRIgldbl (longdblfio.U):
1061         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1062         indiciates that stdio has a symbol to print long doubles.
1063
1064 d_PRIGldbl (longdblfio.U):
1065         This variable conditionally defines the PERL_PRIfldlbl symbol, which
1066         indiciates that stdio has a symbol to print long doubles.
1067
1068 d_PRIi64 (quadfio.U):
1069         This variable conditionally defines the PERL_PRIi64 symbol, which
1070         indiciates that stdio has a symbol to print 64-bit decimal numbers.
1071
1072 d_PRIo64 (quadfio.U):
1073         This variable conditionally defines the PERL_PRIo64 symbol, which
1074         indiciates that stdio has a symbol to print 64-bit octal numbers.
1075
1076 d_PRIu64 (quadfio.U):
1077         This variable conditionally defines the PERL_PRIu64 symbol, which
1078         indiciates that stdio has a symbol to print 64-bit unsigned decimal
1079         numbers.
1080
1081 d_PRIx64 (quadfio.U):
1082         This variable conditionally defines the PERL_PRIx64 symbol, which
1083         indiciates that stdio has a symbol to print 64-bit hexadecimal numbers.
1084
1085 d_PRIX64 (quadfio.U):
1086         This variable conditionally defines the PERL_PRIX64 symbol, which
1087         indiciates that stdio has a symbol to print 64-bit hExADECimAl numbers.
1088
1089 d_pthread_yield (d_pthread_y.U):
1090         This variable conditionally defines the HAS_PTHREAD_YIELD
1091         symbol if the pthread_yield routine is available to yield
1092         the execution of the current thread.
1093
1094 d_pwage (i_pwd.U):
1095         This variable conditionally defines PWAGE, which indicates
1096         that struct passwd contains pw_age.
1097
1098 d_pwchange (i_pwd.U):
1099         This variable conditionally defines PWCHANGE, which indicates
1100         that struct passwd contains pw_change.
1101
1102 d_pwclass (i_pwd.U):
1103         This variable conditionally defines PWCLASS, which indicates
1104         that struct passwd contains pw_class.
1105
1106 d_pwcomment (i_pwd.U):
1107         This variable conditionally defines PWCOMMENT, which indicates
1108         that struct passwd contains pw_comment.
1109
1110 d_pwexpire (i_pwd.U):
1111         This variable conditionally defines PWEXPIRE, which indicates
1112         that struct passwd contains pw_expire.
1113
1114 d_pwgecos (i_pwd.U):
1115         This variable conditionally defines PWGECOS, which indicates
1116         that struct passwd contains pw_gecos.
1117
1118 d_pwpasswd (i_pwd.U):
1119         This variable conditionally defines PWPASSWD, which indicates
1120         that struct passwd contains pw_passwd.
1121
1122 d_pwquota (i_pwd.U):
1123         This variable conditionally defines PWQUOTA, which indicates
1124         that struct passwd contains pw_quota.
1125
1126 d_quad (quadtype.U):
1127         This variable, if defined, tells that there's a 64-bit integer type,
1128         quadtype.
1129
1130 d_readdir (d_readdir.U):
1131         This variable conditionally defines HAS_READDIR if readdir() is
1132         available to read directory entries.
1133
1134 d_readlink (d_readlink.U):
1135         This variable conditionally defines the HAS_READLINK symbol, which
1136         indicates to the C program that the readlink() routine is available
1137         to read the value of a symbolic link.
1138
1139 d_rename (d_rename.U):
1140         This variable conditionally defines the HAS_RENAME symbol, which
1141         indicates to the C program that the rename() routine is available
1142         to rename files.
1143
1144 d_rewinddir (d_readdir.U):
1145         This variable conditionally defines HAS_REWINDDIR if rewinddir() is
1146         available.
1147
1148 d_rmdir (d_rmdir.U):
1149         This variable conditionally defines HAS_RMDIR if rmdir() is
1150         available to remove directories.
1151
1152 d_safebcpy (d_safebcpy.U):
1153         This variable conditionally defines the HAS_SAFE_BCOPY symbol if
1154         the bcopy() routine can do overlapping copies.
1155
1156 d_safemcpy (d_safemcpy.U):
1157         This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
1158         the memcpy() routine can do overlapping copies.
1159
1160 d_sanemcmp (d_sanemcmp.U):
1161         This variable conditionally defines the HAS_SANE_MEMCMP symbol if
1162         the memcpy() routine is available and can be used to compare relative
1163         magnitudes of chars with their high bits set.
1164
1165 d_sched_yield (d_pthread_y.U):
1166         This variable conditionally defines the HAS_SCHED_YIELD
1167         symbol if the sched_yield routine is available to yield
1168         the execution of the current thread.
1169
1170 d_scm_rights (d_socket.U):
1171         This variable conditionally defines the HAS_SCM_RIGHTS symbol,
1172         which indicates that the SCM_RIGHTS is available.  #ifdef is
1173         not enough because it may be an enum, glibc has been known to do this.
1174
1175 d_seekdir (d_readdir.U):
1176         This variable conditionally defines HAS_SEEKDIR if seekdir() is
1177         available.
1178
1179 d_select (d_select.U):
1180         This variable conditionally defines HAS_SELECT if select() is
1181         available to select active file descriptors. A <sys/time.h>
1182         inclusion may be necessary for the timeout field.
1183
1184 d_sem (d_sem.U):
1185         This variable conditionally defines the HAS_SEM symbol, which
1186         indicates that the entire sem*(2) library is present.
1187
1188 d_semctl (d_semctl.U):
1189         This variable conditionally defines the HAS_SEMCTL symbol, which
1190         indicates to the C program that the semctl() routine is available.
1191
1192 d_semctl_semid_ds (d_union_semun.U):
1193         This variable conditionally defines USE_SEMCTL_SEMID_DS, which
1194         indicates that struct semid_ds * is to be used for semctl IPC_STAT.
1195
1196 d_semctl_semun (d_union_semun.U):
1197         This variable conditionally defines USE_SEMCTL_SEMUN, which
1198         indicates that union semun is to be used for semctl IPC_STAT.
1199
1200 d_semget (d_semget.U):
1201         This variable conditionally defines the HAS_SEMGET symbol, which
1202         indicates to the C program that the semget() routine is available.
1203
1204 d_semop (d_semop.U):
1205         This variable conditionally defines the HAS_SEMOP symbol, which
1206         indicates to the C program that the semop() routine is available.
1207
1208 d_setegid (d_setegid.U):
1209         This variable conditionally defines the HAS_SETEGID symbol, which
1210         indicates to the C program that the setegid() routine is available
1211         to change the effective gid of the current program.
1212
1213 d_seteuid (d_seteuid.U):
1214         This variable conditionally defines the HAS_SETEUID symbol, which
1215         indicates to the C program that the seteuid() routine is available
1216         to change the effective uid of the current program.
1217
1218 d_setgrent (d_setgrent.U):
1219         This variable conditionally defines the HAS_SETGRENT symbol, which
1220         indicates to the C program that the setgrent() routine is available
1221         for initializing sequential access to the group database.
1222
1223 d_setgrps (d_setgrps.U):
1224         This variable conditionally defines the HAS_SETGROUPS symbol, which
1225         indicates to the C program that the setgroups() routine is available
1226         to set the list of process groups.
1227
1228 d_sethent (d_sethent.U):
1229         This variable conditionally defines HAS_SETHOSTENT if sethostent() is
1230         available.
1231
1232 d_setlinebuf (d_setlnbuf.U):
1233         This variable conditionally defines the HAS_SETLINEBUF symbol, which
1234         indicates to the C program that the setlinebuf() routine is available
1235         to change stderr or stdout from block-buffered or unbuffered to a
1236         line-buffered mode.
1237
1238 d_setlocale (d_setlocale.U):
1239         This variable conditionally defines HAS_SETLOCALE if setlocale() is
1240         available to handle locale-specific ctype implementations.
1241
1242 d_setnent (d_setnent.U):
1243         This variable conditionally defines HAS_SETNETENT if setnetent() is
1244         available.
1245
1246 d_setpent (d_setpent.U):
1247         This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
1248         available.
1249
1250 d_setpgid (d_setpgid.U):
1251         This variable conditionally defines the HAS_SETPGID symbol if the
1252         setpgid(pid, gpid) function is available to set process group ID.
1253
1254 d_setpgrp2 (d_setpgrp2.U):
1255         This variable conditionally defines the HAS_SETPGRP2 symbol, which
1256         indicates to the C program that the setpgrp2() (as in DG/UX) routine
1257         is available to set the current process group.
1258
1259 d_setpgrp (d_setpgrp.U):
1260         This variable conditionally defines HAS_SETPGRP if setpgrp() is
1261         available to set the current process group.
1262
1263 d_setprior (d_setprior.U):
1264         This variable conditionally defines HAS_SETPRIORITY if setpriority()
1265         is available to set a process's priority.
1266
1267 d_setpwent (d_setpwent.U):
1268         This variable conditionally defines the HAS_SETPWENT symbol, which
1269         indicates to the C program that the setpwent() routine is available
1270         for initializing sequential access to the passwd database.
1271
1272 d_setregid (d_setregid.U):
1273         This variable conditionally defines HAS_SETREGID if setregid() is
1274         available to change the real and effective gid of the current
1275         process.
1276
1277 d_setresgid (d_setregid.U):
1278         This variable conditionally defines HAS_SETRESGID if setresgid() is
1279         available to change the real, effective and saved gid of the current
1280         process.
1281
1282 d_setresuid (d_setreuid.U):
1283         This variable conditionally defines HAS_SETREUID if setresuid() is
1284         available to change the real, effective and saved uid of the current
1285         process.
1286
1287 d_setreuid (d_setreuid.U):
1288         This variable conditionally defines HAS_SETREUID if setreuid() is
1289         available to change the real and effective uid of the current
1290         process.
1291
1292 d_setrgid (d_setrgid.U):
1293         This variable conditionally defines the HAS_SETRGID symbol, which
1294         indicates to the C program that the setrgid() routine is available
1295         to change the real gid of the current program.
1296
1297 d_setruid (d_setruid.U):
1298         This variable conditionally defines the HAS_SETRUID symbol, which
1299         indicates to the C program that the setruid() routine is available
1300         to change the real uid of the current program.
1301
1302 d_setsent (d_setsent.U):
1303         This variable conditionally defines HAS_SETSERVENT if setservent() is
1304         available.
1305
1306 d_setsid (d_setsid.U):
1307         This variable conditionally defines HAS_SETSID if setsid() is
1308         available to set the process group ID.
1309
1310 d_setspent (d_setspent.U):
1311         This variable conditionally defines HAS_SETSPENT if setspent() is
1312         available to initialize the scan of SysV shadow password entries.
1313
1314 d_setvbuf (d_setvbuf.U):
1315         This variable conditionally defines the HAS_SETVBUF symbol, which
1316         indicates to the C program that the setvbuf() routine is available
1317         to change buffering on an open stdio stream.
1318
1319 d_sfio (d_sfio.U):
1320         This variable conditionally defines the USE_SFIO symbol,
1321         and indicates whether sfio is available (and should be used).
1322
1323 d_shm (d_shm.U):
1324         This variable conditionally defines the HAS_SHM symbol, which
1325         indicates that the entire shm*(2) library is present.
1326
1327 d_shmat (d_shmat.U):
1328         This variable conditionally defines the HAS_SHMAT symbol, which
1329         indicates to the C program that the shmat() routine is available.
1330
1331 d_shmatprototype (d_shmat.U):
1332         This variable conditionally defines the HAS_SHMAT_PROTOTYPE 
1333         symbol, which indicates that sys/shm.h has a prototype for
1334         shmat.
1335
1336 d_shmctl (d_shmctl.U):
1337         This variable conditionally defines the HAS_SHMCTL symbol, which
1338         indicates to the C program that the shmctl() routine is available.
1339
1340 d_shmdt (d_shmdt.U):
1341         This variable conditionally defines the HAS_SHMDT symbol, which
1342         indicates to the C program that the shmdt() routine is available.
1343
1344 d_shmget (d_shmget.U):
1345         This variable conditionally defines the HAS_SHMGET symbol, which
1346         indicates to the C program that the shmget() routine is available.
1347
1348 d_sigaction (d_sigaction.U):
1349         This variable conditionally defines the HAS_SIGACTION symbol, which
1350         indicates that the Vr4 sigaction() routine is available.
1351
1352 d_sigsetjmp (d_sigsetjmp.U):
1353         This variable conditionally defines the HAS_SIGSETJMP symbol,
1354         which indicates that the sigsetjmp() routine is available to
1355         call setjmp() and optionally save the process's signal mask.
1356
1357 d_socket (d_socket.U):
1358         This variable conditionally defines HAS_SOCKET, which indicates
1359         that the BSD socket interface is supported.
1360
1361 d_sockpair (d_socket.U):
1362         This variable conditionally defines the HAS_SOCKETPAIR symbol, which
1363         indicates that the BSD socketpair() is supported.
1364
1365 d_sqrtl (d_sqrtl.U):
1366         This variable conditionally defines the HAS_SQRTL symbol, which
1367         indicates to the C program that the sqrtl() routine is available.
1368
1369 d_statblks (d_statblks.U):
1370         This variable conditionally defines USE_STAT_BLOCKS
1371         if this system has a stat structure declaring
1372         st_blksize and st_blocks.
1373
1374 d_statfs_f_flags (d_statfs_f_flags.U):
1375         This variable conditionally defines the HAS_STRUCT_STATFS_F_FLAGS
1376         symbol, which indicates to struct statfs from has f_flags member.
1377         This kind of struct statfs is coming from sys/mount.h (BSD),
1378         not from sys/statfs.h (SYSV).
1379
1380 d_statfs_s (d_statfs_s.U):
1381         This variable conditionally defines the HAS_STRUCT_STATFS symbol,
1382         which indicates that the struct statfs is supported.
1383
1384 d_statvfs (d_statvfs.U):
1385         This variable conditionally defines the HAS_STATVFS symbol, which
1386         indicates to the C program that the statvfs() routine is available.
1387
1388 d_stdio_cnt_lval (d_stdstdio.U):
1389         This variable conditionally defines STDIO_CNT_LVALUE if the
1390         FILE_cnt macro can be used as an lvalue.
1391
1392 d_stdio_ptr_lval (d_stdstdio.U):
1393         This variable conditionally defines STDIO_PTR_LVALUE if the
1394         FILE_ptr macro can be used as an lvalue.
1395
1396 d_stdio_stream_array (stdio_streams.U):
1397         This variable tells whether there is an array holding
1398         the stdio streams.
1399
1400 d_stdiobase (d_stdstdio.U):
1401         This variable conditionally defines USE_STDIO_BASE if this system
1402         has a FILE structure declaring a usable _base field (or equivalent)
1403         in stdio.h.
1404
1405 d_stdstdio (d_stdstdio.U):
1406         This variable conditionally defines USE_STDIO_PTR if this system
1407         has a FILE structure declaring usable _ptr and _cnt fields (or
1408         equivalent) in stdio.h.
1409
1410 d_strchr (d_strchr.U):
1411         This variable conditionally defines HAS_STRCHR if strchr() and
1412         strrchr() are available for string searching.
1413
1414 d_strcoll (d_strcoll.U):
1415         This variable conditionally defines HAS_STRCOLL if strcoll() is
1416         available to compare strings using collating information.
1417
1418 d_strctcpy (d_strctcpy.U):
1419         This variable conditionally defines the USE_STRUCT_COPY symbol, which
1420         indicates to the C program that this C compiler knows how to copy
1421         structures.
1422
1423 d_strerrm (d_strerror.U):
1424         This variable holds what Strerrr is defined as to translate an error
1425         code condition into an error message string. It could be 'strerror'
1426         or a more complex macro emulating strrror with sys_errlist[], or the
1427         "unknown" string when both strerror and sys_errlist are missing.
1428
1429 d_strerror (d_strerror.U):
1430         This variable conditionally defines HAS_STRERROR if strerror() is
1431         available to translate error numbers to strings.
1432
1433 d_strtod (d_strtod.U):
1434         This variable conditionally defines the HAS_STRTOD symbol, which
1435         indicates to the C program that the strtod() routine is available
1436         to provide better numeric string conversion than atof().
1437
1438 d_strtol (d_strtol.U):
1439         This variable conditionally defines the HAS_STRTOL symbol, which
1440         indicates to the C program that the strtol() routine is available
1441         to provide better numeric string conversion than atoi() and friends.
1442
1443 d_strtold (d_strtold.U):
1444         This variable conditionally defines the HAS_STRTOLD symbol, which
1445         indicates to the C program that the strtold() routine is available.
1446
1447 d_strtoll (d_strtoll.U):
1448         This variable conditionally defines the HAS_STRTOLL symbol, which
1449         indicates to the C program that the strtoll() routine is available.
1450
1451 d_strtoul (d_strtoul.U):
1452         This variable conditionally defines the HAS_STRTOUL symbol, which
1453         indicates to the C program that the strtoul() routine is available
1454         to provide conversion of strings to unsigned long.
1455
1456 d_strtoull (d_strtoull.U):
1457         This variable conditionally defines the HAS_STRTOULL symbol, which
1458         indicates to the C program that the strtoull() routine is available.
1459
1460 d_strtouq (d_strtouq.U):
1461         This variable conditionally defines the HAS_STRTOUQ symbol, which
1462         indicates to the C program that the strtouq() routine is available.
1463
1464 d_strxfrm (d_strxfrm.U):
1465         This variable conditionally defines HAS_STRXFRM if strxfrm() is
1466         available to transform strings.
1467
1468 d_suidsafe (d_dosuid.U):
1469         This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
1470         if setuid scripts can be secure.  This test looks in /dev/fd/.
1471
1472 d_symlink (d_symlink.U):
1473         This variable conditionally defines the HAS_SYMLINK symbol, which
1474         indicates to the C program that the symlink() routine is available
1475         to create symbolic links.
1476
1477 d_syscall (d_syscall.U):
1478         This variable conditionally defines HAS_SYSCALL if syscall() is
1479         available call arbitrary system calls.
1480
1481 d_sysconf (d_sysconf.U):
1482         This variable conditionally defines the HAS_SYSCONF symbol, which
1483         indicates to the C program that the sysconf() routine is available
1484         to determine system related limits and options.
1485
1486 d_sysernlst (d_strerror.U):
1487         This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[]
1488         is available to translate error numbers to the symbolic name.
1489
1490 d_syserrlst (d_strerror.U):
1491         This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
1492         available to translate error numbers to strings.
1493
1494 d_system (d_system.U):
1495         This variable conditionally defines HAS_SYSTEM if system() is
1496         available to issue a shell command.
1497
1498 d_tcgetpgrp (d_tcgtpgrp.U):
1499         This variable conditionally defines the HAS_TCGETPGRP symbol, which
1500         indicates to the C program that the tcgetpgrp() routine is available.
1501         to get foreground process group ID.
1502
1503 d_tcsetpgrp (d_tcstpgrp.U):
1504         This variable conditionally defines the HAS_TCSETPGRP symbol, which
1505         indicates to the C program that the tcsetpgrp() routine is available
1506         to set foreground process group ID.
1507
1508 d_telldir (d_readdir.U):
1509         This variable conditionally defines HAS_TELLDIR if telldir() is
1510         available.
1511
1512 d_telldirproto (d_telldirproto.U):
1513         This variable conditionally defines the HAS_TELLDIR_PROTO symbol,
1514         which indicates to the C program that the system provides
1515         a prototype for the telldir() function.  Otherwise, it is
1516         up to the program to supply one.
1517
1518 d_time (d_time.U):
1519         This variable conditionally defines the HAS_TIME symbol, which indicates
1520         that the time() routine exists.  The time() routine is normaly
1521         provided on UNIX systems.
1522
1523 d_times (d_times.U):
1524         This variable conditionally defines the HAS_TIMES symbol, which indicates
1525         that the times() routine exists.  The times() routine is normaly
1526         provided on UNIX systems. You may have to include <sys/times.h>.
1527
1528 d_truncate (d_truncate.U):
1529         This variable conditionally defines HAS_TRUNCATE if truncate() is
1530         available to truncate files.
1531
1532 d_tzname (d_tzname.U):
1533         This variable conditionally defines HAS_TZNAME if tzname[] is
1534         available to access timezone names.
1535
1536 d_umask (d_umask.U):
1537         This variable conditionally defines the HAS_UMASK symbol, which
1538         indicates to the C program that the umask() routine is available.
1539         to set and get the value of the file creation mask.
1540
1541 d_uname (d_gethname.U):
1542         This variable conditionally defines the HAS_UNAME symbol, which
1543         indicates to the C program that the uname() routine may be
1544         used to derive the host name.
1545
1546 d_union_semun (d_union_semun.U):
1547         This variable conditionally defines HAS_UNION_SEMUN if the
1548         union semun is defined by including <sys/sem.h>.
1549
1550 d_ustat (d_ustat.U):
1551         This variable conditionally defines HAS_USTAT if ustat() is
1552         available to query file system statistics by dev_t.
1553
1554 d_vendorbin (vendorbin.U):
1555         This variable conditionally defines PERL_VENDORBIN.
1556
1557 d_vendorlib (vendorlib.U):
1558         This variable conditionally defines PERL_VENDORLIB.
1559
1560 d_vfork (d_vfork.U):
1561         This variable conditionally defines the HAS_VFORK symbol, which
1562         indicates the vfork() routine is available.
1563
1564 d_void_closedir (d_closedir.U):
1565         This variable conditionally defines VOID_CLOSEDIR if closedir()
1566         does not return a value.
1567
1568 d_voidsig (d_voidsig.U):
1569         This variable conditionally defines VOIDSIG if this system
1570         declares "void (*signal(...))()" in signal.h.  The old way was to
1571         declare it as "int (*signal(...))()".
1572
1573 d_voidtty (i_sysioctl.U):
1574         This variable conditionally defines USE_IOCNOTTY to indicate that the
1575         ioctl() call with TIOCNOTTY should be used to void tty association.
1576         Otherwise (on USG probably), it is enough to close the standard file
1577         decriptors and do a setpgrp().
1578
1579 d_volatile (d_volatile.U):
1580         This variable conditionally defines the HASVOLATILE symbol, which
1581         indicates to the C program that this C compiler knows about the
1582         volatile declaration.
1583
1584 d_vprintf (d_vprintf.U):
1585         This variable conditionally defines the HAS_VPRINTF symbol, which
1586         indicates to the C program that the vprintf() routine is available
1587         to printf with a pointer to an argument list.
1588
1589 d_wait4 (d_wait4.U):
1590         This variable conditionally defines the HAS_WAIT4 symbol, which
1591         indicates the wait4() routine is available.
1592
1593 d_waitpid (d_waitpid.U):
1594         This variable conditionally defines HAS_WAITPID if waitpid() is
1595         available to wait for child process.
1596
1597 d_wcstombs (d_wcstombs.U):
1598         This variable conditionally defines the HAS_WCSTOMBS symbol, which
1599         indicates to the C program that the wcstombs() routine is available
1600         to convert wide character strings to multibyte strings.
1601
1602 d_wctomb (d_wctomb.U):
1603         This variable conditionally defines the HAS_WCTOMB symbol, which
1604         indicates to the C program that the wctomb() routine is available
1605         to convert a wide character to a multibyte.
1606
1607 d_xenix (Guess.U):
1608         This variable conditionally defines the symbol XENIX, which alerts
1609         the C program that it runs under Xenix.
1610
1611 date (Loc.U):
1612         This variable is used internally by Configure to determine the
1613         full pathname (if any) of the date program.  After Configure runs,
1614         the value is reset to a plain "date" and is not useful.
1615
1616 db_hashtype (i_db.U):
1617         This variable contains the type of the hash structure element
1618         in the <db.h> header file.  In older versions of DB, it was
1619         int, while in newer ones it is u_int32_t.
1620
1621 db_prefixtype (i_db.U):
1622         This variable contains the type of the prefix structure element
1623         in the <db.h> header file.  In older versions of DB, it was
1624         int, while in newer ones it is size_t.
1625
1626 defvoidused (voidflags.U):
1627         This variable contains the default value of the VOIDUSED symbol (15).
1628
1629 direntrytype (i_dirent.U):
1630         This symbol is set to 'struct direct' or 'struct dirent' depending on
1631         whether dirent is available or not. You should use this pseudo type to
1632         portably declare your directory entries.
1633
1634 dlext (dlext.U):
1635         This variable contains the extension that is to be used for the
1636         dynamically loaded modules that perl generaties.
1637
1638 dlsrc (dlsrc.U):
1639         This variable contains the name of the dynamic loading file that
1640         will be used with the package.
1641
1642 doublesize (doublesize.U):
1643         This variable contains the value of the DOUBLESIZE symbol, which
1644         indicates to the C program how many bytes there are in a double.
1645
1646 drand01 (randfunc.U):
1647         Indicates the macro to be used to generate normalized
1648         random numbers.  Uses randfunc, often divided by
1649         (double) (((unsigned long) 1 << randbits)) in order to
1650         normalize the result.
1651         In C programs, the macro 'Drand01' is mapped to drand01.
1652
1653 dynamic_ext (Extensions.U):
1654         This variable holds a list of XS extension files we want to
1655         link dynamically into the package.  It is used by Makefile.
1656
1657 eagain (nblock_io.U):
1658         This variable bears the symbolic errno code set by read() when no
1659         data is present on the file and non-blocking I/O was enabled (otherwise,
1660         read() blocks naturally).
1661
1662 ebcdic (ebcdic.U):
1663         This variable conditionally defines EBCDIC if this
1664         system uses EBCDIC encoding.  Among other things, this
1665         means that the character ranges are not contiguous.
1666         See trnl.U
1667
1668 echo (Loc.U):
1669         This variable is used internally by Configure to determine the
1670         full pathname (if any) of the echo program.  After Configure runs,
1671         the value is reset to a plain "echo" and is not useful.
1672
1673 egrep (Loc.U):
1674         This variable is used internally by Configure to determine the
1675         full pathname (if any) of the egrep program.  After Configure runs,
1676         the value is reset to a plain "egrep" and is not useful.
1677
1678 emacs (Loc.U):
1679         This variable is defined but not used by Configure.
1680         The value is a plain '' and is not useful.
1681
1682 eunicefix (Init.U):
1683         When running under Eunice this variable contains a command which will
1684         convert a shell script to the proper form of text file for it to be
1685         executable by the shell.  On other systems it is a no-op.
1686
1687 exe_ext (Unix.U):
1688         This is an old synonym for _exe.
1689
1690 expr (Loc.U):
1691         This variable is used internally by Configure to determine the
1692         full pathname (if any) of the expr program.  After Configure runs,
1693         the value is reset to a plain "expr" and is not useful.
1694
1695 extensions (Extensions.U):
1696         This variable holds a list of all extension files (both XS and
1697         non-xs linked into the package.  It is propagated to Config.pm
1698         and is typically used to test whether a particular extesion 
1699         is available.
1700
1701 fflushall (fflushall.U):
1702         This symbol, if defined, tells that to flush
1703         all pending stdio output one must loop through all
1704         the stdio file handles stored in an array and fflush them.
1705         Note that if fflushNULL is defined, fflushall will not
1706         even be probed for and will be left undefined.
1707
1708 fflushNULL (fflushall.U):
1709         This symbol, if defined, tells that fflush(NULL) does flush
1710         all pending stdio output.
1711
1712 find (Loc.U):
1713         This variable is defined but not used by Configure.
1714         The value is a plain '' and is not useful.
1715
1716 firstmakefile (Unix.U):
1717         This variable defines the first file searched by make.  On unix,
1718         it is makefile (then Makefile).  On case-insensitive systems,
1719         it might be something else.  This is only used to deal with
1720         convoluted make depend tricks.
1721
1722 flex (Loc.U):
1723         This variable is defined but not used by Configure.
1724         The value is a plain '' and is not useful.
1725
1726 fpossize (fpossize.U):
1727         This variable contains the size of a fpostype in bytes.
1728
1729 fpostype (fpostype.U):
1730         This variable defines Fpos_t to be something like fpos_t, long, 
1731         uint, or whatever type is used to declare file positions in libc.
1732
1733 freetype (mallocsrc.U):
1734         This variable contains the return type of free().  It is usually
1735         void, but occasionally int.
1736
1737 full_ar (Loc_ar.U):
1738         This variable contains the full pathname to 'ar', whether or
1739         not the user has specified 'portability'.  This is only used
1740         in the Makefile.SH.
1741
1742 full_csh (d_csh.U):
1743         This variable contains the full pathname to 'csh', whether or
1744         not the user has specified 'portability'.  This is only used
1745         in the compiled C program, and we assume that all systems which
1746         can share this executable will have the same full pathname to
1747         'csh.'
1748
1749 full_sed (Loc_sed.U):
1750         This variable contains the full pathname to 'sed', whether or
1751         not the user has specified 'portability'.  This is only used
1752         in the compiled C program, and we assume that all systems which
1753         can share this executable will have the same full pathname to
1754         'sed.'
1755
1756 gccversion (cc.U):
1757         If GNU cc (gcc) is used, this variable holds '1' or '2' to 
1758         indicate whether the compiler is version 1 or 2.  This is used in
1759         setting some of the default cflags.  It is set to '' if not gcc.
1760
1761 gidformat (gidf.U):
1762         This variable contains the format string used for printing a Gid_t.
1763
1764 gidsign (gidsign.U):
1765         This variable contains the signedness of a gidtype.
1766         1 for unsigned, -1 for signed.
1767
1768 gidsize (gidsize.U):
1769         This variable contains the size of a gidtype in bytes.
1770
1771 gidtype (gidtype.U):
1772         This variable defines Gid_t to be something like gid_t, int,
1773         ushort, or whatever type is used to declare the return type
1774         of getgid().  Typically, it is the type of group ids in the kernel.
1775
1776 glibpth (libpth.U):
1777         This variable holds the general path (space-separated) used to
1778         find libraries.  It may contain directories that do not exist on
1779         this platform, libpth is the cleaned-up version.
1780
1781 grep (Loc.U):
1782         This variable is used internally by Configure to determine the
1783         full pathname (if any) of the grep program.  After Configure runs,
1784         the value is reset to a plain "grep" and is not useful.
1785
1786 groupcat (nis.U):
1787         This variable contains a command that produces the text of the
1788         /etc/group file.  This is normally "cat /etc/group", but can be
1789         "ypcat group" when NIS is used.
1790         On some systems, such as os390, there may be no equivalent
1791         command, in which case this variable is unset.
1792
1793 groupstype (groupstype.U):
1794         This variable defines Groups_t to be something like gid_t, int, 
1795         ushort, or whatever type is used for the second argument to
1796         getgroups() and setgroups().  Usually, this is the same as
1797         gidtype (gid_t), but sometimes it isn't.
1798
1799 gzip (Loc.U):
1800         This variable is used internally by Configure to determine the
1801         full pathname (if any) of the gzip program.  After Configure runs,
1802         the value is reset to a plain "gzip" and is not useful.
1803
1804 h_fcntl (h_fcntl.U):
1805         This is variable gets set in various places to tell i_fcntl that
1806         <fcntl.h> should be included.
1807
1808 h_sysfile (h_sysfile.U):
1809         This is variable gets set in various places to tell i_sys_file that
1810         <sys/file.h> should be included.
1811
1812 hint (Oldconfig.U):
1813         Gives the type of hints used for previous answers. May be one of
1814         "default", "recommended" or "previous".
1815
1816 hostcat (nis.U):
1817         This variable contains a command that produces the text of the
1818         /etc/hosts file.  This is normally "cat /etc/hosts", but can be
1819         "ypcat hosts" when NIS is used.
1820         On some systems, such as os390, there may be no equivalent
1821         command, in which case this variable is unset.
1822
1823 huge (models.U):
1824         This variable contains a flag which will tell the C compiler and loader
1825         to produce a program running with a huge memory model.  If the
1826         huge model is not supported, contains the flag to produce large
1827         model programs.  It is up to the Makefile to use this.
1828
1829 i16size (perlxv.U):
1830         This variable is the size of an I16 in bytes.
1831
1832 i16type (perlxv.U):
1833         This variable contains the C type used for Perl's I16.
1834
1835 i32size (perlxv.U):
1836         This variable is the size of an I32 in bytes.
1837
1838 i32type (perlxv.U):
1839         This variable contains the C type used for Perl's I32.
1840
1841 i64size (perlxv.U):
1842         This variable is the size of an I64 in bytes.
1843
1844 i64type (perlxv.U):
1845         This variable contains the C type used for Perl's I64.
1846
1847 i8size (perlxv.U):
1848         This variable is the size of an I8 in bytes.
1849
1850 i8type (perlxv.U):
1851         This variable contains the C type used for Perl's I8.
1852
1853 i_arpainet (i_arpainet.U):
1854         This variable conditionally defines the I_ARPA_INET symbol,
1855         and indicates whether a C program should include <arpa/inet.h>.
1856
1857 i_bsdioctl (i_sysioctl.U):
1858         This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
1859         indicates to the C program that <sys/bsdioctl.h> exists and should
1860         be included.
1861
1862 i_db (i_db.U):
1863         This variable conditionally defines the I_DB symbol, and indicates
1864         whether a C program may include Berkeley's DB include file <db.h>.
1865
1866 i_dbm (i_dbm.U):
1867         This variable conditionally defines the I_DBM symbol, which
1868         indicates to the C program that <dbm.h> exists and should
1869         be included.
1870
1871 i_dirent (i_dirent.U):
1872         This variable conditionally defines I_DIRENT, which indicates
1873         to the C program that it should include <dirent.h>.
1874
1875 i_dld (i_dld.U):
1876         This variable conditionally defines the I_DLD symbol, which
1877         indicates to the C program that <dld.h> (GNU dynamic loading)
1878         exists and should be included.
1879
1880 i_dlfcn (i_dlfcn.U):
1881         This variable conditionally defines the I_DLFCN symbol, which
1882         indicates to the C program that <dlfcn.h> exists and should
1883         be included.
1884
1885 i_fcntl (i_fcntl.U):
1886         This variable controls the value of I_FCNTL (which tells
1887         the C program to include <fcntl.h>).
1888
1889 i_float (i_float.U):
1890         This variable conditionally defines the I_FLOAT symbol, and indicates
1891         whether a C program may include <float.h> to get symbols like DBL_MAX
1892         or DBL_MIN, i.e. machine dependent floating point values.
1893
1894 i_gdbm (i_gdbm.U):
1895         This variable conditionally defines the I_GDBM symbol, which
1896         indicates to the C program that <gdbm.h> exists and should
1897         be included.
1898
1899 i_grp (i_grp.U):
1900         This variable conditionally defines the I_GRP symbol, and indicates
1901         whether a C program should include <grp.h>.
1902
1903 i_iconv (i_iconv.U):
1904         This variable conditionally defines the I_ICONV symbol, and indicates
1905         whether a C program should include <iconv.h>.
1906
1907 i_inttypes (i_inttypes.U):
1908         This variable conditionally defines the I_INTTYPES symbol,
1909         and indicates whether a C program should include <inttypes.h>.
1910
1911 i_limits (i_limits.U):
1912         This variable conditionally defines the I_LIMITS symbol, and indicates
1913         whether a C program may include <limits.h> to get symbols like WORD_BIT
1914         and friends.
1915
1916 i_locale (i_locale.U):
1917         This variable conditionally defines the I_LOCALE symbol,
1918         and indicates whether a C program should include <locale.h>.
1919
1920 i_machcthr (i_machcthr.U):
1921         This variable conditionally defines the I_MACH_CTHREADS symbol,
1922         and indicates whether a C program should include <mach/cthreads.h>.
1923
1924 i_malloc (i_malloc.U):
1925         This variable conditionally defines the I_MALLOC symbol, and indicates
1926         whether a C program should include <malloc.h>.
1927
1928 i_math (i_math.U):
1929         This variable conditionally defines the I_MATH symbol, and indicates
1930         whether a C program may include <math.h>.
1931
1932 i_memory (i_memory.U):
1933         This variable conditionally defines the I_MEMORY symbol, and indicates
1934         whether a C program should include <memory.h>.
1935
1936 i_mntent (i_mntent.U):
1937         This variable conditionally defines the I_MNTENT symbol, and indicates
1938         whether a C program should include <mntent.h>.
1939
1940 i_ndbm (i_ndbm.U):
1941         This variable conditionally defines the I_NDBM symbol, which
1942         indicates to the C program that <ndbm.h> exists and should
1943         be included.
1944
1945 i_netdb (i_netdb.U):
1946         This variable conditionally defines the I_NETDB symbol, and indicates
1947         whether a C program should include <netdb.h>.
1948
1949 i_neterrno (i_neterrno.U):
1950         This variable conditionally defines the I_NET_ERRNO symbol, which
1951         indicates to the C program that <net/errno.h> exists and should
1952         be included.
1953
1954 i_netinettcp (i_netinettcp.U):
1955         This variable conditionally defines the I_NETINET_TCP symbol,
1956         and indicates whether a C program should include <netinet/tcp.h>.
1957
1958 i_niin (i_niin.U):
1959         This variable conditionally defines I_NETINET_IN, which indicates
1960         to the C program that it should include <netinet/in.h>. Otherwise,
1961         you may try <sys/in.h>.
1962
1963 i_poll (i_poll.U):
1964         This variable conditionally defines the I_POLL symbol, and indicates
1965         whether a C program should include <poll.h>.
1966
1967 i_pthread (i_pthread.U):
1968         This variable conditionally defines the I_PTHREAD symbol,
1969         and indicates whether a C program should include <pthread.h>.
1970
1971 i_pwd (i_pwd.U):
1972         This variable conditionally defines I_PWD, which indicates
1973         to the C program that it should include <pwd.h>.
1974
1975 i_rpcsvcdbm (i_dbm.U):
1976         This variable conditionally defines the I_RPCSVC_DBM symbol, which
1977         indicates to the C program that <rpcsvc/dbm.h> exists and should
1978         be included.  Some System V systems might need this instead of <dbm.h>.
1979
1980 i_sfio (i_sfio.U):
1981         This variable conditionally defines the I_SFIO symbol,
1982         and indicates whether a C program should include <sfio.h>.
1983
1984 i_sgtty (i_termio.U):
1985         This variable conditionally defines the I_SGTTY symbol, which
1986         indicates to the C program that it should include <sgtty.h> rather
1987         than <termio.h>.
1988
1989 i_shadow (i_shadow.U):
1990         This variable conditionally defines the I_SHADOW symbol, and indicates
1991         whether a C program should include <shadow.h>.
1992
1993 i_socks (i_socks.U):
1994         This variable conditionally defines the I_SOCKS symbol, and indicates
1995         whether a C program should include <socks.h>.
1996
1997 i_stdarg (i_varhdr.U):
1998         This variable conditionally defines the I_STDARG symbol, which
1999         indicates to the C program that <stdarg.h> exists and should
2000         be included.
2001
2002 i_stddef (i_stddef.U):
2003         This variable conditionally defines the I_STDDEF symbol, which
2004         indicates to the C program that <stddef.h> exists and should
2005         be included.
2006
2007 i_stdlib (i_stdlib.U):
2008         This variable conditionally defines the I_STDLIB symbol, which
2009         indicates to the C program that <stdlib.h> exists and should
2010         be included.
2011
2012 i_string (i_string.U):
2013         This variable conditionally defines the I_STRING symbol, which
2014         indicates that <string.h> should be included rather than <strings.h>.
2015
2016 i_sysaccess (i_sysaccess.U):
2017         This variable conditionally defines the I_SYS_ACCESS symbol,
2018         and indicates whether a C program should include <sys/access.h>.
2019
2020 i_sysdir (i_sysdir.U):
2021         This variable conditionally defines the I_SYS_DIR symbol, and indicates
2022         whether a C program should include <sys/dir.h>.
2023
2024 i_sysfile (i_sysfile.U):
2025         This variable conditionally defines the I_SYS_FILE symbol, and indicates
2026         whether a C program should include <sys/file.h> to get R_OK and friends.
2027
2028 i_sysfilio (i_sysioctl.U):
2029         This variable conditionally defines the I_SYS_FILIO symbol, which
2030         indicates to the C program that <sys/filio.h> exists and should
2031         be included in preference to <sys/ioctl.h>.
2032
2033 i_sysin (i_niin.U):
2034         This variable conditionally defines I_SYS_IN, which indicates
2035         to the C program that it should include <sys/in.h> instead of
2036         <netinet/in.h>.
2037
2038 i_sysioctl (i_sysioctl.U):
2039         This variable conditionally defines the I_SYS_IOCTL symbol, which
2040         indicates to the C program that <sys/ioctl.h> exists and should
2041         be included.
2042
2043 i_syslog (i_syslog.U):
2044         This variable conditionally defines the I_SYSLOG symbol,
2045         and indicates whether a C program should include <syslog.h>.
2046
2047 i_sysmman (i_sysmman.U):
2048         This variable conditionally defines the I_SYS_MMAN symbol, and
2049         indicates whether a C program should include <sys/mman.h>.
2050
2051 i_sysmount (i_sysmount.U):
2052         This variable conditionally defines the I_SYSMOUNT symbol,
2053         and indicates whether a C program should include <sys/mount.h>.
2054
2055 i_sysndir (i_sysndir.U):
2056         This variable conditionally defines the I_SYS_NDIR symbol, and indicates
2057         whether a C program should include <sys/ndir.h>.
2058
2059 i_sysparam (i_sysparam.U):
2060         This variable conditionally defines the I_SYS_PARAM symbol, and indicates
2061         whether a C program should include <sys/param.h>.
2062
2063 i_sysresrc (i_sysresrc.U):
2064         This variable conditionally defines the I_SYS_RESOURCE symbol,
2065         and indicates whether a C program should include <sys/resource.h>.
2066
2067 i_syssecrt (i_syssecrt.U):
2068         This variable conditionally defines the I_SYS_SECURITY symbol,
2069         and indicates whether a C program should include <sys/security.h>.
2070
2071 i_sysselct (i_sysselct.U):
2072         This variable conditionally defines I_SYS_SELECT, which indicates
2073         to the C program that it should include <sys/select.h> in order to
2074         get the definition of struct timeval.
2075
2076 i_syssockio (i_sysioctl.U):
2077         This variable conditionally defines I_SYS_SOCKIO to indicate to the
2078         C program that socket ioctl codes may be found in <sys/sockio.h>
2079         instead of <sys/ioctl.h>.
2080
2081 i_sysstat (i_sysstat.U):
2082         This variable conditionally defines the I_SYS_STAT symbol,
2083         and indicates whether a C program should include <sys/stat.h>.
2084
2085 i_sysstatfs (i_sysstatfs.U):
2086         This variable conditionally defines the I_SYSSTATFS symbol,
2087         and indicates whether a C program should include <sys/statfs.h>.
2088
2089 i_sysstatvfs (i_sysstatvfs.U):
2090         This variable conditionally defines the I_SYSSTATVFS symbol,
2091         and indicates whether a C program should include <sys/statvfs.h>.
2092
2093 i_systime (i_time.U):
2094         This variable conditionally defines I_SYS_TIME, which indicates
2095         to the C program that it should include <sys/time.h>.
2096
2097 i_systimek (i_time.U):
2098         This variable conditionally defines I_SYS_TIME_KERNEL, which
2099         indicates to the C program that it should include <sys/time.h>
2100         with KERNEL defined.
2101
2102 i_systimes (i_systimes.U):
2103         This variable conditionally defines the I_SYS_TIMES symbol, and indicates
2104         whether a C program should include <sys/times.h>.
2105
2106 i_systypes (i_systypes.U):
2107         This variable conditionally defines the I_SYS_TYPES symbol,
2108         and indicates whether a C program should include <sys/types.h>.
2109
2110 i_sysuio (i_sysuio.U):
2111         This variable conditionally defines the I_SYSUIO symbol, and indicates
2112         whether a C program should include <sys/uio.h>.
2113
2114 i_sysun (i_sysun.U):
2115         This variable conditionally defines I_SYS_UN, which indicates
2116         to the C program that it should include <sys/un.h> to get UNIX
2117         domain socket definitions.
2118
2119 i_sysvfs (i_sysvfs.U):
2120         This variable conditionally defines the I_SYSVFS symbol,
2121         and indicates whether a C program should include <sys/vfs.h>.
2122
2123 i_syswait (i_syswait.U):
2124         This variable conditionally defines I_SYS_WAIT, which indicates
2125         to the C program that it should include <sys/wait.h>.
2126
2127 i_termio (i_termio.U):
2128         This variable conditionally defines the I_TERMIO symbol, which
2129         indicates to the C program that it should include <termio.h> rather
2130         than <sgtty.h>.
2131
2132 i_termios (i_termio.U):
2133         This variable conditionally defines the I_TERMIOS symbol, which
2134         indicates to the C program that the POSIX <termios.h> file is
2135         to be included.
2136
2137 i_time (i_time.U):
2138         This variable conditionally defines I_TIME, which indicates
2139         to the C program that it should include <time.h>.
2140
2141 i_unistd (i_unistd.U):
2142         This variable conditionally defines the I_UNISTD symbol, and indicates
2143         whether a C program should include <unistd.h>.
2144
2145 i_ustat (i_ustat.U):
2146         This variable conditionally defines the I_USTAT symbol, and indicates
2147         whether a C program should include <ustat.h>.
2148
2149 i_utime (i_utime.U):
2150         This variable conditionally defines the I_UTIME symbol, and indicates
2151         whether a C program should include <utime.h>.
2152
2153 i_values (i_values.U):
2154         This variable conditionally defines the I_VALUES symbol, and indicates
2155         whether a C program may include <values.h> to get symbols like MAXLONG
2156         and friends.
2157
2158 i_varargs (i_varhdr.U):
2159         This variable conditionally defines I_VARARGS, which indicates
2160         to the C program that it should include <varargs.h>.
2161
2162 i_varhdr (i_varhdr.U):
2163         Contains the name of the header to be included to get va_dcl definition.
2164         Typically one of varargs.h or stdarg.h.
2165
2166 i_vfork (i_vfork.U):
2167         This variable conditionally defines the I_VFORK symbol, and indicates
2168         whether a C program should include vfork.h.
2169
2170 ignore_versioned_solibs (libs.U):
2171         This variable should be non-empty if non-versioned shared
2172         libraries (libfoo.so.x.y) are to be ignored (because they
2173         cannot be linked against).
2174
2175 inc_version_list (inc_version_list.U):
2176         This variable specifies the list of subdirectories in over
2177         which perl.c:incpush() and lib/lib.pm will automatically
2178         search when adding directories to @INC.  The elements in
2179         the list are separated by spaces.  This is only useful
2180         if you have a perl library directory tree structured like the
2181         default one.  See INSTALL for how this works.  The versioned
2182         site_perl directory was introduced in 5.005, so that is the
2183         lowest possible value.
2184
2185 inc_version_list_init (inc_version_list.U):
2186         This variable holds the same list as inc_version_list, but
2187         each item is enclosed in double quotes and separated by commas, 
2188         suitable for use in the PERL_INC_VERSION_LIST initialization.
2189
2190 incpath (usrinc.U):
2191         This variable must preceed the normal include path to get hte
2192         right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
2193         Value can be "" or "/bsd43" on mips.
2194
2195 inews (Loc.U):
2196         This variable is defined but not used by Configure.
2197         The value is a plain '' and is not useful.
2198
2199 installarchlib (archlib.U):
2200         This variable is really the same as archlibexp but may differ on
2201         those systems using AFS. For extra portability, only this variable
2202         should be used in makefiles.
2203
2204 installbin (bin.U):
2205         This variable is the same as binexp unless AFS is running in which case
2206         the user is explicitely prompted for it. This variable should always
2207         be used in your makefiles for maximum portability.
2208
2209 installman1dir (man1dir.U):
2210         This variable is really the same as man1direxp, unless you are using
2211         AFS in which case it points to the read/write location whereas
2212         man1direxp only points to the read-only access location. For extra
2213         portability, you should only use this variable within your makefiles.
2214
2215 installman3dir (man3dir.U):
2216         This variable is really the same as man3direxp, unless you are using
2217         AFS in which case it points to the read/write location whereas
2218         man3direxp only points to the read-only access location. For extra
2219         portability, you should only use this variable within your makefiles.
2220
2221 installprefix (installprefix.U):
2222         This variable holds the name of the directory below which 
2223         "make install" will install the package.  For most users, this
2224         is the same as prefix.  However, it is useful for
2225         installing the software into a different (usually temporary)
2226         location after which it can be bundled up and moved somehow
2227         to the final location specified by prefix.
2228
2229 installprefixexp (installprefix.U):
2230         This variable holds the full absolute path of installprefix
2231         with all ~-expansion done.
2232
2233 installprivlib (privlib.U):
2234         This variable is really the same as privlibexp but may differ on
2235         those systems using AFS. For extra portability, only this variable
2236         should be used in makefiles.
2237
2238 installscript (scriptdir.U):
2239         This variable is usually the same as scriptdirexp, unless you are on
2240         a system running AFS, in which case they may differ slightly. You
2241         should always use this variable within your makefiles for portability.
2242
2243 installsitearch (sitearch.U):
2244         This variable is really the same as sitearchexp but may differ on
2245         those systems using AFS. For extra portability, only this variable
2246         should be used in makefiles.
2247
2248 installsitebin (sitebin.U):
2249         This variable is usually the same as sitebinexp, unless you are on
2250         a system running AFS, in which case they may differ slightly. You
2251         should always use this variable within your makefiles for portability.
2252
2253 installsitelib (sitelib.U):
2254         This variable is really the same as sitelibexp but may differ on
2255         those systems using AFS. For extra portability, only this variable
2256         should be used in makefiles.
2257
2258 installstyle (installstyle.U):
2259         This variable describes the "style" of the perl installation.
2260         This is intended to be useful for tools that need to
2261         manipulate entire perl distributions.  Perl itself doesn't use
2262         this to find its libraries -- the library directories are
2263         stored directly in Config.pm.  Currently, there are only two
2264         styles:  "lib" and "lib/perl5".  The default library locations
2265         (e.g. privlib, sitelib) are either $prefix/lib or
2266         $prefix/lib/perl5.  The former is useful if $prefix is a
2267         directory dedicated to perl (e.g. /opt/perl), while the latter
2268         is useful if $prefix is shared by many packages, e.g. if
2269         $prefix=/usr/local.
2270                 This may later be extended to include other information, so
2271         be careful with pattern-matching on the results.
2272                 For compatibility with perl5.005 and earlier, the default
2273         setting is based on whether or not $prefix contains the string
2274         "perl".
2275
2276 installusrbinperl (instubperl.U):
2277         This variable tells whether Perl should be installed also as
2278         /usr/bin/perl in addition to
2279         $installbin/perl
2280
2281 installvendorbin (vendorbin.U):
2282         This variable is really the same as vendorbinexp but may differ on
2283         those systems using AFS. For extra portability, only this variable
2284         should be used in makefiles.
2285
2286 installvendorlib (vendorlib.U):
2287         This variable is really the same as vendorlibexp but may differ on
2288         those systems using AFS. For extra portability, only this variable
2289         should be used in makefiles.
2290
2291 intsize (intsize.U):
2292         This variable contains the value of the INTSIZE symbol, which
2293         indicates to the C program how many bytes there are in an int.
2294
2295 ivdformat (perlxvf.U):
2296         This variable contains the format string used for printing
2297         a Perl IV as a signed decimal integer. 
2298
2299 ivsize (perlxv.U):
2300         This variable is the size of an IV in bytes.
2301
2302 ivtype (perlxv.U):
2303         This variable contains the C type used for Perl's IV.
2304
2305 known_extensions (Extensions.U):
2306         This variable holds a list of all XS extensions included in 
2307         the package.
2308
2309 ksh (Loc.U):
2310         This variable is defined but not used by Configure.
2311         The value is a plain '' and is not useful.
2312
2313 large (models.U):
2314         This variable contains a flag which will tell the C compiler and loader
2315         to produce a program running with a large memory model.  It is up to
2316         the Makefile to use this.
2317
2318 ld (dlsrc.U):
2319         This variable indicates the program to be used to link
2320         libraries for dynamic loading.  On some systems, it is 'ld'.
2321         On ELF systems, it should be $cc.  Mostly, we'll try to respect
2322         the hint file setting.
2323
2324 lddlflags (dlsrc.U):
2325         This variable contains any special flags that might need to be
2326         passed to $ld to create a shared library suitable for dynamic
2327         loading.  It is up to the makefile to use it.  For hpux, it
2328         should be '-b'.  For sunos 4.1, it is empty.
2329
2330 ldflags (ccflags.U):
2331         This variable contains any additional C loader flags desired by
2332         the user.  It is up to the Makefile to use this.
2333
2334 ldlibpthname (libperl.U):
2335         This variable holds the name of the shared library
2336         search path, often LD_LIBRARY_PATH.  To get an empty
2337         string, the hints file must set this to 'none'.
2338
2339 less (Loc.U):
2340         This variable is used internally by Configure to determine the
2341         full pathname (if any) of the less program.  After Configure runs,
2342         the value is reset to a plain "less" and is not useful.
2343
2344 lib_ext (Unix.U):
2345         This is an old synonym for _a.
2346
2347 libc (libc.U):
2348         This variable contains the location of the C library.
2349
2350 libperl (libperl.U):
2351         The perl executable is obtained by linking perlmain.c with
2352         libperl, any static extensions (usually just DynaLoader),
2353         and any other libraries needed on this system.  libperl
2354         is usually libperl.a, but can also be libperl.so.xxx if
2355         the user wishes to build a perl executable with a shared
2356         library.
2357
2358 libpth (libpth.U):
2359         This variable holds the general path (space-separated) used to find
2360         libraries. It is intended to be used by other units.
2361
2362 libs (libs.U):
2363         This variable holds the additional libraries we want to use.
2364         It is up to the Makefile to deal with it.
2365
2366 libsdirs (libs.U):
2367         This variable holds the directory names aka dirnames of the libraries
2368         we found and accepted, duplicates are removed.
2369
2370 libsfiles (libs.U):
2371         This variable holds the filenames aka basenames of the libraries
2372         we found and accepted.
2373
2374 libsfound (libs.U):
2375         This variable holds the full pathnames of the libraries
2376         we found and accepted.
2377
2378 libswanted (Myinit.U):
2379         This variable holds a list of all the libraries we want to
2380         search.  The order is chosen to pick up the c library
2381         ahead of ucb or bsd libraries for SVR4.
2382
2383 line (Loc.U):
2384         This variable is defined but not used by Configure.
2385         The value is a plain '' and is not useful.
2386
2387 lint (Loc.U):
2388         This variable is defined but not used by Configure.
2389         The value is a plain '' and is not useful.
2390
2391 lkflags (ccflags.U):
2392         This variable contains any additional C partial linker flags desired by
2393         the user.  It is up to the Makefile to use this.
2394
2395 ln (Loc.U):
2396         This variable is used internally by Configure to determine the
2397         full pathname (if any) of the ln program.  After Configure runs,
2398         the value is reset to a plain "ln" and is not useful.
2399
2400 lns (lns.U):
2401         This variable holds the name of the command to make 
2402         symbolic links (if they are supported).  It can be used
2403         in the Makefile. It is either 'ln -s' or 'ln'
2404
2405 locincpth (ccflags.U):
2406         This variable contains a list of additional directories to be
2407         searched by the compiler.  The appropriate '-I' directives will
2408         be added to ccflags.  This is intended to simplify setting
2409         local directories from the Configure command line.
2410         It's not much, but it parallels the loclibpth stuff in libpth.U.
2411
2412 loclibpth (libpth.U):
2413         This variable holds the paths (space-separated) used to find local
2414         libraries.  It is prepended to libpth, and is intended to be easily
2415         set from the command line.
2416
2417 longdblsize (d_longdbl.U):
2418         This variable contains the value of the LONG_DOUBLESIZE symbol, which
2419         indicates to the C program how many bytes there are in a long double,
2420         if this system supports long doubles.
2421
2422 longlongsize (d_longlong.U):
2423         This variable contains the value of the LONGLONGSIZE symbol, which
2424         indicates to the C program how many bytes there are in a long long,
2425         if this system supports long long.
2426
2427 longsize (intsize.U):
2428         This variable contains the value of the LONGSIZE symbol, which
2429         indicates to the C program how many bytes there are in a long.
2430
2431 lp (Loc.U):
2432         This variable is defined but not used by Configure.
2433         The value is a plain '' and is not useful.
2434
2435 lpr (Loc.U):
2436         This variable is defined but not used by Configure.
2437         The value is a plain '' and is not useful.
2438
2439 ls (Loc.U):
2440         This variable is used internally by Configure to determine the
2441         full pathname (if any) of the ls program.  After Configure runs,
2442         the value is reset to a plain "ls" and is not useful.
2443
2444 lseeksize (lseektype.U):
2445         This variable defines lseektype to be something like off_t, long, 
2446         or whatever type is used to declare lseek offset's type in the
2447         kernel (which also appears to be lseek's return type).
2448
2449 lseektype (lseektype.U):
2450         This variable defines lseektype to be something like off_t, long, 
2451         or whatever type is used to declare lseek offset's type in the
2452         kernel (which also appears to be lseek's return type).
2453
2454 mail (Loc.U):
2455         This variable is defined but not used by Configure.
2456         The value is a plain '' and is not useful.
2457
2458 mailx (Loc.U):
2459         This variable is defined but not used by Configure.
2460         The value is a plain '' and is not useful.
2461
2462 make (Loc.U):
2463         This variable is used internally by Configure to determine the
2464         full pathname (if any) of the make program.  After Configure runs,
2465         the value is reset to a plain "make" and is not useful.
2466
2467 make_set_make (make.U):
2468         Some versions of 'make' set the variable MAKE.  Others do not.
2469         This variable contains the string to be included in Makefile.SH
2470         so that MAKE is set if needed, and not if not needed.
2471         Possible values are:
2472         make_set_make='#'               # If your make program handles this for you,
2473         make_set_make="MAKE=$make"      # if it doesn't.
2474         I used a comment character so that we can distinguish a
2475         'set' value (from a previous config.sh or Configure '-D' option)
2476         from an uncomputed value.
2477
2478 mallocobj (mallocsrc.U):
2479         This variable contains the name of the malloc.o that this package
2480         generates, if that malloc.o is preferred over the system malloc.
2481         Otherwise the value is null.  This variable is intended for generating
2482         Makefiles.  See mallocsrc.
2483
2484 mallocsrc (mallocsrc.U):
2485         This variable contains the name of the malloc.c that comes with
2486         the package, if that malloc.c is preferred over the system malloc.
2487         Otherwise the value is null.  This variable is intended for generating
2488         Makefiles.
2489
2490 malloctype (mallocsrc.U):
2491         This variable contains the kind of ptr returned by malloc and realloc.
2492
2493 man1dir (man1dir.U):
2494         This variable contains the name of the directory in which manual
2495         source pages are to be put.  It is the responsibility of the
2496         Makefile.SH to get the value of this into the proper command.
2497         You must be prepared to do the ~name expansion yourself.
2498
2499 man1direxp (man1dir.U):
2500         This variable is the same as the man1dir variable, but is filename
2501         expanded at configuration time, for convenient use in makefiles.
2502
2503 man1ext (man1dir.U):
2504         This variable contains the extension that the manual page should
2505         have: one of 'n', 'l', or '1'.  The Makefile must supply the '.'.
2506         See man1dir.
2507
2508 man3dir (man3dir.U):
2509         This variable contains the name of the directory in which manual
2510         source pages are to be put.  It is the responsibility of the
2511         Makefile.SH to get the value of this into the proper command.
2512         You must be prepared to do the ~name expansion yourself.
2513
2514 man3direxp (man3dir.U):
2515         This variable is the same as the man3dir variable, but is filename
2516         expanded at configuration time, for convenient use in makefiles.
2517
2518 man3ext (man3dir.U):
2519         This variable contains the extension that the manual page should
2520         have: one of 'n', 'l', or '3'.  The Makefile must supply the '.'.
2521         See man3dir.
2522
2523 Mcc (Loc.U):
2524         This variable is used internally by Configure to determine the
2525         full pathname (if any) of the Mcc program.  After Configure runs,
2526         the value is reset to a plain "Mcc" and is not useful.
2527
2528 medium (models.U):
2529         This variable contains a flag which will tell the C compiler and loader
2530         to produce a program running with a medium memory model.  If the
2531         medium model is not supported, contains the flag to produce large
2532         model programs.  It is up to the Makefile to use this.
2533
2534 mips_type (usrinc.U):
2535         This variable holds the environment type for the mips system.
2536         Possible values are "BSD 4.3" and "System V".
2537
2538 mkdir (Loc.U):
2539         This variable is used internally by Configure to determine the
2540         full pathname (if any) of the mkdir program.  After Configure runs,
2541         the value is reset to a plain "mkdir" and is not useful.
2542
2543 mmaptype (d_mmap.U):
2544         This symbol contains the type of pointer returned by mmap()
2545         (and simultaneously the type of the first argument).
2546         It can be 'void *' or 'caddr_t'.
2547
2548 models (models.U):
2549         This variable contains the list of memory models supported by this
2550         system.  Possible component values are none, split, unsplit, small,
2551         medium, large, and huge.  The component values are space separated.
2552
2553 modetype (modetype.U):
2554         This variable defines modetype to be something like mode_t, 
2555         int, unsigned short, or whatever type is used to declare file 
2556         modes for system calls.
2557
2558 more (Loc.U):
2559         This variable is used internally by Configure to determine the
2560         full pathname (if any) of the more program.  After Configure runs,
2561         the value is reset to a plain "more" and is not useful.
2562
2563 multiarch (multiarch.U):
2564         This variable conditionally defines the MULTIARCH symbol
2565         which signifies the presence of multiplatform files.
2566         This is normally set by hints files.
2567
2568 mv (Loc.U):
2569         This variable is defined but not used by Configure.
2570         The value is a plain '' and is not useful.
2571
2572 myarchname (archname.U):
2573         This variable holds the architecture name computed by Configure in
2574         a previous run. It is not intended to be perused by any user and
2575         should never be set in a hint file.
2576
2577 mydomain (myhostname.U):
2578         This variable contains the eventual value of the MYDOMAIN symbol,
2579         which is the domain of the host the program is going to run on.
2580         The domain must be appended to myhostname to form a complete host name.
2581         The dot comes with mydomain, and need not be supplied by the program.
2582
2583 myhostname (myhostname.U):
2584         This variable contains the eventual value of the MYHOSTNAME symbol,
2585         which is the name of the host the program is going to run on.
2586         The domain is not kept with hostname, but must be gotten from mydomain.
2587         The dot comes with mydomain, and need not be supplied by the program.
2588
2589 myuname (Oldconfig.U):
2590         The output of 'uname -a' if available, otherwise the hostname. On Xenix,
2591         pseudo variables assignments in the output are stripped, thank you. The
2592         whole thing is then lower-cased.
2593
2594 n (n.U):
2595         This variable contains the '-n' flag if that is what causes the echo
2596         command to suppress newline.  Otherwise it is null.  Correct usage is
2597         $echo $n "prompt for a question: $c".
2598
2599 netdb_hlen_type (netdbtype.U):
2600         This variable holds the type used for the 2nd argument to
2601         gethostbyaddr().  Usually, this is int or size_t or unsigned.
2602         This is only useful if you have gethostbyaddr(), naturally.
2603
2604 netdb_host_type (netdbtype.U):
2605         This variable holds the type used for the 1st argument to
2606         gethostbyaddr().  Usually, this is char * or void *,  possibly
2607         with or without a const prefix.
2608         This is only useful if you have gethostbyaddr(), naturally.
2609
2610 netdb_name_type (netdbtype.U):
2611         This variable holds the type used for the argument to
2612         gethostbyname().  Usually, this is char * or const char *.
2613         This is only useful if you have gethostbyname(), naturally.
2614
2615 netdb_net_type (netdbtype.U):
2616         This variable holds the type used for the 1st argument to
2617         getnetbyaddr().  Usually, this is int or long.
2618         This is only useful if you have getnetbyaddr(), naturally.
2619
2620 nm (Loc.U):
2621         This variable is used internally by Configure to determine the
2622         full pathname (if any) of the nm program.  After Configure runs,
2623         the value is reset to a plain "nm" and is not useful.
2624
2625 nm_opt (usenm.U):
2626         This variable holds the options that may be necessary for nm.
2627
2628 nm_so_opt (usenm.U):
2629         This variable holds the options that may be necessary for nm
2630         to work on a shared library but that can not be used on an
2631         archive library.  Currently, this is only used by Linux, where
2632         nm --dynamic is *required* to get symbols from an ELF library which
2633         has been stripped, but nm --dynamic is *fatal* on an archive library.
2634         Maybe Linux should just always set usenm=false.
2635
2636 nonxs_ext (Extensions.U):
2637         This variable holds a list of all non-xs extensions included
2638         in the package.  All of them will be built.
2639
2640 nroff (Loc.U):
2641         This variable is used internally by Configure to determine the
2642         full pathname (if any) of the nroff program.  After Configure runs,
2643         the value is reset to a plain "nroff" and is not useful.
2644
2645 nvsize (perlxv.U):
2646         This variable is the size of an NV in bytes.
2647
2648 nvtype (perlxv.U):
2649         This variable contains the C type used for Perl's NV.
2650
2651 o_nonblock (nblock_io.U):
2652         This variable bears the symbol value to be used during open() or fcntl()
2653         to turn on non-blocking I/O for a file descriptor. If you wish to switch
2654         between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
2655         but that is only supported by some devices.
2656
2657 obj_ext (Unix.U):
2658         This is an old synonym for _o.
2659
2660 old_pthread_create_joinable (d_pthrattrj.U):
2661         This variable defines the constant to use for creating joinable
2662         (aka undetached) pthreads.  Unused if pthread.h defines
2663         PTHREAD_CREATE_JOINABLE.  If used, possible values are
2664         PTHREAD_CREATE_UNDETACHED and __UNDETACHED.
2665
2666 optimize (ccflags.U):
2667         This variable contains any optimizer/debugger flag that should be used.
2668         It is up to the Makefile to use it.
2669
2670 orderlib (orderlib.U):
2671         This variable is "true" if the components of libraries must be ordered
2672         (with `lorder $* | tsort`) before placing them in an archive.  Set to
2673         "false" if ranlib or ar can generate random libraries.
2674
2675 osname (Oldconfig.U):
2676         This variable contains the operating system name (e.g. sunos,
2677         solaris, hpux, etc.).  It can be useful later on for setting
2678         defaults.  Any spaces are replaced with underscores.  It is set
2679         to a null string if we can't figure it out.
2680
2681 osvers (Oldconfig.U):
2682         This variable contains the operating system version (e.g.
2683         4.1.3, 5.2, etc.).  It is primarily used for helping select
2684         an appropriate hints file, but might be useful elsewhere for
2685         setting defaults.  It is set to '' if we can't figure it out.
2686         We try to be flexible about how much of the version number
2687         to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
2688         same for this package, hints files might just be os_4.0 or
2689         os_4.1, etc., not keeping separate files for each little release.
2690
2691 package (package.U):
2692         This variable contains the name of the package being constructed.
2693         It is primarily intended for the use of later Configure units.
2694
2695 pager (pager.U):
2696         This variable contains the name of the preferred pager on the system.
2697         Usual values are (the full pathnames of) more, less, pg, or cat.
2698
2699 passcat (nis.U):
2700         This variable contains a command that produces the text of the
2701         /etc/passwd file.  This is normally "cat /etc/passwd", but can be
2702         "ypcat passwd" when NIS is used.
2703         On some systems, such as os390, there may be no equivalent
2704         command, in which case this variable is unset.
2705
2706 patchlevel (patchlevel.U):
2707         The patchlevel level of this package.
2708         The value of patchlevel comes from the patchlevel.h file.
2709         In a version number such as 5.6.1, this is the "6".
2710         In patchlevel.h, this is referred to as the "PERL_VERSION".
2711
2712 path_sep (Unix.U):
2713         This is an old synonym for p_ in Head.U, the character
2714         used to separate elements in the command shell search PATH.
2715
2716 perl (Loc.U):
2717         This variable is used internally by Configure to determine the
2718         full pathname (if any) of the perl program.  After Configure runs,
2719         the value is reset to a plain "perl" and is not useful.
2720
2721 PERL_REVISION (Oldsyms.U):
2722         In a Perl version number such as 5.6.2, this is the 5.
2723         This value is manually set in patchlevel.h
2724
2725 PERL_SUBVERSION (Oldsyms.U):
2726         In a Perl version number such as 5.6.2, this is the 2.
2727         Values greater than 50 represent potentially unstable
2728         development subversions.
2729         This value is manually set in patchlevel.h
2730
2731 PERL_VERSION (Oldsyms.U):
2732         In a Perl version number such as 5.6.2, this is the 6.
2733         This value is manually set in patchlevel.h
2734
2735 perladmin (perladmin.U):
2736         Electronic mail address of the perl5 administrator.
2737
2738 perlpath (perlpath.U):
2739         This variable contains the eventual value of the PERLPATH symbol,
2740         which contains the name of the perl interpreter to be used in
2741         shell scripts and in the "eval 'exec'" idiom.
2742
2743 pg (Loc.U):
2744         This variable is used internally by Configure to determine the
2745         full pathname (if any) of the pg program.  After Configure runs,
2746         the value is reset to a plain "pg" and is not useful.
2747
2748 phostname (myhostname.U):
2749         This variable contains the eventual value of the PHOSTNAME symbol,
2750         which is a command that can be fed to popen() to get the host name.
2751         The program should probably not presume that the domain is or isn't
2752         there already.
2753
2754 pidtype (pidtype.U):
2755         This variable defines PIDTYPE to be something like pid_t, int, 
2756         ushort, or whatever type is used to declare process ids in the kernel.
2757
2758 plibpth (libpth.U):
2759         Holds the private path used by Configure to find out the libraries.
2760         Its value is prepend to libpth. This variable takes care of special
2761         machines, like the mips.  Usually, it should be empty.
2762
2763 pm_apiversion (xs_apiversion.U):
2764         This variable contains the version of the oldest perl
2765         compatible with the present perl.  (That is, pure perl modules
2766         written for $pm_apiversion will still work for the current
2767         version).  perl.c:incpush() and lib/lib.pm will automatically
2768         search in $sitelib for older directories across major versions
2769         back to pm_apiversion.  This is only useful if you have a perl
2770         library directory tree structured like the default one.  The
2771         versioned site_perl library was introduced in 5.005, so that's
2772         the default setting for this variable.  It's hard to imagine
2773         it changing before Perl6.  It is included here for symmetry
2774         with xs_apiveprsion -- the searching algorithms will
2775         (presumably) be similar.
2776         See the INSTALL file for how this works.
2777
2778 pmake (Loc.U):
2779         This variable is defined but not used by Configure.
2780         The value is a plain '' and is not useful.
2781
2782 pr (Loc.U):
2783         This variable is defined but not used by Configure.
2784         The value is a plain '' and is not useful.
2785
2786 prefix (prefix.U):
2787         This variable holds the name of the directory below which the
2788         user will install the package.  Usually, this is /usr/local, and
2789         executables go in /usr/local/bin, library stuff in /usr/local/lib,
2790         man pages in /usr/local/man, etc.  It is only used to set defaults
2791         for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
2792
2793 prefixexp (prefix.U):
2794         This variable holds the full absolute path of the directory below
2795         which the user will install the package.  Derived from prefix.
2796
2797 privlib (privlib.U):
2798         This variable contains the eventual value of the PRIVLIB symbol,
2799         which is the name of the private library for this package.  It may
2800         have a ~ on the front. It is up to the makefile to eventually create
2801         this directory while performing installation (with ~ substitution).
2802
2803 privlibexp (privlib.U):
2804         This variable is the ~name expanded version of privlib, so that you
2805         may use it directly in Makefiles or shell scripts.
2806
2807 prototype (prototype.U):
2808         This variable holds the eventual value of CAN_PROTOTYPE, which
2809         indicates the C compiler can handle funciton prototypes.
2810
2811 ptrsize (ptrsize.U):
2812         This variable contains the value of the PTRSIZE symbol, which
2813         indicates to the C program how many bytes there are in a pointer.
2814
2815 quadkind (quadtype.U):
2816         This variable, if defined, encodes the type of a quad:
2817         1 = int, 2 = long, 3 = long long, 4 = int64_t.
2818
2819 quadtype (quadtype.U):
2820         This variable defines Quad_t to be something like long, int, 
2821         long long, int64_t, or whatever type is used for 64-bit integers.
2822
2823 randbits (randfunc.U):
2824         Indicates how many bits are produced by the function used to
2825         generate normalized random numbers.
2826
2827 randfunc (randfunc.U):
2828         Indicates the name of the random number function to use.
2829         Values include drand48, random, and rand. In C programs,
2830         the 'Drand01' macro is defined to generate uniformly distributed
2831         random numbers over the range [0., 1.[ (see drand01 and nrand).
2832
2833 randseedtype (randfunc.U):
2834         Indicates the type of the argument of the seedfunc.
2835
2836 ranlib (orderlib.U):
2837         This variable is set to the pathname of the ranlib program, if it is
2838         needed to generate random libraries.  Set to ":" if ar can generate
2839         random libraries or if random libraries are not supported
2840
2841 rd_nodata (nblock_io.U):
2842         This variable holds the return code from read() when no data is
2843         present. It should be -1, but some systems return 0 when O_NDELAY is
2844         used, which is a shame because you cannot make the difference between
2845         no data and an EOF.. Sigh!
2846
2847 rm (Loc.U):
2848         This variable is used internally by Configure to determine the
2849         full pathname (if any) of the rm program.  After Configure runs,
2850         the value is reset to a plain "rm" and is not useful.
2851
2852 rmail (Loc.U):
2853         This variable is defined but not used by Configure.
2854         The value is a plain '' and is not useful.
2855
2856 runnm (usenm.U):
2857         This variable contains 'true' or 'false' depending whether the
2858         nm extraction should be performed or not, according to the value
2859         of usenm and the flags on the Configure command line.
2860
2861 sched_yield (d_pthread_y.U):
2862         This variable defines the way to yield the execution
2863         of the current thread.
2864
2865 scriptdir (scriptdir.U):
2866         This variable holds the name of the directory in which the user wants
2867         to put publicly scripts for the package in question.  It is either
2868         the same directory as for binaries, or a special one that can be
2869         mounted across different architectures, like /usr/share. Programs
2870         must be prepared to deal with ~name expansion.
2871
2872 scriptdirexp (scriptdir.U):
2873         This variable is the same as scriptdir, but is filename expanded
2874         at configuration time, for programs not wanting to bother with it.
2875
2876 sed (Loc.U):
2877         This variable is used internally by Configure to determine the
2878         full pathname (if any) of the sed program.  After Configure runs,
2879         the value is reset to a plain "sed" and is not useful.
2880
2881 seedfunc (randfunc.U):
2882         Indicates the random number generating seed function.
2883         Values include srand48, srandom, and srand.
2884
2885 selectminbits (selectminbits.U):
2886         This variable holds the minimum number of bits operated by select.
2887         That is, if you do select(n, ...), how many bits at least will be
2888         cleared in the masks if some activity is detected.  Usually this
2889         is either n or 32*ceil(n/32), especially many little-endians do
2890         the latter.  This is only useful if you have select(), naturally.
2891
2892 selecttype (selecttype.U):
2893         This variable holds the type used for the 2nd, 3rd, and 4th
2894         arguments to select.  Usually, this is 'fd_set *', if HAS_FD_SET
2895         is defined, and 'int *' otherwise.  This is only useful if you 
2896         have select(), naturally.
2897
2898 sendmail (Loc.U):
2899         This variable is defined but not used by Configure.
2900         The value is a plain '' and is not useful.
2901
2902 sh (sh.U):
2903         This variable contains the full pathname of the shell used
2904         on this system to execute Bourne shell scripts.  Usually, this will be
2905         /bin/sh, though it's possible that some systems will have /bin/ksh,
2906         /bin/pdksh, /bin/ash, /bin/bash, or even something such as
2907         D:/bin/sh.exe.
2908         This unit comes before Options.U, so you can't set sh with a '-D'
2909         option, though you can override this (and startsh)
2910         with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
2911
2912 shar (Loc.U):
2913         This variable is defined but not used by Configure.
2914         The value is a plain '' and is not useful.
2915
2916 sharpbang (spitshell.U):
2917         This variable contains the string #! if this system supports that
2918         construct.
2919
2920 shmattype (d_shmat.U):
2921         This symbol contains the type of pointer returned by shmat().
2922         It can be 'void *' or 'char *'.
2923
2924 shortsize (intsize.U):
2925         This variable contains the value of the SHORTSIZE symbol which
2926         indicates to the C program how many bytes there are in a short.
2927
2928 shrpenv (libperl.U):
2929         If the user builds a shared libperl.so, then we need to tell the
2930         'perl' executable where it will be able to find the installed libperl.so. 
2931         One way to do this on some systems is to set the environment variable
2932         LD_RUN_PATH to the directory that will be the final location of the
2933         shared libperl.so.  The makefile can use this with something like
2934         $shrpenv $(CC) -o perl perlmain.o $libperl $libs
2935         Typical values are
2936         shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
2937         or
2938         shrpenv=''
2939         See the main perl Makefile.SH for actual working usage.
2940         Alternatively, we might be able to use a command line option such
2941         as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
2942         $archlibexp/CORE (Linux).
2943
2944 shsharp (spitshell.U):
2945         This variable tells further Configure units whether your sh can
2946         handle # comments.
2947
2948 sig_count (sig_name.U):
2949         This variable holds a number larger than the largest valid
2950         signal number.  This is usually the same as the NSIG macro.
2951
2952 sig_name (sig_name.U):
2953         This variable holds the signal names, space separated. The leading
2954         SIG in signal name is removed.  A ZERO is prepended to the
2955         list.  This is currently not used.
2956
2957 sig_name_init (sig_name.U):
2958         This variable holds the signal names, enclosed in double quotes and
2959         separated by commas, suitable for use in the SIG_NAME definition 
2960         below.  A "ZERO" is prepended to the list, and the list is 
2961         terminated with a plain 0.  The leading SIG in signal names
2962         is removed. See sig_num.
2963
2964 sig_num (sig_name.U):
2965         This variable holds the signal numbers, space separated. A ZERO is
2966         prepended to the list (corresponding to the fake SIGZERO), and 
2967         the list is terminated with a 0.  Those numbers correspond to 
2968         the value of the signal listed in the same place within the
2969         sig_name list.
2970
2971 sig_num_init (sig_name.U):
2972         This variable holds the signal numbers, enclosed in double quotes and
2973         separated by commas, suitable for use in the SIG_NUM definition 
2974         below.  A "ZERO" is prepended to the list, and the list is 
2975         terminated with a plain 0.
2976
2977 signal_t (d_voidsig.U):
2978         This variable holds the type of the signal handler (void or int).
2979
2980 sitearch (sitearch.U):
2981         This variable contains the eventual value of the SITEARCH symbol,
2982         which is the name of the private library for this package.  It may
2983         have a ~ on the front. It is up to the makefile to eventually create
2984         this directory while performing installation (with ~ substitution).
2985         The standard distribution will put nothing in this directory.
2986         After perl has been installed, users may install their own local
2987         architecture-dependent modules in this directory with
2988         MakeMaker Makefile.PL
2989         or equivalent.  See INSTALL for details.
2990
2991 sitearchexp (sitearch.U):
2992         This variable is the ~name expanded version of sitearch, so that you
2993         may use it directly in Makefiles or shell scripts.
2994
2995 sitebin (sitebin.U):
2996         This variable holds the name of the directory in which the user wants
2997         to put add-on publicly executable files for the package in question.  It
2998         is most often a local directory such as /usr/local/bin. Programs using
2999         this variable must be prepared to deal with ~name substitution.
3000         The standard distribution will put nothing in this directory.
3001         After perl has been installed, users may install their own local
3002         executables in this directory with
3003         MakeMaker Makefile.PL
3004         or equivalent.  See INSTALL for details.
3005
3006 sitebinexp (sitebin.U):
3007         This is the same as the sitebin variable, but is filename expanded at
3008         configuration time, for use in your makefiles.
3009
3010 sitelib (sitelib.U):
3011         This variable contains the eventual value of the SITELIB symbol,
3012         which is the name of the private library for this package.  It may
3013         have a ~ on the front. It is up to the makefile to eventually create
3014         this directory while performing installation (with ~ substitution).
3015         The standard distribution will put nothing in this directory.
3016         After perl has been installed, users may install their own local
3017         architecture-independent modules in this directory with
3018         MakeMaker Makefile.PL
3019         or equivalent.  See INSTALL for details.
3020
3021 sitelibexp (sitelib.U):
3022         This variable is the ~name expanded version of sitelib, so that you
3023         may use it directly in Makefiles or shell scripts.
3024
3025 siteprefix (siteprefix.U):
3026         This variable holds the full absolute path of the directory below
3027         which the user will install add-on packages.
3028         See INSTALL for usage and examples.
3029
3030 siteprefixexp (siteprefix.U):
3031         This variable holds the full absolute path of the directory below
3032         which the user will install add-on packages.  Derived from siteprefix.
3033
3034 sizetype (sizetype.U):
3035         This variable defines sizetype to be something like size_t, 
3036         unsigned long, or whatever type is used to declare length 
3037         parameters for string functions.
3038
3039 sleep (Loc.U):
3040         This variable is defined but not used by Configure.
3041         The value is a plain '' and is not useful.
3042
3043 smail (Loc.U):
3044         This variable is defined but not used by Configure.
3045         The value is a plain '' and is not useful.
3046
3047 small (models.U):
3048         This variable contains a flag which will tell the C compiler and loader
3049         to produce a program running with a small memory model.  It is up to
3050         the Makefile to use this.
3051
3052 so (so.U):
3053         This variable holds the extension used to identify shared libraries
3054         (also known as shared objects) on the system. Usually set to 'so'.
3055
3056 sockethdr (d_socket.U):
3057         This variable has any cpp '-I' flags needed for socket support.
3058
3059 socketlib (d_socket.U):
3060         This variable has the names of any libraries needed for socket support.
3061
3062 sort (Loc.U):
3063         This variable is used internally by Configure to determine the
3064         full pathname (if any) of the sort program.  After Configure runs,
3065         the value is reset to a plain "sort" and is not useful.
3066
3067 spackage (package.U):
3068         This variable contains the name of the package being constructed,
3069         with the first letter uppercased, i.e. suitable for starting
3070         sentences.
3071
3072 spitshell (spitshell.U):
3073         This variable contains the command necessary to spit out a runnable
3074         shell on this system.  It is either cat or a grep '-v' for # comments.
3075
3076 split (models.U):
3077         This variable contains a flag which will tell the C compiler and loader
3078         to produce a program that will run in separate I and D space, for those
3079         machines that support separation of instruction and data space.  It is
3080         up to the Makefile to use this.
3081
3082 sPRId64 (quadfio.U):
3083         This variable, if defined, contains the string used by stdio to
3084         format 64-bit decimal numbers (format 'd') for output.
3085
3086 sPRIeldbl (longdblfio.U):
3087         This variable, if defined, contains the string used by stdio to
3088         format long doubles (format 'e') for output.
3089
3090 sPRIEldbl (longdblfio.U):
3091         This variable, if defined, contains the string used by stdio to
3092         format long doubles (format 'E') for output.
3093
3094 sPRIfldbl (longdblfio.U):
3095         This variable, if defined, contains the string used by stdio to
3096         format long doubles (format 'f') for output.
3097
3098 sPRIFldbl (longdblfio.U):
3099         This variable, if defined, contains the string used by stdio to
3100         format long doubles (format 'F') for output.
3101
3102 sPRIgldbl (longdblfio.U):
3103         This variable, if defined, contains the string used by stdio to
3104         format long doubles (format 'g') for output.
3105
3106 sPRIGldbl (longdblfio.U):
3107         This variable, if defined, contains the string used by stdio to
3108         format long doubles (format 'G') for output.
3109
3110 sPRIi64 (quadfio.U):
3111         This variable, if defined, contains the string used by stdio to
3112         format 64-bit decimal numbers (format 'i') for output.
3113
3114 sPRIo64 (quadfio.U):
3115         This variable, if defined, contains the string used by stdio to
3116         format 64-bit octal numbers (format 'o') for output.
3117
3118 sPRIu64 (quadfio.U):
3119         This variable, if defined, contains the string used by stdio to
3120         format 64-bit unsigned decimal numbers (format 'u') for output.
3121
3122 sPRIx64 (quadfio.U):
3123         This variable, if defined, contains the string used by stdio to
3124         format 64-bit hexadecimal numbers (format 'x') for output.
3125
3126 sPRIX64 (quadfio.U):
3127         This variable, if defined, contains the string used by stdio to
3128         format 64-bit hExADECimAl numbers (format 'X') for output.
3129
3130 src (src.U):
3131         This variable holds the path to the package source. It is up to
3132         the Makefile to use this variable and set VPATH accordingly to
3133         find the sources remotely.
3134
3135 ssizetype (ssizetype.U):
3136         This variable defines ssizetype to be something like ssize_t, 
3137         long or int.  It is used by functions that return a count 
3138         of bytes or an error condition.  It must be a signed type.
3139         We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
3140
3141 startperl (startperl.U):
3142         This variable contains the string to put on the front of a perl
3143         script to make sure (hopefully) that it runs with perl and not some
3144         shell. Of course, that leading line must be followed by the classical
3145         perl idiom:
3146         eval 'exec perl -S $0 ${1+"$@"}'
3147         if $running_under_some_shell;
3148         to guarantee perl startup should the shell execute the script. Note
3149         that this magic incatation is not understood by csh.
3150
3151 startsh (startsh.U):
3152         This variable contains the string to put on the front of a shell
3153         script to make sure (hopefully) that it runs with sh and not some
3154         other shell.
3155
3156 static_ext (Extensions.U):
3157         This variable holds a list of XS extension files we want to
3158         link statically into the package.  It is used by Makefile.
3159
3160 stdchar (stdchar.U):
3161         This variable conditionally defines STDCHAR to be the type of char
3162         used in stdio.h.  It has the values "unsigned char" or "char".
3163
3164 stdio_base (d_stdstdio.U):
3165         This variable defines how, given a FILE pointer, fp, to access the
3166         _base field (or equivalent) of stdio.h's FILE structure.  This will
3167         be used to define the macro FILE_base(fp).
3168
3169 stdio_bufsiz (d_stdstdio.U):
3170         This variable defines how, given a FILE pointer, fp, to determine
3171         the number of bytes store in the I/O buffer pointer to by the
3172         _base field (or equivalent) of stdio.h's FILE structure.  This will
3173         be used to define the macro FILE_bufsiz(fp).
3174
3175 stdio_cnt (d_stdstdio.U):
3176         This variable defines how, given a FILE pointer, fp, to access the
3177         _cnt field (or equivalent) of stdio.h's FILE structure.  This will
3178         be used to define the macro FILE_cnt(fp).
3179
3180 stdio_filbuf (d_stdstdio.U):
3181         This variable defines how, given a FILE pointer, fp, to tell
3182         stdio to refill it's internal buffers (?).  This will
3183         be used to define the macro FILE_filbuf(fp).
3184
3185 stdio_ptr (d_stdstdio.U):
3186         This variable defines how, given a FILE pointer, fp, to access the
3187         _ptr field (or equivalent) of stdio.h's FILE structure.  This will
3188         be used to define the macro FILE_ptr(fp).
3189
3190 stdio_stream_array (stdio_streams.U):
3191         This variable tells the name of the array holding the stdio streams.
3192         Usual values include _iob, __iob, and __sF.
3193
3194 strings (i_string.U):
3195         This variable holds the full path of the string header that will be
3196         used. Typically /usr/include/string.h or /usr/include/strings.h.
3197
3198 submit (Loc.U):
3199         This variable is defined but not used by Configure.
3200         The value is a plain '' and is not useful.
3201
3202 subversion (patchlevel.U):
3203         The subversion level of this package.
3204         The value of subversion comes from the patchlevel.h file.
3205         In a version number such as 5.6.1, this is the "1".
3206         This is unique to perl.
3207
3208 sysman (sysman.U):
3209         This variable holds the place where the manual is located on this
3210         system. It is not the place where the user wants to put his manual
3211         pages. Rather it is the place where Configure may look to find manual
3212         for unix commands (section 1 of the manual usually). See mansrc.
3213
3214 tail (Loc.U):
3215         This variable is defined but not used by Configure.
3216         The value is a plain '' and is not useful.
3217
3218 tar (Loc.U):
3219         This variable is defined but not used by Configure.
3220         The value is a plain '' and is not useful.
3221
3222 tbl (Loc.U):
3223         This variable is defined but not used by Configure.
3224         The value is a plain '' and is not useful.
3225
3226 tee (Loc.U):
3227         This variable is defined but not used by Configure.
3228         The value is a plain '' and is not useful.
3229
3230 test (Loc.U):
3231         This variable is used internally by Configure to determine the
3232         full pathname (if any) of the test program.  After Configure runs,
3233         the value is reset to a plain "test" and is not useful.
3234
3235 timeincl (i_time.U):
3236         This variable holds the full path of the included time header(s).
3237
3238 timetype (d_time.U):
3239         This variable holds the type returned by time(). It can be long,
3240         or time_t on BSD sites (in which case <sys/types.h> should be
3241         included). Anyway, the type Time_t should be used.
3242
3243 touch (Loc.U):
3244         This variable is used internally by Configure to determine the
3245         full pathname (if any) of the touch program.  After Configure runs,
3246         the value is reset to a plain "touch" and is not useful.
3247
3248 tr (Loc.U):
3249         This variable is used internally by Configure to determine the
3250         full pathname (if any) of the tr program.  After Configure runs,
3251         the value is reset to a plain "tr" and is not useful.
3252
3253 trnl (trnl.U):
3254         This variable contains the value to be passed to the tr(1)
3255         command to transliterate a newline.  Typical values are
3256         '\012' and '\n'.  This is needed for EBCDIC systems where
3257         newline is not necessarily '\012'.
3258
3259 troff (Loc.U):
3260         This variable is defined but not used by Configure.
3261         The value is a plain '' and is not useful.
3262
3263 u16size (perlxv.U):
3264         This variable is the size of an U16 in bytes.
3265
3266 u16type (perlxv.U):
3267         This variable contains the C type used for Perl's U16.
3268
3269 u32size (perlxv.U):
3270         This variable is the size of an U32 in bytes.
3271
3272 u32type (perlxv.U):
3273         This variable contains the C type used for Perl's U32.
3274
3275 u64size (perlxv.U):
3276         This variable is the size of an U64 in bytes.
3277
3278 u64type (perlxv.U):
3279         This variable contains the C type used for Perl's U64.
3280
3281 u8size (perlxv.U):
3282         This variable is the size of an U8 in bytes.
3283
3284 u8type (perlxv.U):
3285         This variable contains the C type used for Perl's U8.
3286
3287 uidformat (uidf.U):
3288         This variable contains the format string used for printing a Uid_t.
3289
3290 uidsign (uidsign.U):
3291         This variable contains the signedness of a uidtype.
3292         1 for unsigned, -1 for signed.
3293
3294 uidsize (uidsize.U):
3295         This variable contains the size of a uidtype in bytes.
3296
3297 uidtype (uidtype.U):
3298         This variable defines Uid_t to be something like uid_t, int, 
3299         ushort, or whatever type is used to declare user ids in the kernel.
3300
3301 uname (Loc.U):
3302         This variable is used internally by Configure to determine the
3303         full pathname (if any) of the uname program.  After Configure runs,
3304         the value is reset to a plain "uname" and is not useful.
3305
3306 uniq (Loc.U):
3307         This variable is used internally by Configure to determine the
3308         full pathname (if any) of the uniq program.  After Configure runs,
3309         the value is reset to a plain "uniq" and is not useful.
3310
3311 uquadtype (quadtype.U):
3312         This variable defines Uquad_t to be something like unsigned long,
3313         unsigned int, unsigned long long, uint64_t, or whatever type is
3314         used for 64-bit integers.
3315
3316 use5005threads (usethreads.U):
3317         This variable conditionally defines the USE_5005THREADS symbol,
3318         and indicates that Perl should be built to use the 5.005-based
3319         threading implementation.
3320
3321 use64bits (use64bits.U):
3322         This variable conditionally defines the USE_64_BITS symbol,
3323         and indicates that 64-bit integer types should be used
3324         when available.
3325
3326 usedl (dlsrc.U):
3327         This variable indicates if the system supports dynamic
3328         loading of some sort.  See also dlsrc and dlobj.
3329
3330 useithreads (usethreads.U):
3331         This variable conditionally defines the USE_ITHREADS symbol,
3332         and indicates that Perl should be built to use the interpreter-based
3333         threading implementation.
3334
3335 uselargefiles (uselfs.U):
3336         This variable conditionally defines the USE_LARGE_FILES symbol,
3337         and indicates that large file interfaces should be used when
3338         available.  The use64bits symbol will also be turned on if necessary.
3339
3340 uselongdouble (uselongdbl.U):
3341         This variable conditionally defines the USE_LONG_DOUBLE symbol,
3342         and indicates that long doubles should be used when available.
3343
3344 usemorebits (usemorebits.U):
3345         This variable conditionally defines the USE_MORE_BITS symbol,
3346         and indicates that explicit 64-bit interfaces and long doubles
3347         should be used when available.
3348
3349 usemultiplicity (usemultiplicity.U):
3350         This variable conditionally defines the MULTIPLICITY symbol,
3351         and indicates that Perl should be built to use multiplicity.
3352
3353 usemymalloc (mallocsrc.U):
3354         This variable contains y if the malloc that comes with this package
3355         is desired over the system's version of malloc.  People often include
3356         special versions of malloc for effiency, but such versions are often
3357         less portable.  See also mallocsrc and mallocobj.
3358         If this is 'y', then -lmalloc is removed from $libs.
3359
3360 usenm (usenm.U):
3361         This variable contains 'true' or 'false' depending whether the
3362         nm extraction is wanted or not.
3363
3364 useopcode (Extensions.U):
3365         This variable holds either 'true' or 'false' to indicate
3366         whether the Opcode extension should be used.  The sole
3367         use for this currently is to allow an easy mechanism
3368         for users to skip the Opcode extension from the Configure
3369         command line.
3370
3371 useperlio (useperlio.U):
3372         This variable conditionally defines the USE_PERLIO symbol,
3373         and indicates that the PerlIO abstraction should be
3374         used throughout.
3375
3376 useposix (Extensions.U):
3377         This variable holds either 'true' or 'false' to indicate
3378         whether the POSIX extension should be used.  The sole
3379         use for this currently is to allow an easy mechanism
3380         for hints files to indicate that POSIX will not compile
3381         on a particular system.
3382
3383 usesfio (d_sfio.U):
3384         This variable is set to true when the user agrees to use sfio.
3385         It is set to false when sfio is not available or when the user
3386         explicitely requests not to use sfio.  It is here primarily so
3387         that command-line settings can override the auto-detection of
3388         d_sfio without running into a "WHOA THERE".
3389
3390 useshrplib (libperl.U):
3391         This variable is set to 'yes' if the user wishes
3392         to build a shared libperl, and 'no' otherwise.
3393
3394 usesocks (usesocks.U):
3395         This variable conditionally defines the USE_SOCKS symbol,
3396         and indicates that Perl should be built to use SOCKS.
3397
3398 usethreads (usethreads.U):
3399         This variable conditionally defines the USE_THREADS symbol,
3400         and indicates that Perl should be built to use threads.
3401
3402 usevendorprefix (vendorprefix.U):
3403         This variable tells whether the vendorprefix
3404         and consequently other vendor* paths are in use.
3405
3406 usevfork (d_vfork.U):
3407         This variable is set to true when the user accepts to use vfork.
3408         It is set to false when no vfork is available or when the user
3409         explicitely requests not to use vfork.
3410
3411 usrinc (usrinc.U):
3412         This variable holds the path of the include files, which is
3413         usually /usr/include. It is mainly used by other Configure units.
3414
3415 uuname (Loc.U):
3416         This variable is defined but not used by Configure.
3417         The value is a plain '' and is not useful.
3418
3419 uvoformat (perlxvf.U):
3420         This variable contains the format string used for printing
3421         a Perl UV as an unsigned octal integer. 
3422
3423 uvsize (perlxv.U):
3424         This variable is the size of a UV in bytes.
3425
3426 uvtype (perlxv.U):
3427         This variable contains the C type used for Perl's UV.
3428
3429 uvuformat (perlxvf.U):
3430         This variable contains the format string used for printing
3431         a Perl UV as an unsigned decimal integer. 
3432
3433 uvxformat (perlxvf.U):
3434         This variable contains the format string used for printing
3435         a Perl UV as an unsigned hexadecimal integer. 
3436
3437 vendorbin (vendorbin.U):
3438         This variable contains the eventual value of the VENDORBIN symbol.
3439         It may have a ~ on the front.
3440         The standard distribution will put nothing in this directory.
3441         Vendors who distribute perl may wish to place additional
3442         binaries in this directory with
3443         MakeMaker Makefile.PL INSTALLDIRS=vendor 
3444         or equivalent.  See INSTALL for details.
3445
3446 vendorbinexp (vendorbin.U):
3447         This variable is the ~name expanded version of vendorbin, so that you
3448         may use it directly in Makefiles or shell scripts.
3449
3450 vendorlib (vendorlib.U):
3451         This variable contains the eventual value of the VENDORLIB symbol,
3452         which is the name of the private library for this package.
3453         The standard distribution will put nothing in this directory.
3454         Vendors who distribute perl may wish to place their own
3455         modules in this directory with
3456         MakeMaker Makefile.PL INSTALLDIRS=vendor 
3457         or equivalent.  See INSTALL for details.
3458
3459 vendorlibexp (vendorlib.U):
3460         This variable is the ~name expanded version of vendorlib, so that you
3461         may use it directly in Makefiles or shell scripts.
3462
3463 vendorprefix (vendorprefix.U):
3464         This variable holds the full absolute path of the directory below
3465         which the vendor will install add-on packages.
3466         See INSTALL for usage and examples.
3467
3468 vendorprefixexp (vendorprefix.U):
3469         This variable holds the full absolute path of the directory below
3470         which the vendor will install add-on packages.  Derived from vendorprefix.
3471
3472 version (patchlevel.U):
3473         The full version number of this package, such as 5.6.1 (or 5_6_1).
3474         This combines baserev, patchlevel, and subversion to get the
3475         full version number, including any possible subversions.
3476         This is suitable for use as a directory name, and hence is
3477         filesystem dependent.
3478
3479 vi (Loc.U):
3480         This variable is defined but not used by Configure.
3481         The value is a plain '' and is not useful.
3482
3483 voidflags (voidflags.U):
3484         This variable contains the eventual value of the VOIDFLAGS symbol,
3485         which indicates how much support of the void type is given by this
3486         compiler.  See VOIDFLAGS for more info.
3487
3488 xlibpth (libpth.U):
3489         This variable holds extra path (space-separated) used to find
3490         libraries on this platform, for example CPU-specific libraries
3491         (on multi-CPU platforms) may be listed here.
3492
3493 xs_apiversion (xs_apiversion.U):
3494         This variable contains the version of the oldest perl binary
3495         compatible with the present perl.  perl.c:incpush() and
3496         lib/lib.pm will automatically search in $sitearch for older
3497         directories across major versions back to xs_apiversion.
3498         This is only useful if you have a perl library directory tree
3499         structured like the default one.
3500         See INSTALL for how this works.
3501         The versioned site_perl directory was introduced in 5.005,
3502         so that is the lowest possible value.
3503         Since this can depend on compile time options (such as
3504         bincompat) it is set by Configure.  Other non-default sources
3505         of potential incompatibility, such as multiplicity, threads,
3506         debugging, 64bits, sfio, etc., are not checked for currently,
3507         though in principle we could go snooping around in old
3508         Config.pm files.
3509
3510 zcat (Loc.U):
3511         This variable is defined but not used by Configure.
3512         The value is a plain '' and is not useful.
3513
3514 zip (Loc.U):
3515         This variable is used internally by Configure to determine the
3516         full pathname (if any) of the zip program.  After Configure runs,
3517         the value is reset to a plain "zip" and is not useful.
3518