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