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