73b0f1e48e5e8043647f7c34264362fdf2ef69a5
[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_sysutsname (i_sysutsname.U):
2120         This variable conditionally defines the I_SYSUTSNAME symbol,
2121         and indicates whether a C program should include <sys/utsname.h>.
2122
2123 i_sysvfs (i_sysvfs.U):
2124         This variable conditionally defines the I_SYSVFS symbol,
2125         and indicates whether a C program should include <sys/vfs.h>.
2126
2127 i_syswait (i_syswait.U):
2128         This variable conditionally defines I_SYS_WAIT, which indicates
2129         to the C program that it should include <sys/wait.h>.
2130
2131 i_termio (i_termio.U):
2132         This variable conditionally defines the I_TERMIO symbol, which
2133         indicates to the C program that it should include <termio.h> rather
2134         than <sgtty.h>.
2135
2136 i_termios (i_termio.U):
2137         This variable conditionally defines the I_TERMIOS symbol, which
2138         indicates to the C program that the POSIX <termios.h> file is
2139         to be included.
2140
2141 i_time (i_time.U):
2142         This variable conditionally defines I_TIME, which indicates
2143         to the C program that it should include <time.h>.
2144
2145 i_unistd (i_unistd.U):
2146         This variable conditionally defines the I_UNISTD symbol, and indicates
2147         whether a C program should include <unistd.h>.
2148
2149 i_ustat (i_ustat.U):
2150         This variable conditionally defines the I_USTAT symbol, and indicates
2151         whether a C program should include <ustat.h>.
2152
2153 i_utime (i_utime.U):
2154         This variable conditionally defines the I_UTIME symbol, and indicates
2155         whether a C program should include <utime.h>.
2156
2157 i_values (i_values.U):
2158         This variable conditionally defines the I_VALUES symbol, and indicates
2159         whether a C program may include <values.h> to get symbols like MAXLONG
2160         and friends.
2161
2162 i_varargs (i_varhdr.U):
2163         This variable conditionally defines I_VARARGS, which indicates
2164         to the C program that it should include <varargs.h>.
2165
2166 i_varhdr (i_varhdr.U):
2167         Contains the name of the header to be included to get va_dcl definition.
2168         Typically one of varargs.h or stdarg.h.
2169
2170 i_vfork (i_vfork.U):
2171         This variable conditionally defines the I_VFORK symbol, and indicates
2172         whether a C program should include vfork.h.
2173
2174 ignore_versioned_solibs (libs.U):
2175         This variable should be non-empty if non-versioned shared
2176         libraries (libfoo.so.x.y) are to be ignored (because they
2177         cannot be linked against).
2178
2179 inc_version_list (inc_version_list.U):
2180         This variable specifies the list of subdirectories in over
2181         which perl.c:incpush() and lib/lib.pm will automatically
2182         search when adding directories to @INC.  The elements in
2183         the list are separated by spaces.  This is only useful
2184         if you have a perl library directory tree structured like the
2185         default one.  See INSTALL for how this works.  The versioned
2186         site_perl directory was introduced in 5.005, so that is the
2187         lowest possible value.
2188
2189 inc_version_list_init (inc_version_list.U):
2190         This variable holds the same list as inc_version_list, but
2191         each item is enclosed in double quotes and separated by commas, 
2192         suitable for use in the PERL_INC_VERSION_LIST initialization.
2193
2194 incpath (usrinc.U):
2195         This variable must preceed the normal include path to get hte
2196         right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
2197         Value can be "" or "/bsd43" on mips.
2198
2199 inews (Loc.U):
2200         This variable is defined but not used by Configure.
2201         The value is a plain '' and is not useful.
2202
2203 installarchlib (archlib.U):
2204         This variable is really the same as archlibexp but may differ on
2205         those systems using AFS. For extra portability, only this variable
2206         should be used in makefiles.
2207
2208 installbin (bin.U):
2209         This variable is the same as binexp unless AFS is running in which case
2210         the user is explicitely prompted for it. This variable should always
2211         be used in your makefiles for maximum portability.
2212
2213 installman1dir (man1dir.U):
2214         This variable is really the same as man1direxp, unless you are using
2215         AFS in which case it points to the read/write location whereas
2216         man1direxp only points to the read-only access location. For extra
2217         portability, you should only use this variable within your makefiles.
2218
2219 installman3dir (man3dir.U):
2220         This variable is really the same as man3direxp, unless you are using
2221         AFS in which case it points to the read/write location whereas
2222         man3direxp only points to the read-only access location. For extra
2223         portability, you should only use this variable within your makefiles.
2224
2225 installprefix (installprefix.U):
2226         This variable holds the name of the directory below which 
2227         "make install" will install the package.  For most users, this
2228         is the same as prefix.  However, it is useful for
2229         installing the software into a different (usually temporary)
2230         location after which it can be bundled up and moved somehow
2231         to the final location specified by prefix.
2232
2233 installprefixexp (installprefix.U):
2234         This variable holds the full absolute path of installprefix
2235         with all ~-expansion done.
2236
2237 installprivlib (privlib.U):
2238         This variable is really the same as privlibexp but may differ on
2239         those systems using AFS. For extra portability, only this variable
2240         should be used in makefiles.
2241
2242 installscript (scriptdir.U):
2243         This variable is usually the same as scriptdirexp, unless you are on
2244         a system running AFS, in which case they may differ slightly. You
2245         should always use this variable within your makefiles for portability.
2246
2247 installsitearch (sitearch.U):
2248         This variable is really the same as sitearchexp but may differ on
2249         those systems using AFS. For extra portability, only this variable
2250         should be used in makefiles.
2251
2252 installsitebin (sitebin.U):
2253         This variable is usually the same as sitebinexp, unless you are on
2254         a system running AFS, in which case they may differ slightly. You
2255         should always use this variable within your makefiles for portability.
2256
2257 installsitelib (sitelib.U):
2258         This variable is really the same as sitelibexp but may differ on
2259         those systems using AFS. For extra portability, only this variable
2260         should be used in makefiles.
2261
2262 installstyle (installstyle.U):
2263         This variable describes the "style" of the perl installation.
2264         This is intended to be useful for tools that need to
2265         manipulate entire perl distributions.  Perl itself doesn't use
2266         this to find its libraries -- the library directories are
2267         stored directly in Config.pm.  Currently, there are only two
2268         styles:  "lib" and "lib/perl5".  The default library locations
2269         (e.g. privlib, sitelib) are either $prefix/lib or
2270         $prefix/lib/perl5.  The former is useful if $prefix is a
2271         directory dedicated to perl (e.g. /opt/perl), while the latter
2272         is useful if $prefix is shared by many packages, e.g. if
2273         $prefix=/usr/local.
2274                 This may later be extended to include other information, so
2275         be careful with pattern-matching on the results.
2276                 For compatibility with perl5.005 and earlier, the default
2277         setting is based on whether or not $prefix contains the string
2278         "perl".
2279
2280 installusrbinperl (instubperl.U):
2281         This variable tells whether Perl should be installed also as
2282         /usr/bin/perl in addition to
2283         $installbin/perl
2284
2285 installvendorbin (vendorbin.U):
2286         This variable is really the same as vendorbinexp but may differ on
2287         those systems using AFS. For extra portability, only this variable
2288         should be used in makefiles.
2289
2290 installvendorlib (vendorlib.U):
2291         This variable is really the same as vendorlibexp but may differ on
2292         those systems using AFS. For extra portability, only this variable
2293         should be used in makefiles.
2294
2295 intsize (intsize.U):
2296         This variable contains the value of the INTSIZE symbol, which
2297         indicates to the C program how many bytes there are in an int.
2298
2299 ivdformat (perlxvf.U):
2300         This variable contains the format string used for printing
2301         a Perl IV as a signed decimal integer. 
2302
2303 ivsize (perlxv.U):
2304         This variable is the size of an IV in bytes.
2305
2306 ivtype (perlxv.U):
2307         This variable contains the C type used for Perl's IV.
2308
2309 known_extensions (Extensions.U):
2310         This variable holds a list of all XS extensions included in 
2311         the package.
2312
2313 ksh (Loc.U):
2314         This variable is defined but not used by Configure.
2315         The value is a plain '' and is not useful.
2316
2317 large (models.U):
2318         This variable contains a flag which will tell the C compiler and loader
2319         to produce a program running with a large memory model.  It is up to
2320         the Makefile to use this.
2321
2322 ld (dlsrc.U):
2323         This variable indicates the program to be used to link
2324         libraries for dynamic loading.  On some systems, it is 'ld'.
2325         On ELF systems, it should be $cc.  Mostly, we'll try to respect
2326         the hint file setting.
2327
2328 lddlflags (dlsrc.U):
2329         This variable contains any special flags that might need to be
2330         passed to $ld to create a shared library suitable for dynamic
2331         loading.  It is up to the makefile to use it.  For hpux, it
2332         should be '-b'.  For sunos 4.1, it is empty.
2333
2334 ldflags (ccflags.U):
2335         This variable contains any additional C loader flags desired by
2336         the user.  It is up to the Makefile to use this.
2337
2338 ldlibpthname (libperl.U):
2339         This variable holds the name of the shared library
2340         search path, often LD_LIBRARY_PATH.  To get an empty
2341         string, the hints file must set this to 'none'.
2342
2343 less (Loc.U):
2344         This variable is used internally by Configure to determine the
2345         full pathname (if any) of the less program.  After Configure runs,
2346         the value is reset to a plain "less" and is not useful.
2347
2348 lib_ext (Unix.U):
2349         This is an old synonym for _a.
2350
2351 libc (libc.U):
2352         This variable contains the location of the C library.
2353
2354 libperl (libperl.U):
2355         The perl executable is obtained by linking perlmain.c with
2356         libperl, any static extensions (usually just DynaLoader),
2357         and any other libraries needed on this system.  libperl
2358         is usually libperl.a, but can also be libperl.so.xxx if
2359         the user wishes to build a perl executable with a shared
2360         library.
2361
2362 libpth (libpth.U):
2363         This variable holds the general path (space-separated) used to find
2364         libraries. It is intended to be used by other units.
2365
2366 libs (libs.U):
2367         This variable holds the additional libraries we want to use.
2368         It is up to the Makefile to deal with it.
2369
2370 libsdirs (libs.U):
2371         This variable holds the directory names aka dirnames of the libraries
2372         we found and accepted, duplicates are removed.
2373
2374 libsfiles (libs.U):
2375         This variable holds the filenames aka basenames of the libraries
2376         we found and accepted.
2377
2378 libsfound (libs.U):
2379         This variable holds the full pathnames of the libraries
2380         we found and accepted.
2381
2382 libswanted (Myinit.U):
2383         This variable holds a list of all the libraries we want to
2384         search.  The order is chosen to pick up the c library
2385         ahead of ucb or bsd libraries for SVR4.
2386
2387 line (Loc.U):
2388         This variable is defined but not used by Configure.
2389         The value is a plain '' and is not useful.
2390
2391 lint (Loc.U):
2392         This variable is defined but not used by Configure.
2393         The value is a plain '' and is not useful.
2394
2395 lkflags (ccflags.U):
2396         This variable contains any additional C partial linker flags desired by
2397         the user.  It is up to the Makefile to use this.
2398
2399 ln (Loc.U):
2400         This variable is used internally by Configure to determine the
2401         full pathname (if any) of the ln program.  After Configure runs,
2402         the value is reset to a plain "ln" and is not useful.
2403
2404 lns (lns.U):
2405         This variable holds the name of the command to make 
2406         symbolic links (if they are supported).  It can be used
2407         in the Makefile. It is either 'ln -s' or 'ln'
2408
2409 locincpth (ccflags.U):
2410         This variable contains a list of additional directories to be
2411         searched by the compiler.  The appropriate '-I' directives will
2412         be added to ccflags.  This is intended to simplify setting
2413         local directories from the Configure command line.
2414         It's not much, but it parallels the loclibpth stuff in libpth.U.
2415
2416 loclibpth (libpth.U):
2417         This variable holds the paths (space-separated) used to find local
2418         libraries.  It is prepended to libpth, and is intended to be easily
2419         set from the command line.
2420
2421 longdblsize (d_longdbl.U):
2422         This variable contains the value of the LONG_DOUBLESIZE symbol, which
2423         indicates to the C program how many bytes there are in a long double,
2424         if this system supports long doubles.
2425
2426 longlongsize (d_longlong.U):
2427         This variable contains the value of the LONGLONGSIZE symbol, which
2428         indicates to the C program how many bytes there are in a long long,
2429         if this system supports long long.
2430
2431 longsize (intsize.U):
2432         This variable contains the value of the LONGSIZE symbol, which
2433         indicates to the C program how many bytes there are in a long.
2434
2435 lp (Loc.U):
2436         This variable is defined but not used by Configure.
2437         The value is a plain '' and is not useful.
2438
2439 lpr (Loc.U):
2440         This variable is defined but not used by Configure.
2441         The value is a plain '' and is not useful.
2442
2443 ls (Loc.U):
2444         This variable is used internally by Configure to determine the
2445         full pathname (if any) of the ls program.  After Configure runs,
2446         the value is reset to a plain "ls" and is not useful.
2447
2448 lseeksize (lseektype.U):
2449         This variable defines lseektype to be something like off_t, long, 
2450         or whatever type is used to declare lseek offset's type in the
2451         kernel (which also appears to be lseek's return type).
2452
2453 lseektype (lseektype.U):
2454         This variable defines lseektype to be something like off_t, long, 
2455         or whatever type is used to declare lseek offset's type in the
2456         kernel (which also appears to be lseek's return type).
2457
2458 mail (Loc.U):
2459         This variable is defined but not used by Configure.
2460         The value is a plain '' and is not useful.
2461
2462 mailx (Loc.U):
2463         This variable is defined but not used by Configure.
2464         The value is a plain '' and is not useful.
2465
2466 make (Loc.U):
2467         This variable is used internally by Configure to determine the
2468         full pathname (if any) of the make program.  After Configure runs,
2469         the value is reset to a plain "make" and is not useful.
2470
2471 make_set_make (make.U):
2472         Some versions of 'make' set the variable MAKE.  Others do not.
2473         This variable contains the string to be included in Makefile.SH
2474         so that MAKE is set if needed, and not if not needed.
2475         Possible values are:
2476         make_set_make='#'               # If your make program handles this for you,
2477         make_set_make="MAKE=$make"      # if it doesn't.
2478         I used a comment character so that we can distinguish a
2479         'set' value (from a previous config.sh or Configure '-D' option)
2480         from an uncomputed value.
2481
2482 mallocobj (mallocsrc.U):
2483         This variable contains the name of the malloc.o that this package
2484         generates, if that malloc.o is preferred over the system malloc.
2485         Otherwise the value is null.  This variable is intended for generating
2486         Makefiles.  See mallocsrc.
2487
2488 mallocsrc (mallocsrc.U):
2489         This variable contains the name of the malloc.c that comes with
2490         the package, if that malloc.c is preferred over the system malloc.
2491         Otherwise the value is null.  This variable is intended for generating
2492         Makefiles.
2493
2494 malloctype (mallocsrc.U):
2495         This variable contains the kind of ptr returned by malloc and realloc.
2496
2497 man1dir (man1dir.U):
2498         This variable contains the name of the directory in which manual
2499         source pages are to be put.  It is the responsibility of the
2500         Makefile.SH to get the value of this into the proper command.
2501         You must be prepared to do the ~name expansion yourself.
2502
2503 man1direxp (man1dir.U):
2504         This variable is the same as the man1dir variable, but is filename
2505         expanded at configuration time, for convenient use in makefiles.
2506
2507 man1ext (man1dir.U):
2508         This variable contains the extension that the manual page should
2509         have: one of 'n', 'l', or '1'.  The Makefile must supply the '.'.
2510         See man1dir.
2511
2512 man3dir (man3dir.U):
2513         This variable contains the name of the directory in which manual
2514         source pages are to be put.  It is the responsibility of the
2515         Makefile.SH to get the value of this into the proper command.
2516         You must be prepared to do the ~name expansion yourself.
2517
2518 man3direxp (man3dir.U):
2519         This variable is the same as the man3dir variable, but is filename
2520         expanded at configuration time, for convenient use in makefiles.
2521
2522 man3ext (man3dir.U):
2523         This variable contains the extension that the manual page should
2524         have: one of 'n', 'l', or '3'.  The Makefile must supply the '.'.
2525         See man3dir.
2526
2527 Mcc (Loc.U):
2528         This variable is used internally by Configure to determine the
2529         full pathname (if any) of the Mcc program.  After Configure runs,
2530         the value is reset to a plain "Mcc" and is not useful.
2531
2532 medium (models.U):
2533         This variable contains a flag which will tell the C compiler and loader
2534         to produce a program running with a medium memory model.  If the
2535         medium model is not supported, contains the flag to produce large
2536         model programs.  It is up to the Makefile to use this.
2537
2538 mips_type (usrinc.U):
2539         This variable holds the environment type for the mips system.
2540         Possible values are "BSD 4.3" and "System V".
2541
2542 mkdir (Loc.U):
2543         This variable is used internally by Configure to determine the
2544         full pathname (if any) of the mkdir program.  After Configure runs,
2545         the value is reset to a plain "mkdir" and is not useful.
2546
2547 mmaptype (d_mmap.U):
2548         This symbol contains the type of pointer returned by mmap()
2549         (and simultaneously the type of the first argument).
2550         It can be 'void *' or 'caddr_t'.
2551
2552 models (models.U):
2553         This variable contains the list of memory models supported by this
2554         system.  Possible component values are none, split, unsplit, small,
2555         medium, large, and huge.  The component values are space separated.
2556
2557 modetype (modetype.U):
2558         This variable defines modetype to be something like mode_t, 
2559         int, unsigned short, or whatever type is used to declare file 
2560         modes for system calls.
2561
2562 more (Loc.U):
2563         This variable is used internally by Configure to determine the
2564         full pathname (if any) of the more program.  After Configure runs,
2565         the value is reset to a plain "more" and is not useful.
2566
2567 multiarch (multiarch.U):
2568         This variable conditionally defines the MULTIARCH symbol
2569         which signifies the presence of multiplatform files.
2570         This is normally set by hints files.
2571
2572 mv (Loc.U):
2573         This variable is defined but not used by Configure.
2574         The value is a plain '' and is not useful.
2575
2576 myarchname (archname.U):
2577         This variable holds the architecture name computed by Configure in
2578         a previous run. It is not intended to be perused by any user and
2579         should never be set in a hint file.
2580
2581 mydomain (myhostname.U):
2582         This variable contains the eventual value of the MYDOMAIN symbol,
2583         which is the domain of the host the program is going to run on.
2584         The domain must be appended to myhostname to form a complete host name.
2585         The dot comes with mydomain, and need not be supplied by the program.
2586
2587 myhostname (myhostname.U):
2588         This variable contains the eventual value of the MYHOSTNAME symbol,
2589         which is the name of the host the program is going to run on.
2590         The domain is not kept with hostname, but must be gotten from mydomain.
2591         The dot comes with mydomain, and need not be supplied by the program.
2592
2593 myuname (Oldconfig.U):
2594         The output of 'uname -a' if available, otherwise the hostname. On Xenix,
2595         pseudo variables assignments in the output are stripped, thank you. The
2596         whole thing is then lower-cased.
2597
2598 n (n.U):
2599         This variable contains the '-n' flag if that is what causes the echo
2600         command to suppress newline.  Otherwise it is null.  Correct usage is
2601         $echo $n "prompt for a question: $c".
2602
2603 netdb_hlen_type (netdbtype.U):
2604         This variable holds the type used for the 2nd argument to
2605         gethostbyaddr().  Usually, this is int or size_t or unsigned.
2606         This is only useful if you have gethostbyaddr(), naturally.
2607
2608 netdb_host_type (netdbtype.U):
2609         This variable holds the type used for the 1st argument to
2610         gethostbyaddr().  Usually, this is char * or void *,  possibly
2611         with or without a const prefix.
2612         This is only useful if you have gethostbyaddr(), naturally.
2613
2614 netdb_name_type (netdbtype.U):
2615         This variable holds the type used for the argument to
2616         gethostbyname().  Usually, this is char * or const char *.
2617         This is only useful if you have gethostbyname(), naturally.
2618
2619 netdb_net_type (netdbtype.U):
2620         This variable holds the type used for the 1st argument to
2621         getnetbyaddr().  Usually, this is int or long.
2622         This is only useful if you have getnetbyaddr(), naturally.
2623
2624 nm (Loc.U):
2625         This variable is used internally by Configure to determine the
2626         full pathname (if any) of the nm program.  After Configure runs,
2627         the value is reset to a plain "nm" and is not useful.
2628
2629 nm_opt (usenm.U):
2630         This variable holds the options that may be necessary for nm.
2631
2632 nm_so_opt (usenm.U):
2633         This variable holds the options that may be necessary for nm
2634         to work on a shared library but that can not be used on an
2635         archive library.  Currently, this is only used by Linux, where
2636         nm --dynamic is *required* to get symbols from an ELF library which
2637         has been stripped, but nm --dynamic is *fatal* on an archive library.
2638         Maybe Linux should just always set usenm=false.
2639
2640 nonxs_ext (Extensions.U):
2641         This variable holds a list of all non-xs extensions included
2642         in the package.  All of them will be built.
2643
2644 nroff (Loc.U):
2645         This variable is used internally by Configure to determine the
2646         full pathname (if any) of the nroff program.  After Configure runs,
2647         the value is reset to a plain "nroff" and is not useful.
2648
2649 nvsize (perlxv.U):
2650         This variable is the size of an NV in bytes.
2651
2652 nvtype (perlxv.U):
2653         This variable contains the C type used for Perl's NV.
2654
2655 o_nonblock (nblock_io.U):
2656         This variable bears the symbol value to be used during open() or fcntl()
2657         to turn on non-blocking I/O for a file descriptor. If you wish to switch
2658         between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
2659         but that is only supported by some devices.
2660
2661 obj_ext (Unix.U):
2662         This is an old synonym for _o.
2663
2664 old_pthread_create_joinable (d_pthrattrj.U):
2665         This variable defines the constant to use for creating joinable
2666         (aka undetached) pthreads.  Unused if pthread.h defines
2667         PTHREAD_CREATE_JOINABLE.  If used, possible values are
2668         PTHREAD_CREATE_UNDETACHED and __UNDETACHED.
2669
2670 optimize (ccflags.U):
2671         This variable contains any optimizer/debugger flag that should be used.
2672         It is up to the Makefile to use it.
2673
2674 orderlib (orderlib.U):
2675         This variable is "true" if the components of libraries must be ordered
2676         (with `lorder $* | tsort`) before placing them in an archive.  Set to
2677         "false" if ranlib or ar can generate random libraries.
2678
2679 osname (Oldconfig.U):
2680         This variable contains the operating system name (e.g. sunos,
2681         solaris, hpux, etc.).  It can be useful later on for setting
2682         defaults.  Any spaces are replaced with underscores.  It is set
2683         to a null string if we can't figure it out.
2684
2685 osvers (Oldconfig.U):
2686         This variable contains the operating system version (e.g.
2687         4.1.3, 5.2, etc.).  It is primarily used for helping select
2688         an appropriate hints file, but might be useful elsewhere for
2689         setting defaults.  It is set to '' if we can't figure it out.
2690         We try to be flexible about how much of the version number
2691         to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
2692         same for this package, hints files might just be os_4.0 or
2693         os_4.1, etc., not keeping separate files for each little release.
2694
2695 package (package.U):
2696         This variable contains the name of the package being constructed.
2697         It is primarily intended for the use of later Configure units.
2698
2699 pager (pager.U):
2700         This variable contains the name of the preferred pager on the system.
2701         Usual values are (the full pathnames of) more, less, pg, or cat.
2702
2703 passcat (nis.U):
2704         This variable contains a command that produces the text of the
2705         /etc/passwd file.  This is normally "cat /etc/passwd", but can be
2706         "ypcat passwd" when NIS is used.
2707         On some systems, such as os390, there may be no equivalent
2708         command, in which case this variable is unset.
2709
2710 patchlevel (patchlevel.U):
2711         The patchlevel level of this package.
2712         The value of patchlevel comes from the patchlevel.h file.
2713         In a version number such as 5.6.1, this is the "6".
2714         In patchlevel.h, this is referred to as the "PERL_VERSION".
2715
2716 path_sep (Unix.U):
2717         This is an old synonym for p_ in Head.U, the character
2718         used to separate elements in the command shell search PATH.
2719
2720 perl (Loc.U):
2721         This variable is used internally by Configure to determine the
2722         full pathname (if any) of the perl program.  After Configure runs,
2723         the value is reset to a plain "perl" and is not useful.
2724
2725 PERL_REVISION (Oldsyms.U):
2726         In a Perl version number such as 5.6.2, this is the 5.
2727         This value is manually set in patchlevel.h
2728
2729 PERL_SUBVERSION (Oldsyms.U):
2730         In a Perl version number such as 5.6.2, this is the 2.
2731         Values greater than 50 represent potentially unstable
2732         development subversions.
2733         This value is manually set in patchlevel.h
2734
2735 PERL_VERSION (Oldsyms.U):
2736         In a Perl version number such as 5.6.2, this is the 6.
2737         This value is manually set in patchlevel.h
2738
2739 perladmin (perladmin.U):
2740         Electronic mail address of the perl5 administrator.
2741
2742 perlpath (perlpath.U):
2743         This variable contains the eventual value of the PERLPATH symbol,
2744         which contains the name of the perl interpreter to be used in
2745         shell scripts and in the "eval 'exec'" idiom.
2746
2747 pg (Loc.U):
2748         This variable is used internally by Configure to determine the
2749         full pathname (if any) of the pg program.  After Configure runs,
2750         the value is reset to a plain "pg" and is not useful.
2751
2752 phostname (myhostname.U):
2753         This variable contains the eventual value of the PHOSTNAME symbol,
2754         which is a command that can be fed to popen() to get the host name.
2755         The program should probably not presume that the domain is or isn't
2756         there already.
2757
2758 pidtype (pidtype.U):
2759         This variable defines PIDTYPE to be something like pid_t, int, 
2760         ushort, or whatever type is used to declare process ids in the kernel.
2761
2762 plibpth (libpth.U):
2763         Holds the private path used by Configure to find out the libraries.
2764         Its value is prepend to libpth. This variable takes care of special
2765         machines, like the mips.  Usually, it should be empty.
2766
2767 pm_apiversion (xs_apiversion.U):
2768         This variable contains the version of the oldest perl
2769         compatible with the present perl.  (That is, pure perl modules
2770         written for $pm_apiversion will still work for the current
2771         version).  perl.c:incpush() and lib/lib.pm will automatically
2772         search in $sitelib for older directories across major versions
2773         back to pm_apiversion.  This is only useful if you have a perl
2774         library directory tree structured like the default one.  The
2775         versioned site_perl library was introduced in 5.005, so that's
2776         the default setting for this variable.  It's hard to imagine
2777         it changing before Perl6.  It is included here for symmetry
2778         with xs_apiveprsion -- the searching algorithms will
2779         (presumably) be similar.
2780         See the INSTALL file for how this works.
2781
2782 pmake (Loc.U):
2783         This variable is defined but not used by Configure.
2784         The value is a plain '' and is not useful.
2785
2786 pr (Loc.U):
2787         This variable is defined but not used by Configure.
2788         The value is a plain '' and is not useful.
2789
2790 prefix (prefix.U):
2791         This variable holds the name of the directory below which the
2792         user will install the package.  Usually, this is /usr/local, and
2793         executables go in /usr/local/bin, library stuff in /usr/local/lib,
2794         man pages in /usr/local/man, etc.  It is only used to set defaults
2795         for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
2796
2797 prefixexp (prefix.U):
2798         This variable holds the full absolute path of the directory below
2799         which the user will install the package.  Derived from prefix.
2800
2801 privlib (privlib.U):
2802         This variable contains the eventual value of the PRIVLIB symbol,
2803         which is the name of the private library for this package.  It may
2804         have a ~ on the front. It is up to the makefile to eventually create
2805         this directory while performing installation (with ~ substitution).
2806
2807 privlibexp (privlib.U):
2808         This variable is the ~name expanded version of privlib, so that you
2809         may use it directly in Makefiles or shell scripts.
2810
2811 prototype (prototype.U):
2812         This variable holds the eventual value of CAN_PROTOTYPE, which
2813         indicates the C compiler can handle funciton prototypes.
2814
2815 ptrsize (ptrsize.U):
2816         This variable contains the value of the PTRSIZE symbol, which
2817         indicates to the C program how many bytes there are in a pointer.
2818
2819 quadkind (quadtype.U):
2820         This variable, if defined, encodes the type of a quad:
2821         1 = int, 2 = long, 3 = long long, 4 = int64_t.
2822
2823 quadtype (quadtype.U):
2824         This variable defines Quad_t to be something like long, int, 
2825         long long, int64_t, or whatever type is used for 64-bit integers.
2826
2827 randbits (randfunc.U):
2828         Indicates how many bits are produced by the function used to
2829         generate normalized random numbers.
2830
2831 randfunc (randfunc.U):
2832         Indicates the name of the random number function to use.
2833         Values include drand48, random, and rand. In C programs,
2834         the 'Drand01' macro is defined to generate uniformly distributed
2835         random numbers over the range [0., 1.[ (see drand01 and nrand).
2836
2837 randseedtype (randfunc.U):
2838         Indicates the type of the argument of the seedfunc.
2839
2840 ranlib (orderlib.U):
2841         This variable is set to the pathname of the ranlib program, if it is
2842         needed to generate random libraries.  Set to ":" if ar can generate
2843         random libraries or if random libraries are not supported
2844
2845 rd_nodata (nblock_io.U):
2846         This variable holds the return code from read() when no data is
2847         present. It should be -1, but some systems return 0 when O_NDELAY is
2848         used, which is a shame because you cannot make the difference between
2849         no data and an EOF.. Sigh!
2850
2851 rm (Loc.U):
2852         This variable is used internally by Configure to determine the
2853         full pathname (if any) of the rm program.  After Configure runs,
2854         the value is reset to a plain "rm" and is not useful.
2855
2856 rmail (Loc.U):
2857         This variable is defined but not used by Configure.
2858         The value is a plain '' and is not useful.
2859
2860 runnm (usenm.U):
2861         This variable contains 'true' or 'false' depending whether the
2862         nm extraction should be performed or not, according to the value
2863         of usenm and the flags on the Configure command line.
2864
2865 sched_yield (d_pthread_y.U):
2866         This variable defines the way to yield the execution
2867         of the current thread.
2868
2869 scriptdir (scriptdir.U):
2870         This variable holds the name of the directory in which the user wants
2871         to put publicly scripts for the package in question.  It is either
2872         the same directory as for binaries, or a special one that can be
2873         mounted across different architectures, like /usr/share. Programs
2874         must be prepared to deal with ~name expansion.
2875
2876 scriptdirexp (scriptdir.U):
2877         This variable is the same as scriptdir, but is filename expanded
2878         at configuration time, for programs not wanting to bother with it.
2879
2880 sed (Loc.U):
2881         This variable is used internally by Configure to determine the
2882         full pathname (if any) of the sed program.  After Configure runs,
2883         the value is reset to a plain "sed" and is not useful.
2884
2885 seedfunc (randfunc.U):
2886         Indicates the random number generating seed function.
2887         Values include srand48, srandom, and srand.
2888
2889 selectminbits (selectminbits.U):
2890         This variable holds the minimum number of bits operated by select.
2891         That is, if you do select(n, ...), how many bits at least will be
2892         cleared in the masks if some activity is detected.  Usually this
2893         is either n or 32*ceil(n/32), especially many little-endians do
2894         the latter.  This is only useful if you have select(), naturally.
2895
2896 selecttype (selecttype.U):
2897         This variable holds the type used for the 2nd, 3rd, and 4th
2898         arguments to select.  Usually, this is 'fd_set *', if HAS_FD_SET
2899         is defined, and 'int *' otherwise.  This is only useful if you 
2900         have select(), naturally.
2901
2902 sendmail (Loc.U):
2903         This variable is defined but not used by Configure.
2904         The value is a plain '' and is not useful.
2905
2906 sh (sh.U):
2907         This variable contains the full pathname of the shell used
2908         on this system to execute Bourne shell scripts.  Usually, this will be
2909         /bin/sh, though it's possible that some systems will have /bin/ksh,
2910         /bin/pdksh, /bin/ash, /bin/bash, or even something such as
2911         D:/bin/sh.exe.
2912         This unit comes before Options.U, so you can't set sh with a '-D'
2913         option, though you can override this (and startsh)
2914         with '-O -Dsh=/bin/whatever -Dstartsh=whatever'
2915
2916 shar (Loc.U):
2917         This variable is defined but not used by Configure.
2918         The value is a plain '' and is not useful.
2919
2920 sharpbang (spitshell.U):
2921         This variable contains the string #! if this system supports that
2922         construct.
2923
2924 shmattype (d_shmat.U):
2925         This symbol contains the type of pointer returned by shmat().
2926         It can be 'void *' or 'char *'.
2927
2928 shortsize (intsize.U):
2929         This variable contains the value of the SHORTSIZE symbol which
2930         indicates to the C program how many bytes there are in a short.
2931
2932 shrpenv (libperl.U):
2933         If the user builds a shared libperl.so, then we need to tell the
2934         'perl' executable where it will be able to find the installed libperl.so. 
2935         One way to do this on some systems is to set the environment variable
2936         LD_RUN_PATH to the directory that will be the final location of the
2937         shared libperl.so.  The makefile can use this with something like
2938         $shrpenv $(CC) -o perl perlmain.o $libperl $libs
2939         Typical values are
2940         shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
2941         or
2942         shrpenv=''
2943         See the main perl Makefile.SH for actual working usage.
2944         Alternatively, we might be able to use a command line option such
2945         as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
2946         $archlibexp/CORE (Linux).
2947
2948 shsharp (spitshell.U):
2949         This variable tells further Configure units whether your sh can
2950         handle # comments.
2951
2952 sig_count (sig_name.U):
2953         This variable holds a number larger than the largest valid
2954         signal number.  This is usually the same as the NSIG macro.
2955
2956 sig_name (sig_name.U):
2957         This variable holds the signal names, space separated. The leading
2958         SIG in signal name is removed.  A ZERO is prepended to the
2959         list.  This is currently not used.
2960
2961 sig_name_init (sig_name.U):
2962         This variable holds the signal names, enclosed in double quotes and
2963         separated by commas, suitable for use in the SIG_NAME definition 
2964         below.  A "ZERO" is prepended to the list, and the list is 
2965         terminated with a plain 0.  The leading SIG in signal names
2966         is removed. See sig_num.
2967
2968 sig_num (sig_name.U):
2969         This variable holds the signal numbers, space separated. A ZERO is
2970         prepended to the list (corresponding to the fake SIGZERO), and 
2971         the list is terminated with a 0.  Those numbers correspond to 
2972         the value of the signal listed in the same place within the
2973         sig_name list.
2974
2975 sig_num_init (sig_name.U):
2976         This variable holds the signal numbers, enclosed in double quotes and
2977         separated by commas, suitable for use in the SIG_NUM definition 
2978         below.  A "ZERO" is prepended to the list, and the list is 
2979         terminated with a plain 0.
2980
2981 signal_t (d_voidsig.U):
2982         This variable holds the type of the signal handler (void or int).
2983
2984 sitearch (sitearch.U):
2985         This variable contains the eventual value of the SITEARCH symbol,
2986         which is the name of the private library for this package.  It may
2987         have a ~ on the front. It is up to the makefile to eventually create
2988         this directory while performing installation (with ~ substitution).
2989         The standard distribution will put nothing in this directory.
2990         After perl has been installed, users may install their own local
2991         architecture-dependent modules in this directory with
2992         MakeMaker Makefile.PL
2993         or equivalent.  See INSTALL for details.
2994
2995 sitearchexp (sitearch.U):
2996         This variable is the ~name expanded version of sitearch, so that you
2997         may use it directly in Makefiles or shell scripts.
2998
2999 sitebin (sitebin.U):
3000         This variable holds the name of the directory in which the user wants
3001         to put add-on publicly executable files for the package in question.  It
3002         is most often a local directory such as /usr/local/bin. Programs using
3003         this variable must be prepared to deal with ~name substitution.
3004         The standard distribution will put nothing in this directory.
3005         After perl has been installed, users may install their own local
3006         executables in this directory with
3007         MakeMaker Makefile.PL
3008         or equivalent.  See INSTALL for details.
3009
3010 sitebinexp (sitebin.U):
3011         This is the same as the sitebin variable, but is filename expanded at
3012         configuration time, for use in your makefiles.
3013
3014 sitelib (sitelib.U):
3015         This variable contains the eventual value of the SITELIB symbol,
3016         which is the name of the private library for this package.  It may
3017         have a ~ on the front. It is up to the makefile to eventually create
3018         this directory while performing installation (with ~ substitution).
3019         The standard distribution will put nothing in this directory.
3020         After perl has been installed, users may install their own local
3021         architecture-independent modules in this directory with
3022         MakeMaker Makefile.PL
3023         or equivalent.  See INSTALL for details.
3024
3025 sitelibexp (sitelib.U):
3026         This variable is the ~name expanded version of sitelib, so that you
3027         may use it directly in Makefiles or shell scripts.
3028
3029 siteprefix (siteprefix.U):
3030         This variable holds the full absolute path of the directory below
3031         which the user will install add-on packages.
3032         See INSTALL for usage and examples.
3033
3034 siteprefixexp (siteprefix.U):
3035         This variable holds the full absolute path of the directory below
3036         which the user will install add-on packages.  Derived from siteprefix.
3037
3038 sizetype (sizetype.U):
3039         This variable defines sizetype to be something like size_t, 
3040         unsigned long, or whatever type is used to declare length 
3041         parameters for string functions.
3042
3043 sleep (Loc.U):
3044         This variable is defined but not used by Configure.
3045         The value is a plain '' and is not useful.
3046
3047 smail (Loc.U):
3048         This variable is defined but not used by Configure.
3049         The value is a plain '' and is not useful.
3050
3051 small (models.U):
3052         This variable contains a flag which will tell the C compiler and loader
3053         to produce a program running with a small memory model.  It is up to
3054         the Makefile to use this.
3055
3056 so (so.U):
3057         This variable holds the extension used to identify shared libraries
3058         (also known as shared objects) on the system. Usually set to 'so'.
3059
3060 sockethdr (d_socket.U):
3061         This variable has any cpp '-I' flags needed for socket support.
3062
3063 socketlib (d_socket.U):
3064         This variable has the names of any libraries needed for socket support.
3065
3066 sort (Loc.U):
3067         This variable is used internally by Configure to determine the
3068         full pathname (if any) of the sort program.  After Configure runs,
3069         the value is reset to a plain "sort" and is not useful.
3070
3071 spackage (package.U):
3072         This variable contains the name of the package being constructed,
3073         with the first letter uppercased, i.e. suitable for starting
3074         sentences.
3075
3076 spitshell (spitshell.U):
3077         This variable contains the command necessary to spit out a runnable
3078         shell on this system.  It is either cat or a grep '-v' for # comments.
3079
3080 split (models.U):
3081         This variable contains a flag which will tell the C compiler and loader
3082         to produce a program that will run in separate I and D space, for those
3083         machines that support separation of instruction and data space.  It is
3084         up to the Makefile to use this.
3085
3086 sPRId64 (quadfio.U):
3087         This variable, if defined, contains the string used by stdio to
3088         format 64-bit decimal numbers (format 'd') 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 sPRIEldbl (longdblfio.U):
3095         This variable, if defined, contains the string used by stdio to
3096         format long doubles (format 'E') 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 sPRIFldbl (longdblfio.U):
3103         This variable, if defined, contains the string used by stdio to
3104         format long doubles (format 'F') 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 sPRIGldbl (longdblfio.U):
3111         This variable, if defined, contains the string used by stdio to
3112         format long doubles (format 'G') for output.
3113
3114 sPRIi64 (quadfio.U):
3115         This variable, if defined, contains the string used by stdio to
3116         format 64-bit decimal numbers (format 'i') for output.
3117
3118 sPRIo64 (quadfio.U):
3119         This variable, if defined, contains the string used by stdio to
3120         format 64-bit octal numbers (format 'o') for output.
3121
3122 sPRIu64 (quadfio.U):
3123         This variable, if defined, contains the string used by stdio to
3124         format 64-bit unsigned decimal numbers (format 'u') 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 sPRIX64 (quadfio.U):
3131         This variable, if defined, contains the string used by stdio to
3132         format 64-bit hExADECimAl numbers (format 'X') for output.
3133
3134 src (src.U):
3135         This variable holds the path to the package source. It is up to
3136         the Makefile to use this variable and set VPATH accordingly to
3137         find the sources remotely.
3138
3139 ssizetype (ssizetype.U):
3140         This variable defines ssizetype to be something like ssize_t, 
3141         long or int.  It is used by functions that return a count 
3142         of bytes or an error condition.  It must be a signed type.
3143         We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
3144
3145 startperl (startperl.U):
3146         This variable contains the string to put on the front of a perl
3147         script to make sure (hopefully) that it runs with perl and not some
3148         shell. Of course, that leading line must be followed by the classical
3149         perl idiom:
3150         eval 'exec perl -S $0 ${1+"$@"}'
3151         if $running_under_some_shell;
3152         to guarantee perl startup should the shell execute the script. Note
3153         that this magic incatation is not understood by csh.
3154
3155 startsh (startsh.U):
3156         This variable contains the string to put on the front of a shell
3157         script to make sure (hopefully) that it runs with sh and not some
3158         other shell.
3159
3160 static_ext (Extensions.U):
3161         This variable holds a list of XS extension files we want to
3162         link statically into the package.  It is used by Makefile.
3163
3164 stdchar (stdchar.U):
3165         This variable conditionally defines STDCHAR to be the type of char
3166         used in stdio.h.  It has the values "unsigned char" or "char".
3167
3168 stdio_base (d_stdstdio.U):
3169         This variable defines how, given a FILE pointer, fp, to access the
3170         _base field (or equivalent) of stdio.h's FILE structure.  This will
3171         be used to define the macro FILE_base(fp).
3172
3173 stdio_bufsiz (d_stdstdio.U):
3174         This variable defines how, given a FILE pointer, fp, to determine
3175         the number of bytes store in the I/O buffer pointer to by the
3176         _base field (or equivalent) of stdio.h's FILE structure.  This will
3177         be used to define the macro FILE_bufsiz(fp).
3178
3179 stdio_cnt (d_stdstdio.U):
3180         This variable defines how, given a FILE pointer, fp, to access the
3181         _cnt field (or equivalent) of stdio.h's FILE structure.  This will
3182         be used to define the macro FILE_cnt(fp).
3183
3184 stdio_filbuf (d_stdstdio.U):
3185         This variable defines how, given a FILE pointer, fp, to tell
3186         stdio to refill it's internal buffers (?).  This will
3187         be used to define the macro FILE_filbuf(fp).
3188
3189 stdio_ptr (d_stdstdio.U):
3190         This variable defines how, given a FILE pointer, fp, to access the
3191         _ptr field (or equivalent) of stdio.h's FILE structure.  This will
3192         be used to define the macro FILE_ptr(fp).
3193
3194 stdio_stream_array (stdio_streams.U):
3195         This variable tells the name of the array holding the stdio streams.
3196         Usual values include _iob, __iob, and __sF.
3197
3198 strings (i_string.U):
3199         This variable holds the full path of the string header that will be
3200         used. Typically /usr/include/string.h or /usr/include/strings.h.
3201
3202 submit (Loc.U):
3203         This variable is defined but not used by Configure.
3204         The value is a plain '' and is not useful.
3205
3206 subversion (patchlevel.U):
3207         The subversion level of this package.
3208         The value of subversion comes from the patchlevel.h file.
3209         In a version number such as 5.6.1, this is the "1".
3210         This is unique to perl.
3211
3212 sysman (sysman.U):
3213         This variable holds the place where the manual is located on this
3214         system. It is not the place where the user wants to put his manual
3215         pages. Rather it is the place where Configure may look to find manual
3216         for unix commands (section 1 of the manual usually). See mansrc.
3217
3218 tail (Loc.U):
3219         This variable is defined but not used by Configure.
3220         The value is a plain '' and is not useful.
3221
3222 tar (Loc.U):
3223         This variable is defined but not used by Configure.
3224         The value is a plain '' and is not useful.
3225
3226 tbl (Loc.U):
3227         This variable is defined but not used by Configure.
3228         The value is a plain '' and is not useful.
3229
3230 tee (Loc.U):
3231         This variable is defined but not used by Configure.
3232         The value is a plain '' and is not useful.
3233
3234 test (Loc.U):
3235         This variable is used internally by Configure to determine the
3236         full pathname (if any) of the test program.  After Configure runs,
3237         the value is reset to a plain "test" and is not useful.
3238
3239 timeincl (i_time.U):
3240         This variable holds the full path of the included time header(s).
3241
3242 timetype (d_time.U):
3243         This variable holds the type returned by time(). It can be long,
3244         or time_t on BSD sites (in which case <sys/types.h> should be
3245         included). Anyway, the type Time_t should be used.
3246
3247 touch (Loc.U):
3248         This variable is used internally by Configure to determine the
3249         full pathname (if any) of the touch program.  After Configure runs,
3250         the value is reset to a plain "touch" and is not useful.
3251
3252 tr (Loc.U):
3253         This variable is used internally by Configure to determine the
3254         full pathname (if any) of the tr program.  After Configure runs,
3255         the value is reset to a plain "tr" and is not useful.
3256
3257 trnl (trnl.U):
3258         This variable contains the value to be passed to the tr(1)
3259         command to transliterate a newline.  Typical values are
3260         '\012' and '\n'.  This is needed for EBCDIC systems where
3261         newline is not necessarily '\012'.
3262
3263 troff (Loc.U):
3264         This variable is defined but not used by Configure.
3265         The value is a plain '' and is not useful.
3266
3267 u16size (perlxv.U):
3268         This variable is the size of an U16 in bytes.
3269
3270 u16type (perlxv.U):
3271         This variable contains the C type used for Perl's U16.
3272
3273 u32size (perlxv.U):
3274         This variable is the size of an U32 in bytes.
3275
3276 u32type (perlxv.U):
3277         This variable contains the C type used for Perl's U32.
3278
3279 u64size (perlxv.U):
3280         This variable is the size of an U64 in bytes.
3281
3282 u64type (perlxv.U):
3283         This variable contains the C type used for Perl's U64.
3284
3285 u8size (perlxv.U):
3286         This variable is the size of an U8 in bytes.
3287
3288 u8type (perlxv.U):
3289         This variable contains the C type used for Perl's U8.
3290
3291 uidformat (uidf.U):
3292         This variable contains the format string used for printing a Uid_t.
3293
3294 uidsign (uidsign.U):
3295         This variable contains the signedness of a uidtype.
3296         1 for unsigned, -1 for signed.
3297
3298 uidsize (uidsize.U):
3299         This variable contains the size of a uidtype in bytes.
3300
3301 uidtype (uidtype.U):
3302         This variable defines Uid_t to be something like uid_t, int, 
3303         ushort, or whatever type is used to declare user ids in the kernel.
3304
3305 uname (Loc.U):
3306         This variable is used internally by Configure to determine the
3307         full pathname (if any) of the uname program.  After Configure runs,
3308         the value is reset to a plain "uname" and is not useful.
3309
3310 uniq (Loc.U):
3311         This variable is used internally by Configure to determine the
3312         full pathname (if any) of the uniq program.  After Configure runs,
3313         the value is reset to a plain "uniq" and is not useful.
3314
3315 uquadtype (quadtype.U):
3316         This variable defines Uquad_t to be something like unsigned long,
3317         unsigned int, unsigned long long, uint64_t, or whatever type is
3318         used for 64-bit integers.
3319
3320 use5005threads (usethreads.U):
3321         This variable conditionally defines the USE_5005THREADS symbol,
3322         and indicates that Perl should be built to use the 5.005-based
3323         threading implementation.
3324
3325 use64bits (use64bits.U):
3326         This variable conditionally defines the USE_64_BITS symbol,
3327         and indicates that 64-bit integer types should be used
3328         when available.
3329
3330 usedl (dlsrc.U):
3331         This variable indicates if the system supports dynamic
3332         loading of some sort.  See also dlsrc and dlobj.
3333
3334 useithreads (usethreads.U):
3335         This variable conditionally defines the USE_ITHREADS symbol,
3336         and indicates that Perl should be built to use the interpreter-based
3337         threading implementation.
3338
3339 uselargefiles (uselfs.U):
3340         This variable conditionally defines the USE_LARGE_FILES symbol,
3341         and indicates that large file interfaces should be used when
3342         available.  The use64bits symbol will also be turned on if necessary.
3343
3344 uselongdouble (uselongdbl.U):
3345         This variable conditionally defines the USE_LONG_DOUBLE symbol,
3346         and indicates that long doubles should be used when available.
3347
3348 usemorebits (usemorebits.U):
3349         This variable conditionally defines the USE_MORE_BITS symbol,
3350         and indicates that explicit 64-bit interfaces and long doubles
3351         should be used when available.
3352
3353 usemultiplicity (usemultiplicity.U):
3354         This variable conditionally defines the MULTIPLICITY symbol,
3355         and indicates that Perl should be built to use multiplicity.
3356
3357 usemymalloc (mallocsrc.U):
3358         This variable contains y if the malloc that comes with this package
3359         is desired over the system's version of malloc.  People often include
3360         special versions of malloc for effiency, but such versions are often
3361         less portable.  See also mallocsrc and mallocobj.
3362         If this is 'y', then -lmalloc is removed from $libs.
3363
3364 usenm (usenm.U):
3365         This variable contains 'true' or 'false' depending whether the
3366         nm extraction is wanted or not.
3367
3368 useopcode (Extensions.U):
3369         This variable holds either 'true' or 'false' to indicate
3370         whether the Opcode extension should be used.  The sole
3371         use for this currently is to allow an easy mechanism
3372         for users to skip the Opcode extension from the Configure
3373         command line.
3374
3375 useperlio (useperlio.U):
3376         This variable conditionally defines the USE_PERLIO symbol,
3377         and indicates that the PerlIO abstraction should be
3378         used throughout.
3379
3380 useposix (Extensions.U):
3381         This variable holds either 'true' or 'false' to indicate
3382         whether the POSIX extension should be used.  The sole
3383         use for this currently is to allow an easy mechanism
3384         for hints files to indicate that POSIX will not compile
3385         on a particular system.
3386
3387 usesfio (d_sfio.U):
3388         This variable is set to true when the user agrees to use sfio.
3389         It is set to false when sfio is not available or when the user
3390         explicitely requests not to use sfio.  It is here primarily so
3391         that command-line settings can override the auto-detection of
3392         d_sfio without running into a "WHOA THERE".
3393
3394 useshrplib (libperl.U):
3395         This variable is set to 'yes' if the user wishes
3396         to build a shared libperl, and 'no' otherwise.
3397
3398 usesocks (usesocks.U):
3399         This variable conditionally defines the USE_SOCKS symbol,
3400         and indicates that Perl should be built to use SOCKS.
3401
3402 usethreads (usethreads.U):
3403         This variable conditionally defines the USE_THREADS symbol,
3404         and indicates that Perl should be built to use threads.
3405
3406 usevendorprefix (vendorprefix.U):
3407         This variable tells whether the vendorprefix
3408         and consequently other vendor* paths are in use.
3409
3410 usevfork (d_vfork.U):
3411         This variable is set to true when the user accepts to use vfork.
3412         It is set to false when no vfork is available or when the user
3413         explicitely requests not to use vfork.
3414
3415 usrinc (usrinc.U):
3416         This variable holds the path of the include files, which is
3417         usually /usr/include. It is mainly used by other Configure units.
3418
3419 uuname (Loc.U):
3420         This variable is defined but not used by Configure.
3421         The value is a plain '' and is not useful.
3422
3423 uvoformat (perlxvf.U):
3424         This variable contains the format string used for printing
3425         a Perl UV as an unsigned octal integer. 
3426
3427 uvsize (perlxv.U):
3428         This variable is the size of a UV in bytes.
3429
3430 uvtype (perlxv.U):
3431         This variable contains the C type used for Perl's UV.
3432
3433 uvuformat (perlxvf.U):
3434         This variable contains the format string used for printing
3435         a Perl UV as an unsigned decimal integer. 
3436
3437 uvxformat (perlxvf.U):
3438         This variable contains the format string used for printing
3439         a Perl UV as an unsigned hexadecimal integer. 
3440
3441 vendorbin (vendorbin.U):
3442         This variable contains the eventual value of the VENDORBIN symbol.
3443         It may have a ~ on the front.
3444         The standard distribution will put nothing in this directory.
3445         Vendors who distribute perl may wish to place additional
3446         binaries in this directory with
3447         MakeMaker Makefile.PL INSTALLDIRS=vendor 
3448         or equivalent.  See INSTALL for details.
3449
3450 vendorbinexp (vendorbin.U):
3451         This variable is the ~name expanded version of vendorbin, so that you
3452         may use it directly in Makefiles or shell scripts.
3453
3454 vendorlib (vendorlib.U):
3455         This variable contains the eventual value of the VENDORLIB symbol,
3456         which is the name of the private library for this package.
3457         The standard distribution will put nothing in this directory.
3458         Vendors who distribute perl may wish to place their own
3459         modules in this directory with
3460         MakeMaker Makefile.PL INSTALLDIRS=vendor 
3461         or equivalent.  See INSTALL for details.
3462
3463 vendorlibexp (vendorlib.U):
3464         This variable is the ~name expanded version of vendorlib, so that you
3465         may use it directly in Makefiles or shell scripts.
3466
3467 vendorprefix (vendorprefix.U):
3468         This variable holds the full absolute path of the directory below
3469         which the vendor will install add-on packages.
3470         See INSTALL for usage and examples.
3471
3472 vendorprefixexp (vendorprefix.U):
3473         This variable holds the full absolute path of the directory below
3474         which the vendor will install add-on packages.  Derived from vendorprefix.
3475
3476 version (patchlevel.U):
3477         The full version number of this package, such as 5.6.1 (or 5_6_1).
3478         This combines baserev, patchlevel, and subversion to get the
3479         full version number, including any possible subversions.
3480         This is suitable for use as a directory name, and hence is
3481         filesystem dependent.
3482
3483 vi (Loc.U):
3484         This variable is defined but not used by Configure.
3485         The value is a plain '' and is not useful.
3486
3487 voidflags (voidflags.U):
3488         This variable contains the eventual value of the VOIDFLAGS symbol,
3489         which indicates how much support of the void type is given by this
3490         compiler.  See VOIDFLAGS for more info.
3491
3492 xlibpth (libpth.U):
3493         This variable holds extra path (space-separated) used to find
3494         libraries on this platform, for example CPU-specific libraries
3495         (on multi-CPU platforms) may be listed here.
3496
3497 xs_apiversion (xs_apiversion.U):
3498         This variable contains the version of the oldest perl binary
3499         compatible with the present perl.  perl.c:incpush() and
3500         lib/lib.pm will automatically search in $sitearch for older
3501         directories across major versions back to xs_apiversion.
3502         This is only useful if you have a perl library directory tree
3503         structured like the default one.
3504         See INSTALL for how this works.
3505         The versioned site_perl directory was introduced in 5.005,
3506         so that is the lowest possible value.
3507         Since this can depend on compile time options (such as
3508         bincompat) it is set by Configure.  Other non-default sources
3509         of potential incompatibility, such as multiplicity, threads,
3510         debugging, 64bits, sfio, etc., are not checked for currently,
3511         though in principle we could go snooping around in old
3512         Config.pm files.
3513
3514 zcat (Loc.U):
3515         This variable is defined but not used by Configure.
3516         The value is a plain '' and is not useful.
3517
3518 zip (Loc.U):
3519         This variable is used internally by Configure to determine the
3520         full pathname (if any) of the zip program.  After Configure runs,
3521         the value is reset to a plain "zip" and is not useful.
3522