[PATCH 5.004_62} Config_62-01 patch available.
[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.
4
5 _a (Unix.U):
6         This variable defines the extension used for ordinary libraries.
7         For unix, it is '.a'.  The '.' is included.  Other possible
8         values include '.lib'.
9
10 _exe (Unix.U):
11         This variable defines the extension used for executable files.
12         For unix it is empty.  Other possible values include '.exe'.
13
14 _o (Unix.U):
15         This variable defines the extension used for object files.
16         For unix, it is '.o'.  The '.' is included.  Other possible
17         values include '.obj'.
18
19 afs (afs.U):
20         This variable is set to 'true' if AFS (Andrew File System) is used
21         on the system, 'false' otherwise.  It is possible to override this
22         with a hint value or command line option, but you'd better know
23         what you are doing.
24
25 alignbytes (alignbytes.U):
26         This variable holds the number of bytes required to align a
27         double. Usual values are 2, 4 and 8.
28
29 aphostname (d_gethname.U):
30         Thie variable contains the command which can be used to compute the
31         host name. The command is fully qualified by its absolute path, to make
32         it safe when used by a process with super-user privileges.
33
34 archlib (archlib.U):
35         This variable holds the name of the directory in which the user wants
36         to put architecture-dependent public library files for $package.
37         It is most often a local directory such as /usr/local/lib.
38         Programs using this variable must be prepared to deal
39         with filename expansion.
40
41 archlibexp (archlib.U):
42         This variable is the same as the archlib variable, but is
43         filename expanded at configuration time, for convenient use.
44
45 archname (archname.U):
46         This variable is a short name to characterize the current
47         architecture.  It is used mainly to construct the default archlib.
48
49 archobjs (Unix.U):
50         This variable defines any additional objects that must be linked
51         in with the program on this architecture.  On unix, it is usually
52         empty.  It is typically used to include emulations of unix calls
53         or other facilities.  For perl on OS/2, for example, this would
54         include os2/os2.obj.
55
56 baserev (baserev.U):
57         The base revision level of this package, from the .package file.
58
59 bin (bin.U):
60         This variable holds the name of the directory in which the user wants
61         to put publicly executable images for the package in question.  It
62         is most often a local directory such as /usr/local/bin. Programs using
63         this variable must be prepared to deal with ~name substitution.
64
65 binexp (bin.U):
66         This is the same as the bin variable, but is filename expanded at
67         configuration time, for use in your makefiles.
68
69 byteorder (byteorder.U):
70         This variable holds the byte order. In the following, larger digits
71         indicate more significance.  The variable byteorder is either 4321
72         on a big-endian machine, or 1234 on a little-endian, or 87654321
73         on a Cray ... or 3412 with weird order !
74
75 c (n.U):
76         This variable contains the \c string if that is what causes the echo
77         command to suppress newline.  Otherwise it is null.  Correct usage is
78             $echo $n "prompt for a question: $c".
79
80 castflags (d_castneg.U):
81         This variable contains a flag that precise difficulties the
82         compiler has casting odd floating values to unsigned long:
83                 0 = ok
84                 1 = couldn't cast < 0
85                 2 = couldn't cast >= 0x80000000
86                 4 = couldn't cast in argument expression list
87
88 cc (cc.U):
89         This variable holds the name of a command to execute a C compiler which
90         can resolve multiple global references that happen to have the same
91         name.  Usual values are "cc", "Mcc", "cc -M", and "gcc".
92
93 cccdlflags (dlsrc.U):
94         This variable contains any special flags that might need to be
95         passed with cc -c to compile modules to be used to create a shared
96         library that will be used for dynamic loading.  For hpux, this 
97         should be +z.  It is up to the makefile to use it.
98
99 ccdlflags (dlsrc.U):
100         This variable contains any special flags that might need to be
101         passed to cc to link with a shared library for dynamic loading. 
102         It is up to the makefile to use it.  For sunos 4.1, it should
103         be empty.
104
105 ccflags (ccflags.U):
106         This variable contains any additional C compiler flags desired by
107         the user.  It is up to the Makefile to use this.
108
109 cf_by (cf_who.U):
110         Login name of the person who ran the Configure script and answered the
111         questions. This is used to tag both config.sh and config_h.SH.
112
113 cf_email (cf_email.U):
114         Electronic mail address of the person who ran Configure. This can be
115         used by units that require the user's e-mail, like MailList.U.
116
117 cf_time (cf_who.U):
118         Holds the output of the "date" command when the configuration file was
119         produced. This is used to tag both config.sh and config_h.SH.
120
121 clocktype (d_times.U):
122         This variable holds the type returned by times(). It can be long,
123         or clock_t on BSD sites (in which case <sys/types.h> should be
124         included).
125
126 contains (contains.U):
127         This variable holds the command to do a grep with a proper return
128         status.  On most sane systems it is simply "grep".  On insane systems
129         it is a grep followed by a cat followed by a test.  This variable
130         is primarily for the use of other Configure units.
131
132 cpp_stuff (cpp_stuff.U):
133         This variable contains an identification of the catenation mechanism
134         used by the C preprocessor.
135
136 cppflags (ccflags.U):
137         This variable holds the flags that will be passed to the C pre-
138         processor. It is up to the Makefile to use it.
139
140 cpplast (cppstdin.U):
141         This variable has the same functionality as cppminus, only it applies to
142         cpprun and not cppstdin.
143
144 cppminus (cppstdin.U):
145         This variable contains the second part of the string which will invoke
146         the C preprocessor on the standard input and produce to standard
147         output.  This variable will have the value "-" if cppstdin needs a minus
148         to specify standard input, otherwise the value is "".
149
150 cpprun (cppstdin.U):
151         This variable contains the command which will invoke a C preprocessor
152         on standard input and put the output to stdout. It is guaranteed not
153         to be a wrapper and may be a null string if no preprocessor can be
154         made directly available. This preprocessor might be different from the
155         one used by the C compiler. Don't forget to append cpplast after the
156         preprocessor options.
157
158 cppstdin (cppstdin.U):
159         This variable contains the command which will invoke the C
160         preprocessor on standard input and put the output to stdout.
161         It is primarily used by other Configure units that ask about
162         preprocessor symbols.
163
164 cryptlib (d_crypt.U):
165         This variable holds -lcrypt or the path to a libcrypt.a archive if
166         the crypt() function is not defined in the standard C library. It is
167         up to the Makefile to use this.
168
169 d_Gconvert (d_gconvert.U):
170         This variable holds what Gconvert is defined as to convert
171         floating point numbers into strings. It could be 'gconvert'
172         or a more complex macro emulating gconvert with gcvt() or sprintf.
173
174 d_access (d_access.U):
175         This variable conditionally defines HAS_ACCESS if the access() system
176         call is available to check for access permissions using real IDs.
177
178 d_alarm (d_alarm.U):
179         This variable conditionally defines the HAS_ALARM symbol, which
180         indicates to the C program that the alarm() routine is available.
181
182 d_archlib (archlib.U):
183         This variable conditionally defines ARCHLIB to hold the pathname
184         of architecture-dependent library files for $package.  If
185         $archlib is the same as $privlib, then this is set to undef.
186
187 d_bcmp (d_bcmp.U):
188         This variable conditionally defines the HAS_BCMP symbol if
189         the bcmp() routine is available to compare strings.
190
191 d_bcopy (d_bcopy.U):
192         This variable conditionally defines the HAS_BCOPY symbol if
193         the bcopy() routine is available to copy strings.
194
195 d_bsd (Guess.U):
196         This symbol conditionally defines the symbol BSD when running on a
197         BSD system.
198
199 d_bsdgetpgrp (d_getpgrp.U):
200         This variable conditionally defines USE_BSD_GETPGRP if
201         getpgrp needs one arguments whereas USG one needs none.
202
203 d_bzero (d_bzero.U):
204         This variable conditionally defines the HAS_BZERO symbol if
205         the bzero() routine is available to set memory to 0.
206
207 d_casti32 (d_casti32.U):
208         This variable conditionally defines CASTI32, which indicates
209         whether the C compiler can cast large floats to 32-bit ints.
210
211 d_castneg (d_castneg.U):
212         This variable conditionally defines CASTNEG, which indicates
213         wether the C compiler can cast negative float to unsigned.
214
215 d_charvspr (d_vprintf.U):
216         This variable conditionally defines CHARVSPRINTF if this system
217         has vsprintf returning type (char*).  The trend seems to be to
218         declare it as "int vsprintf()".
219
220 d_chown (d_chown.U):
221         This variable conditionally defines the HAS_CHOWN symbol, which
222         indicates to the C program that the chown() routine is available.
223
224 d_chroot (d_chroot.U):
225         This variable conditionally defines the HAS_CHROOT symbol, which
226         indicates to the C program that the chroot() routine is available.
227
228 d_chsize (d_chsize.U):
229         This variable conditionally defines the CHSIZE symbol, which
230         indicates to the C program that the chsize() routine is available
231         to truncate files.  You might need a -lx to get this routine.
232
233 d_closedir (d_closedir.U):
234         This variable conditionally defines HAS_CLOSEDIR if closedir() is
235         available.
236
237 d_const (d_const.U):
238         This variable conditionally defines the HASCONST symbol, which
239         indicates to the C program that this C compiler knows about the
240         const type.
241
242 d_crypt (d_crypt.U):
243         This variable conditionally defines the CRYPT symbol, which
244         indicates to the C program that the crypt() routine is available
245         to encrypt passwords and the like.
246
247 d_csh (d_csh.U):
248         This variable conditionally defines the CSH symbol, which
249         indicates to the C program that the C-shell exists.
250
251 d_cuserid (d_cuserid.U):
252         This variable conditionally defines the HAS_CUSERID symbol, which
253         indicates to the C program that the cuserid() routine is available
254         to get character login names.
255
256 d_dbl_dig (d_dbl_dig.U):
257         This variable conditionally defines d_dbl_dig if this system's
258         header files provide DBL_DIG, which is the number of significant
259         digits in a double precision number.
260
261 d_difftime (d_difftime.U):
262         This variable conditionally defines the HAS_DIFFTIME symbol, which
263         indicates to the C program that the difftime() routine is available.
264
265 d_dirnamlen (i_dirent.U):
266         This variable conditionally defines DIRNAMLEN, which indicates
267         to the C program that the length of directory entry names is
268         provided by a d_namelen field.
269
270 d_dlerror (d_dlerror.U):
271         This variable conditionally defines the HAS_DLERROR symbol, which
272         indicates to the C program that the dlerror() routine is available.
273
274 d_dlopen (d_dlopen.U):
275         This variable conditionally defines the HAS_DLOPEN symbol, which
276         indicates to the C program that the dlopen() routine is available.
277
278 d_dlsymun (d_dlsymun.U):
279         This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
280         indicates that we need to prepend an underscore to the symbol
281         name before calling dlsym().
282
283 d_dosuid (d_dosuid.U):
284         This variable conditionally defines the symbol DOSUID, which
285         tells the C program that it should insert setuid emulation code
286         on hosts which have setuid #! scripts disabled.
287
288 d_dup2 (d_dup2.U):
289         This variable conditionally defines HAS_DUP2 if dup2() is
290         available to duplicate file descriptors.
291
292 d_endhent (d_endhent.U):
293         This variable conditionally defines HAS_ENDHOSTENT if endhostent() is
294         available to close whatever was being used for host queries.
295
296 d_endnent (d_endnent.U):
297         This variable conditionally defines HAS_ENDNETENT if endnetent() is
298         available to close whatever was being used for network queries.
299
300 d_endpent (d_endpent.U):
301         This variable conditionally defines HAS_ENDPROTOENT if endprotoent() is
302         available to close whatever was being used for protocol queries.
303
304 d_endsent (d_endsent.U):
305         This variable conditionally defines HAS_ENDSERVENT if endservent() is
306         available to close whatever was being used for service queries.
307
308 d_eofnblk (nblock_io.U):
309         This variable conditionally defines EOF_NONBLOCK if EOF can be seen
310         when reading from a non-blocking I/O source.
311
312 d_eunice (Guess.U):
313         This variable conditionally defines the symbols EUNICE and VAX, which
314         alerts the C program that it must deal with ideosyncracies of VMS.
315
316 d_fchmod (d_fchmod.U):
317         This variable conditionally defines the HAS_FCHMOD symbol, which
318         indicates to the C program that the fchmod() routine is available
319         to change mode of opened files.
320
321 d_fchown (d_fchown.U):
322         This variable conditionally defines the HAS_FCHOWN symbol, which
323         indicates to the C program that the fchown() routine is available
324         to change ownership of opened files.
325
326 d_fcntl (d_fcntl.U):
327         This variable conditionally defines the HAS_FCNTL symbol, and indicates
328         whether the fcntl() function exists
329
330 d_fd_macros (d_fd_set.U):
331         This variable contains the eventual value of the HAS_FD_MACROS symbol,
332         which indicates if your C compiler knows about the macros which
333         manipulate an fd_set.
334
335 d_fd_set (d_fd_set.U):
336         This variable contains the eventual value of the HAS_FD_SET symbol,
337         which indicates if your C compiler knows about the fd_set typedef.
338
339 d_fds_bits (d_fd_set.U):
340         This variable contains the eventual value of the HAS_FDS_BITS symbol,
341         which indicates if your fd_set typedef contains the fds_bits member.
342         If you have an fd_set typedef, but the dweebs who installed it did
343         a half-fast job and neglected to provide the macros to manipulate
344         an fd_set, HAS_FDS_BITS will let us know how to fix the gaffe.
345
346 d_fgetpos (d_fgetpos.U):
347         This variable conditionally defines HAS_FGETPOS if fgetpos() is
348         available to get the file position indicator.
349
350 d_flexfnam (d_flexfnam.U):
351         This variable conditionally defines the FLEXFILENAMES symbol, which
352         indicates that the system supports filenames longer than 14 characters.
353
354 d_flock (d_flock.U):
355         This variable conditionally defines HAS_FLOCK if flock() is
356         available to do file locking.
357
358 d_fork (d_fork.U):
359         This variable conditionally defines the HAS_FORK symbol, which
360         indicates to the C program that the fork() routine is available.
361
362 d_fpathconf (d_pathconf.U):
363         This variable conditionally defines the HAS_FPATHCONF symbol, which
364         indicates to the C program that the pathconf() routine is available
365         to determine file-system related limits and options associated
366         with a given open file descriptor.
367
368 d_fsetpos (d_fsetpos.U):
369         This variable conditionally defines HAS_FSETPOS if fsetpos() is
370         available to set the file position indicator.
371
372 d_ftime (d_ftime.U):
373         This variable conditionally defines the HAS_FTIME symbol, which indicates
374         that the ftime() routine exists.  The ftime() routine is basically
375         a sub-second accuracy clock.
376
377 d_getgrps (d_getgrps.U):
378         This variable conditionally defines the HAS_GETGROUPS symbol, which
379         indicates to the C program that the getgroups() routine is available
380         to get the list of process groups.
381
382 d_gethbyaddr (d_gethbyad.U):
383         This variable conditionally defines the HAS_GETHOSTBYADDR symbol, which
384         indicates to the C program that the gethostbyaddr() routine is available
385         to look up hosts by their IP addresses.
386
387 d_gethent (d_gethent.U):
388         This variable conditionally defines HAS_GETHOSTENT if gethostent() is
389         available to look up host names in some data base or another.
390
391 d_gethname (d_gethname.U):
392         This variable conditionally defines the HAS_GETHOSTNAME symbol, which
393         indicates to the C program that the gethostname() routine may be
394         used to derive the host name.
395
396 d_getlogin (d_getlogin.U):
397         This variable conditionally defines the HAS_GETLOGIN symbol, which
398         indicates to the C program that the getlogin() routine is available
399         to get the login name.
400
401 d_getnbyaddr (d_getnbyad.U):
402         This variable conditionally defines the HAS_GETNETBYADDR symbol, which
403         indicates to the C program that the getnetbyaddr() routine is available
404         to look up networks by their IP addresses.
405
406 d_getnbyname (d_getnbynm.U):
407         This variable conditionally defines the HAS_GETNETBYNAME symbol, which
408         indicates to the C program that the getnetbyname() routine is available
409         to look up networks by their names.
410
411 d_getnent (d_getnent.U):
412         This variable conditionally defines HAS_GETNETENT if getnetent() is
413         available to look up network names in some data base or another.
414
415 d_getpbyname (d_getprotby.U):
416         This variable conditionally defines the HAS_GETPROTOBYNAME 
417         symbol, which indicates to the C program that the 
418         getprotobyname() routine is available to look up protocols
419         by their name.
420
421 d_getpbynumber (d_getprotby.U):
422         This variable conditionally defines the HAS_GETPROTOBYNUMBER 
423         symbol, which indicates to the C program that the 
424         getprotobynumber() routine is available to look up protocols
425         by their number.
426
427 d_getpent (d_getpent.U):
428         This variable conditionally defines HAS_GETPROTOENT if getprotoent() is
429         available to look up protocols in some data base or another.
430
431 d_getpgid (d_getpgid.U):
432         This variable conditionally defines the HAS_GETPGID symbol, which
433         indicates to the C program that the getpgid(pid) function
434         is available to get the process group id.
435
436 d_getpgrp2 (d_getpgrp2.U):
437         This variable conditionally defines the HAS_GETPGRP2 symbol, which
438         indicates to the C program that the getpgrp2() (as in DG/UX) routine
439         is available to get the current process group.
440
441 d_getpgrp (d_getpgrp.U):
442         This variable conditionally defines HAS_GETPGRP if getpgrp() is
443         available to get the current process group.
444
445 d_getppid (d_getppid.U):
446         This variable conditionally defines the HAS_GETPPID symbol, which
447         indicates to the C program that the getppid() routine is available
448         to get the parent process ID.
449
450 d_getprior (d_getprior.U):
451         This variable conditionally defines HAS_GETPRIORITY if getpriority()
452         is available to get a process's priority.
453
454 d_getsbyname (d_getsrvby.U):
455         This variable conditionally defines the HAS_GETSERVBYNAME 
456         symbol, which indicates to the C program that the 
457         getservbyname() routine is available to look up services
458         by their name.
459
460 d_getsbyport (d_getsrvby.U):
461         This variable conditionally defines the HAS_GETSERVBYPORT 
462         symbol, which indicates to the C program that the 
463         getservbyport() routine is available to look up services
464         by their port.
465
466 d_getsent (d_getsent.U):
467         This variable conditionally defines HAS_GETSERVENT if getservent() is
468         available to look up network services in some data base or another.
469
470 d_gettimeod (d_ftime.U):
471         This variable conditionally defines the HAS_GETTIMEOFDAY symbol, which
472         indicates that the gettimeofday() system call exists (to obtain a
473         sub-second accuracy clock). You should probably include <sys/resource.h>.
474
475 d_gnulibc (d_gnulibc.U):
476         Defined if we're dealing with the GNU C Library.
477
478 d_htonl (d_htonl.U):
479         This variable conditionally defines HAS_HTONL if htonl() and its
480         friends are available to do network order byte swapping.
481
482 d_index (d_strchr.U):
483         This variable conditionally defines HAS_INDEX if index() and
484         rindex() are available for string searching.
485
486 d_inetaton (d_inetaton.U):
487         This variable conditionally defines the HAS_INET_ATON symbol, which
488         indicates to the C program that the inet_aton() function is available
489         to parse IP address "dotted-quad" strings.
490
491 d_isascii (d_isascii.U):
492         This variable conditionally defines the HAS_ISASCII constant,
493         which indicates to the C program that isascii() is available.
494
495 d_killpg (d_killpg.U):
496         This variable conditionally defines the HAS_KILLPG symbol, which
497         indicates to the C program that the killpg() routine is available
498         to kill process groups.
499
500 d_link (d_link.U):
501         This variable conditionally defines HAS_LINK if link() is
502         available to create hard links.
503
504 d_locconv (d_locconv.U):
505         This variable conditionally defines HAS_LOCALECONV if localeconv() is
506         available for numeric and monetary formatting conventions.
507
508 d_lockf (d_lockf.U):
509         This variable conditionally defines HAS_LOCKF if lockf() is
510         available to do file locking.
511
512 d_longdbl (d_longdbl.U):
513         This variable conditionally defines HAS_LONG_DOUBLE if 
514         the long double type is supported.
515
516 d_lstat (d_lstat.U):
517         This variable conditionally defines HAS_LSTAT if lstat() is
518         available to do file stats on symbolic links.
519
520 d_mblen (d_mblen.U):
521         This variable conditionally defines the HAS_MBLEN symbol, which
522         indicates to the C program that the mblen() routine is available
523         to find the number of bytes in a multibye character.
524
525 d_mbstowcs (d_mbstowcs.U):
526         This variable conditionally defines the HAS_MBSTOWCS symbol, which
527         indicates to the C program that the mbstowcs() routine is available
528         to convert a multibyte string into a wide character string.
529
530 d_mbtowc (d_mbtowc.U):
531         This variable conditionally defines the HAS_MBTOWC symbol, which
532         indicates to the C program that the mbtowc() routine is available
533         to convert multibyte to a wide character.
534
535 d_memcmp (d_memcmp.U):
536         This variable conditionally defines the HAS_MEMCMP symbol, which
537         indicates to the C program that the memcmp() routine is available
538         to compare blocks of memory.
539
540 d_memcpy (d_memcpy.U):
541         This variable conditionally defines the HAS_MEMCPY symbol, which
542         indicates to the C program that the memcpy() routine is available
543         to copy blocks of memory.
544
545 d_memmove (d_memmove.U):
546         This variable conditionally defines the HAS_MEMMOVE symbol, which
547         indicates to the C program that the memmove() routine is available
548         to copy potentatially overlapping blocks of memory.
549
550 d_memset (d_memset.U):
551         This variable conditionally defines the HAS_MEMSET symbol, which
552         indicates to the C program that the memset() routine is available
553         to set blocks of memory.
554
555 d_mkdir (d_mkdir.U):
556         This variable conditionally defines the HAS_MKDIR symbol, which
557         indicates to the C program that the mkdir() routine is available
558         to create directories..
559
560 d_mkfifo (d_mkfifo.U):
561         This variable conditionally defines the HAS_MKFIFO symbol, which
562         indicates to the C program that the mkfifo() routine is available.
563
564 d_mkstemp (d_mkstemp.U):
565         This variable conditionally defines the HAS_MKSTEMP symbol, which
566         indicates to the C program that the mkstemp() routine is available
567         to create and open a unique tempporary file.
568
569 d_mktime (d_mktime.U):
570         This variable conditionally defines the HAS_MKTIME symbol, which
571         indicates to the C program that the mktime() routine is available.
572
573 d_msg (d_msg.U):
574         This variable conditionally defines the HAS_MSG symbol, which
575         indicates that the entire msg*(2) library is present.
576
577 d_msgctl (d_msgctl.U):
578         This variable conditionally defines the HAS_MSGCTL symbol, which
579         indicates to the C program that the msgctl() routine is available.
580
581 d_msgget (d_msgget.U):
582         This variable conditionally defines the HAS_MSGGET symbol, which
583         indicates to the C program that the msgget() routine is available.
584
585 d_msgrcv (d_msgrcv.U):
586         This variable conditionally defines the HAS_MSGRCV symbol, which
587         indicates to the C program that the msgrcv() routine is available.
588
589 d_msgsnd (d_msgsnd.U):
590         This variable conditionally defines the HAS_MSGSND symbol, which
591         indicates to the C program that the msgsnd() routine is available.
592
593 d_mymalloc (mallocsrc.U):
594         This variable conditionally defines MYMALLOC in case other parts
595         of the source want to take special action if MYMALLOC is used.
596         This may include different sorts of profiling or error detection.
597
598 d_nice (d_nice.U):
599         This variable conditionally defines the HAS_NICE symbol, which
600         indicates to the C program that the nice() routine is available.
601
602 d_oldpthreads (usethreads.U):
603         This variable conditionally defines the OLD_PTHREADS_API symbol,
604         and indicates that Perl should be built to use the old
605         draft POSIX threads API.  This is only potneially meaningful if
606         usethreads is set.
607
608 d_oldsock (d_socket.U):
609         This variable conditionally defines the OLDSOCKET symbol, which
610         indicates that the BSD socket interface is based on 4.1c and not 4.2.
611
612 d_open3 (d_open3.U):
613         This variable conditionally defines the HAS_OPEN3 manifest constant,
614         which indicates to the C program that the 3 argument version of
615         the open(2) function is available.
616
617 d_pathconf (d_pathconf.U):
618         This variable conditionally defines the HAS_PATHCONF symbol, which
619         indicates to the C program that the pathconf() routine is available
620         to determine file-system related limits and options associated
621         with a given filename.
622
623 d_pause (d_pause.U):
624         This variable conditionally defines the HAS_PAUSE symbol, which
625         indicates to the C program that the pause() routine is available
626         to suspend a process until a signal is received.
627
628 d_phostname (d_gethname.U):
629         This variable conditionally defines the PHOSTNAME symbol, which
630         contains the shell command which, when fed to popen(), may be
631         used to derive the host name.
632
633 d_pipe (d_pipe.U):
634         This variable conditionally defines the HAS_PIPE symbol, which
635         indicates to the C program that the pipe() routine is available
636         to create an inter-process channel.
637
638 d_poll (d_poll.U):
639         This variable conditionally defines the HAS_POLL symbol, which
640         indicates to the C program that the poll() routine is available
641         to poll active file descriptors.
642
643 d_portable (d_portable.U):
644         This variable conditionally defines the PORTABLE symbol, which
645         indicates to the C program that it should not assume that it is
646         running on the machine it was compiled on.
647
648 d_pthread_yield (d_pthread_y.U):
649         This variable conditionally defines the HAS_PTHREAD_YIELD
650         symbol if the pthread_yield routine is available to yield
651         the execution of the current thread.
652
653 d_pthreads_created_joinable (d_pthreadj.U):
654         This variable conditionally defines the PTHREADS_CREATED_JOINABLE
655         symbol if pthreads are created in the joinable (aka undetached) 
656         state.
657
658 d_pwage (i_pwd.U):
659         This varaible conditionally defines PWAGE, which indicates
660         that struct passwd contains pw_age.
661
662 d_pwchange (i_pwd.U):
663         This varaible conditionally defines PWCHANGE, which indicates
664         that struct passwd contains pw_change.
665
666 d_pwclass (i_pwd.U):
667         This varaible conditionally defines PWCLASS, which indicates
668         that struct passwd contains pw_class.
669
670 d_pwcomment (i_pwd.U):
671         This varaible conditionally defines PWCOMMENT, which indicates
672         that struct passwd contains pw_comment.
673
674 d_pwexpire (i_pwd.U):
675         This varaible conditionally defines PWEXPIRE, which indicates
676         that struct passwd contains pw_expire.
677
678 d_pwquota (i_pwd.U):
679         This varaible conditionally defines PWQUOTA, which indicates
680         that struct passwd contains pw_quota.
681
682 d_readdir (d_readdir.U):
683         This variable conditionally defines HAS_READDIR if readdir() is
684         available to read directory entries.
685
686 d_readlink (d_readlink.U):
687         This variable conditionally defines the HAS_READLINK symbol, which
688         indicates to the C program that the readlink() routine is available
689         to read the value of a symbolic link.
690
691 d_rename (d_rename.U):
692         This variable conditionally defines the HAS_RENAME symbol, which
693         indicates to the C program that the rename() routine is available
694         to rename files.
695
696 d_rewinddir (d_readdir.U):
697         This variable conditionally defines HAS_REWINDDIR if rewinddir() is
698         available.
699
700 d_rmdir (d_rmdir.U):
701         This variable conditionally defines HAS_RMDIR if rmdir() is
702         available to remove directories.
703
704 d_safebcpy (d_safebcpy.U):
705         This variable conditionally defines the HAS_SAFE_BCOPY symbol if
706         the bcopy() routine can do overlapping copies.
707
708 d_safemcpy (d_safemcpy.U):
709         This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
710         the memcpy() routine can do overlapping copies.
711
712 d_sanemcmp (d_sanemcmp.U):
713         This variable conditionally defines the HAS_SANE_MEMCMP symbol if
714         the memcpy() routine is available and can be used to compare relative
715         magnitudes of chars with their high bits set.
716
717 d_sched_yield (d_pthread_y.U):
718         This variable conditionally defines the HAS_SCHED_YIELD
719         symbol if the sched_yield routine is available to yield
720         the execution of the current thread.
721
722 d_seekdir (d_readdir.U):
723         This variable conditionally defines HAS_SEEKDIR if seekdir() is
724         available.
725
726 d_select (d_select.U):
727         This variable conditionally defines HAS_SELECT if select() is
728         available to select active file descriptors. A <sys/time.h>
729         inclusion may be necessary for the timeout field.
730
731 d_sem (d_sem.U):
732         This variable conditionally defines the HAS_SEM symbol, which
733         indicates that the entire sem*(2) library is present.
734
735 d_semctl (d_semctl.U):
736         This variable conditionally defines the HAS_SEMCTL symbol, which
737         indicates to the C program that the semctl() routine is available.
738
739 d_semget (d_semget.U):
740         This variable conditionally defines the HAS_SEMGET symbol, which
741         indicates to the C program that the semget() routine is available.
742
743 d_semop (d_semop.U):
744         This variable conditionally defines the HAS_SEMOP symbol, which
745         indicates to the C program that the semop() routine is available.
746
747 d_setegid (d_setegid.U):
748         This variable conditionally defines the HAS_SETEGID symbol, which
749         indicates to the C program that the setegid() routine is available
750         to change the effective gid of the current program.
751
752 d_seteuid (d_seteuid.U):
753         This variable conditionally defines the HAS_SETEUID symbol, which
754         indicates to the C program that the seteuid() routine is available
755         to change the effective uid of the current program.
756
757 d_setgrps (d_setgrps.U):
758         This variable conditionally defines the HAS_SETGROUPS symbol, which
759         indicates to the C program that the setgroups() routine is available
760         to set the list of process groups.
761
762 d_sethent (d_sethent.U):
763         This variable conditionally defines HAS_SETHOSTENT if sethostent() is
764         available.
765
766 d_setlinebuf (d_setlnbuf.U):
767         This variable conditionally defines the HAS_SETLINEBUF symbol, which
768         indicates to the C program that the setlinebuf() routine is available
769         to change stderr or stdout from block-buffered or unbuffered to a
770         line-buffered mode.
771
772 d_setlocale (d_setlocale.U):
773         This variable conditionally defines HAS_SETLOCALE if setlocale() is
774         available to handle locale-specific ctype implementations.
775
776 d_setnent (d_setnent.U):
777         This variable conditionally defines HAS_SETNETENT if setnetent() is
778         available.
779
780 d_setpent (d_setpent.U):
781         This variable conditionally defines HAS_SETPROTOENT if setprotoent() is
782         available.
783
784 d_setpgid (d_setpgid.U):
785         This variable conditionally defines the HAS_SETPGID symbol if the
786         setpgid(pid, gpid) function is available to set process group ID.
787
788 d_setpgrp2 (d_setpgrp2.U):
789         This variable conditionally defines the HAS_SETPGRP2 symbol, which
790         indicates to the C program that the setpgrp2() (as in DG/UX) routine
791         is available to set the current process group.
792
793 d_setpgrp (d_setpgrp.U):
794         This variable conditionally defines HAS_SETPGRP if setpgrp() is
795         available to set the current process group.
796
797 d_setprior (d_setprior.U):
798         This variable conditionally defines HAS_SETPRIORITY if setpriority()
799         is available to set a process's priority.
800
801 d_setregid (d_setregid.U):
802         This variable conditionally defines HAS_SETREGID if setregid() is
803         available to change the real and effective gid of the current
804         process.
805
806 d_setresgid (d_setregid.U):
807         This variable conditionally defines HAS_SETRESGID if setresgid() is
808         available to change the real, effective and saved gid of the current
809         process.
810
811 d_setresuid (d_setreuid.U):
812         This variable conditionally defines HAS_SETREUID if setresuid() is
813         available to change the real, effective and saved uid of the current
814         process.
815
816 d_setreuid (d_setreuid.U):
817         This variable conditionally defines HAS_SETREUID if setreuid() is
818         available to change the real and effective uid of the current
819         process.
820
821 d_setrgid (d_setrgid.U):
822         This variable conditionally defines the HAS_SETRGID symbol, which
823         indicates to the C program that the setrgid() routine is available
824         to change the real gid of the current program.
825
826 d_setruid (d_setruid.U):
827         This variable conditionally defines the HAS_SETRUID symbol, which
828         indicates to the C program that the setruid() routine is available
829         to change the real uid of the current program.
830
831 d_setsent (d_setsent.U):
832         This variable conditionally defines HAS_SETSERVENT if setservent() is
833         available.
834
835 d_setsid (d_setsid.U):
836         This variable conditionally defines HAS_SETSID if setsid() is
837         available to set the process group ID.
838
839 d_setvbuf (d_setvbuf.U):
840         This variable conditionally defines the HAS_SETVBUF symbol, which
841         indicates to the C program that the setvbuf() routine is available
842         to change buffering on an open stdio stream.
843
844 d_sfio (d_sfio.U):
845         This variable conditionally defines the USE_SFIO symbol,
846         and indicates whether sfio is available (and should be used).
847
848 d_shm (d_shm.U):
849         This variable conditionally defines the HAS_SHM symbol, which
850         indicates that the entire shm*(2) library is present.
851
852 d_shmat (d_shmat.U):
853         This variable conditionally defines the HAS_SHMAT symbol, which
854         indicates to the C program that the shmat() routine is available.
855
856 d_shmatprototype (d_shmat.U):
857         This variable conditionally defines the HAS_SHMAT_PROTOTYPE 
858         symbol, which indicates that sys/shm.h has a prototype for
859         shmat.
860
861 d_shmctl (d_shmctl.U):
862         This variable conditionally defines the HAS_SHMCTL symbol, which
863         indicates to the C program that the shmctl() routine is available.
864
865 d_shmdt (d_shmdt.U):
866         This variable conditionally defines the HAS_SHMDT symbol, which
867         indicates to the C program that the shmdt() routine is available.
868
869 d_shmget (d_shmget.U):
870         This variable conditionally defines the HAS_SHMGET symbol, which
871         indicates to the C program that the shmget() routine is available.
872
873 d_sigaction (d_sigaction.U):
874         This variable conditionally defines the HAS_SIGACTION symbol, which
875         indicates that the Vr4 sigaction() routine is available.
876
877 d_sigsetjmp (d_sigsetjmp.U):
878         This variable conditionally defines the HAS_SIGSETJMP symbol,
879         which indicates that the sigsetjmp() routine is available to
880         call setjmp() and optionally save the process's signal mask.
881
882 d_socket (d_socket.U):
883         This variable conditionally defines HAS_SOCKET, which indicates
884         that the BSD socket interface is supported.
885
886 d_sockpair (d_socket.U):
887         This variable conditionally defines the HAS_SOCKETPAIR symbol, which
888         indicates that the BSD socketpair() is supported.
889
890 d_statblks (d_statblks.U):
891         This variable conditionally defines USE_STAT_BLOCKS if this system
892         has a stat structure declaring st_blksize and st_blocks.
893
894 d_stdio_cnt_lval (d_stdstdio.U):
895         This variable conditionally defines STDIO_CNT_LVALUE if the
896         FILE_cnt macro can be used as an lvalue.
897
898 d_stdio_ptr_lval (d_stdstdio.U):
899         This variable conditionally defines STDIO_PTR_LVALUE if the
900         FILE_ptr macro can be used as an lvalue.
901
902 d_stdiobase (d_stdstdio.U):
903         This variable conditionally defines USE_STDIO_BASE if this system
904         has a FILE structure declaring a usable _base field (or equivalent)
905         in stdio.h.
906
907 d_stdstdio (d_stdstdio.U):
908         This variable conditionally defines USE_STDIO_PTR if this system
909         has a FILE structure declaring usable _ptr and _cnt fields (or
910         equivalent) in stdio.h.
911
912 d_strchr (d_strchr.U):
913         This variable conditionally defines HAS_STRCHR if strchr() and
914         strrchr() are available for string searching.
915
916 d_strcoll (d_strcoll.U):
917         This variable conditionally defines HAS_STRCOLL if strcoll() is
918         available to compare strings using collating information.
919
920 d_strctcpy (d_strctcpy.U):
921         This variable conditionally defines the USE_STRUCT_COPY symbol, which
922         indicates to the C program that this C compiler knows how to copy
923         structures.
924
925 d_strerrm (d_strerror.U):
926         This variable holds what Strerrr is defined as to translate an error
927         code condition into an error message string. It could be 'strerror'
928         or a more complex macro emulating strrror with sys_errlist[], or the
929         "unknown" string when both strerror and sys_errlist are missing.
930
931 d_strerror (d_strerror.U):
932         This variable conditionally defines HAS_STRERROR if strerror() is
933         available to translate error numbers to strings.
934
935 d_strtod (d_strtod.U):
936         This variable conditionally defines the HAS_STRTOD symbol, which
937         indicates to the C program that the strtod() routine is available
938         to provide better numeric string conversion than atof().
939
940 d_strtol (d_strtol.U):
941         This variable conditionally defines the HAS_STRTOL symbol, which
942         indicates to the C program that the strtol() routine is available
943         to provide better numeric string conversion than atoi() and friends.
944
945 d_strtoul (d_strtoul.U):
946         This variable conditionally defines the HAS_STRTOUL symbol, which
947         indicates to the C program that the strtoul() routine is available
948         to provide conversion of strings to unsigned long.
949
950 d_strxfrm (d_strxfrm.U):
951         This variable conditionally defines HAS_STRXFRM if strxfrm() is
952         available to transform strings.
953
954 d_suidsafe (d_dosuid.U):
955         This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
956         if setuid scripts can be secure.  This test looks in /dev/fd/.
957
958 d_symlink (d_symlink.U):
959         This variable conditionally defines the HAS_SYMLINK symbol, which
960         indicates to the C program that the symlink() routine is available
961         to create symbolic links.
962
963 d_syscall (d_syscall.U):
964         This variable conditionally defines HAS_SYSCALL if syscall() is
965         available call arbitrary system calls.
966
967 d_sysconf (d_sysconf.U):
968         This variable conditionally defines the HAS_SYSCONF symbol, which
969         indicates to the C program that the sysconf() routine is available
970         to determine system related limits and options.
971
972 d_sysernlst (d_strerror.U):
973         This variable conditionally defines HAS_SYS_ERRNOLIST if sys_errnolist[]
974         is available to translate error numbers to the symbolic name.
975
976 d_syserrlst (d_strerror.U):
977         This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
978         available to translate error numbers to strings.
979
980 d_system (d_system.U):
981         This variable conditionally defines HAS_SYSTEM if system() is
982         available to issue a shell command.
983
984 d_tcgetpgrp (d_tcgtpgrp.U):
985         This variable conditionally defines the HAS_TCGETPGRP symbol, which
986         indicates to the C program that the tcgetpgrp() routine is available.
987         to get foreground process group ID.
988
989 d_tcsetpgrp (d_tcstpgrp.U):
990         This variable conditionally defines the HAS_TCSETPGRP symbol, which
991         indicates to the C program that the tcsetpgrp() routine is available
992         to set foreground process group ID.
993
994 d_telldir (d_readdir.U):
995         This variable conditionally defines HAS_TELLDIR if telldir() is
996         available.
997
998 d_time (d_time.U):
999         This variable conditionally defines the HAS_TIME symbol, which indicates
1000         that the time() routine exists.  The time() routine is normaly
1001         provided on UNIX systems.
1002
1003 d_times (d_times.U):
1004         This variable conditionally defines the HAS_TIMES symbol, which indicates
1005         that the times() routine exists.  The times() routine is normaly
1006         provided on UNIX systems. You may have to include <sys/times.h>.
1007
1008 d_truncate (d_truncate.U):
1009         This variable conditionally defines HAS_TRUNCATE if truncate() is
1010         available to truncate files.
1011
1012 d_tzname (d_tzname.U):
1013         This variable conditionally defines HAS_TZNAME if tzname[] is
1014         available to access timezone names.
1015
1016 d_umask (d_umask.U):
1017         This variable conditionally defines the HAS_UMASK symbol, which
1018         indicates to the C program that the umask() routine is available.
1019         to set and get the value of the file creation mask.
1020
1021 d_uname (d_gethname.U):
1022         This variable conditionally defines the HAS_UNAME symbol, which
1023         indicates to the C program that the uname() routine may be
1024         used to derive the host name.
1025
1026 d_vfork (d_vfork.U):
1027         This variable conditionally defines the HAS_VFORK symbol, which
1028         indicates the vfork() routine is available.
1029
1030 d_void_closedir (d_closedir.U):
1031         This variable conditionally defines VOID_CLOSEDIR if closedir()
1032         does not return a value.
1033
1034 d_voidsig (d_voidsig.U):
1035         This variable conditionally defines VOIDSIG if this system
1036         declares "void (*signal(...))()" in signal.h.  The old way was to
1037         declare it as "int (*signal(...))()".
1038
1039 d_voidtty (i_sysioctl.U):
1040         This variable conditionally defines USE_IOCNOTTY to indicate that the
1041         ioctl() call with TIOCNOTTY should be used to void tty association.
1042         Otherwise (on USG probably), it is enough to close the standard file
1043         decriptors and do a setpgrp().
1044
1045 d_volatile (d_volatile.U):
1046         This variable conditionally defines the HASVOLATILE symbol, which
1047         indicates to the C program that this C compiler knows about the
1048         volatile declaration.
1049
1050 d_vprintf (d_vprintf.U):
1051         This variable conditionally defines the HAS_VPRINTF symbol, which
1052         indicates to the C program that the vprintf() routine is available
1053         to printf with a pointer to an argument list.
1054
1055 d_wait4 (d_wait4.U):
1056         This variable conditionally defines the HAS_WAIT4 symbol, which
1057         indicates the wait4() routine is available.
1058
1059 d_waitpid (d_waitpid.U):
1060         This variable conditionally defines HAS_WAITPID if waitpid() is
1061         available to wait for child process.
1062
1063 d_wcstombs (d_wcstombs.U):
1064         This variable conditionally defines the HAS_WCSTOMBS symbol, which
1065         indicates to the C program that the wcstombs() routine is available
1066         to convert wide character strings to multibyte strings.
1067
1068 d_wctomb (d_wctomb.U):
1069         This variable conditionally defines the HAS_WCTOMB symbol, which
1070         indicates to the C program that the wctomb() routine is available
1071         to convert a wide character to a multibyte.
1072
1073 d_xenix (Guess.U):
1074         This variable conditionally defines the symbol XENIX, which alerts
1075         the C program that it runs under Xenix.
1076
1077 db_hashtype (i_db.U):
1078         This variable contains the type of the hash structure element
1079         in the <db.h> header file.  In older versions of DB, it was
1080         int, while in newer ones it is u_int32_t.
1081
1082 db_prefixtype (i_db.U):
1083         This variable contains the type of the prefix structure element
1084         in the <db.h> header file.  In older versions of DB, it was
1085         int, while in newer ones it is size_t.
1086
1087 direntrytype (i_dirent.U):
1088         This symbol is set to 'struct direct' or 'struct dirent' depending on
1089         whether dirent is available or not. You should use this pseudo type to
1090         portably declare your directory entries.
1091
1092 dlext (dlext.U):
1093         This variable contains the extension that is to be used for the
1094         dynamically loaded modules that perl generaties.
1095
1096 dlsrc (dlsrc.U):
1097         This variable contains the name of the dynamic loading file that
1098         will be used with the package.
1099
1100 doublesize (doublesize.U):
1101         This variable contains the value of the DOUBLESIZE symbol, which
1102         indicates to the C program how many bytes there are in a double.
1103
1104 dynamic_ext (Extensions.U):
1105         This variable holds a list of extension files we want to
1106         link dynamically into the package.  It is used by Makefile.
1107
1108 eagain (nblock_io.U):
1109         This variable bears the symbolic errno code set by read() when no
1110         data is present on the file and non-blocking I/O was enabled (otherwise,
1111         read() blocks naturally).
1112
1113 eunicefix (Init.U):
1114         When running under Eunice this variable contains a command which will
1115         convert a shell script to the proper form of text file for it to be
1116         executable by the shell.  On other systems it is a no-op.
1117
1118 exe_ext (Unix.U):
1119         This is an old synonym for _exe.
1120
1121 extensions (Extensions.U):
1122         This variable holds a list of all extension files
1123         linked into the package.  It is propagated to Config.pm
1124         and is typically used to test whether a particular extesion 
1125         is available.
1126
1127 firstmakefile (Unix.U):
1128         This variable defines the first file searched by make.  On unix,
1129         it is makefile (then Makefile).  On case-insensitive systems,
1130         it might be something else.  This is only used to deal with
1131         convoluted make depend tricks.
1132
1133 fpostype (fpostype.U):
1134         This variable defines Fpos_t to be something like fpost_t, long, 
1135         uint, or whatever type is used to declare file positions in libc.
1136
1137 freetype (mallocsrc.U):
1138         This variable contains the return type of free().  It is usually
1139         void, but occasionally int.
1140
1141 full_csh (d_csh.U):
1142         This variable contains the full pathname to 'csh', whether or
1143         not the user has specified 'portability'.  This is only used
1144         in the compiled C program, and we assume that all systems which
1145         can share this executable will have the same full pathname to
1146         'csh.'
1147
1148 full_sed (Loc_sed.U):
1149         This variable contains the full pathname to 'sed', whether or
1150         not the user has specified 'portability'.  This is only used
1151         in the compiled C program, and we assume that all systems which
1152         can share this executable will have the same full pathname to
1153         'sed.'
1154
1155 gccversion (cc.U):
1156         If GNU cc (gcc) is used, this variable holds '1' or '2' to 
1157         indicate whether the compiler is version 1 or 2.  This is used in
1158         setting some of the default cflags.  It is set to '' if not gcc.
1159
1160 gidtype (gidtype.U):
1161         This variable defines Gid_t to be something like gid_t, int,
1162         ushort, or whatever type is used to declare the return type
1163         of getgid().  Typically, it is the type of group ids in the kernel.
1164
1165 groupcat (nis.U):
1166         This variable contains a command that produces the text of the
1167         /etc/group file.  This is normally "cat /etc/group", but can be
1168         "ypcat group" when NIS is used.
1169
1170 groupstype (groupstype.U):
1171         This variable defines Groups_t to be something like gid_t, int, 
1172         ushort, or whatever type is used for the second argument to
1173         getgroups() and setgroups().  Usually, this is the same as
1174         gidtype (gid_t), but sometimes it isn't.
1175
1176 h_fcntl (h_fcntl.U):
1177         This is variable gets set in various places to tell i_fcntl that
1178         <fcntl.h> should be included.
1179
1180 h_sysfile (h_sysfile.U):
1181         This is variable gets set in various places to tell i_sys_file that
1182         <sys/file.h> should be included.
1183
1184 hint (Oldconfig.U):
1185         Gives the type of hints used for previous answers. May be one of
1186         "default", "recommended" or "previous".
1187
1188 hostcat (nis.U):
1189         This variable contains a command that produces the text of the
1190         /etc/hosts file.  This is normally "cat /etc/hosts", but can be
1191         "ypcat hosts" when NIS is used.
1192
1193 huge (models.U):
1194         This variable contains a flag which will tell the C compiler and loader
1195         to produce a program running with a huge memory model.  If the
1196         huge model is not supported, contains the flag to produce large
1197         model programs.  It is up to the Makefile to use this.
1198
1199 i_bsdioctl (i_sysioctl.U):
1200         This variable conditionally defines the I_SYS_BSDIOCTL symbol, which
1201         indicates to the C program that <sys/bsdioctl.h> exists and should
1202         be included.
1203
1204 i_db (i_db.U):
1205         This variable conditionally defines the I_DB symbol, and indicates
1206         whether a C program may include Berkeley's DB include file <db.h>.
1207
1208 i_dirent (i_dirent.U):
1209         This variable conditionally defines I_DIRENT, which indicates
1210         to the C program that it should include <dirent.h>.
1211
1212 i_dld (i_dld.U):
1213         This variable conditionally defines the I_DLD symbol, which
1214         indicates to the C program that <dld.h> (GNU dynamic loading)
1215         exists and should be included.
1216
1217 i_dlfcn (i_dlfcn.U):
1218         This variable conditionally defines the I_DLFCN symbol, which
1219         indicates to the C program that <dlfcn.h> exists and should
1220         be included.
1221
1222 i_fcntl (i_fcntl.U):
1223         This variable controls the value of I_FCNTL (which tells
1224         the C program to include <fcntl.h>).
1225
1226 i_float (i_float.U):
1227         This variable conditionally defines the I_FLOAT symbol, and indicates
1228         whether a C program may include <float.h> to get symbols like DBL_MAX
1229         or DBL_MIN, i.e. machine dependent floating point values.
1230
1231 i_grp (i_grp.U):
1232         This variable conditionally defines the I_GRP symbol, and indicates
1233         whether a C program should include <grp.h>.
1234
1235 i_limits (i_limits.U):
1236         This variable conditionally defines the I_LIMITS symbol, and indicates
1237         whether a C program may include <limits.h> to get symbols like WORD_BIT
1238         and friends.
1239
1240 i_locale (i_locale.U):
1241         This variable conditionally defines the I_LOCALE symbol,
1242         and indicates whether a C program should include <locale.h>.
1243
1244 i_malloc (i_malloc.U):
1245         This variable conditionally defines the I_MALLOC symbol, and indicates
1246         whether a C program should include <malloc.h>.
1247
1248 i_math (i_math.U):
1249         This variable conditionally defines the I_MATH symbol, and indicates
1250         whether a C program may include <math.h>.
1251
1252 i_memory (i_memory.U):
1253         This variable conditionally defines the I_MEMORY symbol, and indicates
1254         whether a C program should include <memory.h>.
1255
1256 i_netdb (i_netdb.U):
1257         This variable conditionally defines the I_NETDB symbol, and indicates
1258         whether a C program should include <netdb.h>.
1259
1260 i_neterrno (i_neterrno.U):
1261         This variable conditionally defines the I_NET_ERRNO symbol, which
1262         indicates to the C program that <net/errno.h> exists and should
1263         be included.
1264
1265 i_niin (i_niin.U):
1266         This variable conditionally defines I_NETINET_IN, which indicates
1267         to the C program that it should include <netinet/in.h>. Otherwise,
1268         you may try <sys/in.h>.
1269
1270 i_pwd (i_pwd.U):
1271         This variable conditionally defines I_PWD, which indicates
1272         to the C program that it should include <pwd.h>.
1273
1274 i_rpcsvcdbm (i_dbm.U):
1275         This variable conditionally defines the I_RPCSVC_DBM symbol, which
1276         indicates to the C program that <rpcsvc/dbm.h> exists and should
1277         be included.  Some System V systems might need this instead of <dbm.h>.
1278
1279 i_sfio (i_sfio.U):
1280         This variable conditionally defines the I_SFIO symbol,
1281         and indicates whether a C program should include <sfio.h>.
1282
1283 i_sgtty (i_termio.U):
1284         This variable conditionally defines the I_SGTTY symbol, which
1285         indicates to the C program that it should include <sgtty.h> rather
1286         than <termio.h>.
1287
1288 i_stdarg (i_varhdr.U):
1289         This variable conditionally defines the I_STDARG symbol, which
1290         indicates to the C program that <stdarg.h> exists and should
1291         be included.
1292
1293 i_stddef (i_stddef.U):
1294         This variable conditionally defines the I_STDDEF symbol, which
1295         indicates to the C program that <stddef.h> exists and should
1296         be included.
1297
1298 i_stdlib (i_stdlib.U):
1299         This variable conditionally defines the I_STDLIB symbol, which
1300         indicates to the C program that <stdlib.h> exists and should
1301         be included.
1302
1303 i_string (i_string.U):
1304         This variable conditionally defines the I_STRING symbol, which
1305         indicates that <string.h> should be included rather than <strings.h>.
1306
1307 i_sysdir (i_sysdir.U):
1308         This variable conditionally defines the I_SYS_DIR symbol, and indicates
1309         whether a C program should include <sys/dir.h>.
1310
1311 i_sysfile (i_sysfile.U):
1312         This variable conditionally defines the I_SYS_FILE symbol, and indicates
1313         whether a C program should include <sys/file.h> to get R_OK and friends.
1314
1315 i_sysfilio (i_sysioctl.U):
1316         This variable conditionally defines the I_SYS_FILIO symbol, which
1317         indicates to the C program that <sys/filio.h> exists and should
1318         be included in preference to <sys/ioctl.h>.
1319
1320 i_sysin (i_niin.U):
1321         This variable conditionally defines I_SYS_IN, which indicates
1322         to the C program that it should include <sys/in.h> instead of
1323         <netinet/in.h>.
1324
1325 i_sysioctl (i_sysioctl.U):
1326         This variable conditionally defines the I_SYS_IOCTL symbol, which
1327         indicates to the C program that <sys/ioctl.h> exists and should
1328         be included.
1329
1330 i_sysndir (i_sysndir.U):
1331         This variable conditionally defines the I_SYS_NDIR symbol, and indicates
1332         whether a C program should include <sys/ndir.h>.
1333
1334 i_sysparam (i_sysparam.U):
1335         This variable conditionally defines the I_SYS_PARAM symbol, and indicates
1336         whether a C program should include <sys/param.h>.
1337
1338 i_sysresrc (i_sysresrc.U):
1339         This variable conditionally defines the I_SYS_RESOURCE symbol,
1340         and indicates whether a C program should include <sys/resource.h>.
1341
1342 i_sysselct (i_sysselct.U):
1343         This variable conditionally defines I_SYS_SELECT, which indicates
1344         to the C program that it should include <sys/select.h> in order to
1345         get the definition of struct timeval.
1346
1347 i_syssockio (i_sysioctl.U):
1348         This variable conditionally defines I_SYS_SOCKIO to indicate to the
1349         C program that socket ioctl codes may be found in <sys/sockio.h>
1350         instead of <sys/ioctl.h>.
1351
1352 i_sysstat (i_sysstat.U):
1353         This variable conditionally defines the I_SYS_STAT symbol,
1354         and indicates whether a C program should include <sys/stat.h>.
1355
1356 i_systime (i_time.U):
1357         This variable conditionally defines I_SYS_TIME, which indicates
1358         to the C program that it should include <sys/time.h>.
1359
1360 i_systimek (i_time.U):
1361         This variable conditionally defines I_SYS_TIME_KERNEL, which
1362         indicates to the C program that it should include <sys/time.h>
1363         with KERNEL defined.
1364
1365 i_systimes (i_systimes.U):
1366         This variable conditionally defines the I_SYS_TIMES symbol, and indicates
1367         whether a C program should include <sys/times.h>.
1368
1369 i_systypes (i_systypes.U):
1370         This variable conditionally defines the I_SYS_TYPES symbol,
1371         and indicates whether a C program should include <sys/types.h>.
1372
1373 i_sysun (i_sysun.U):
1374         This variable conditionally defines I_SYS_UN, which indicates
1375         to the C program that it should include <sys/un.h> to get UNIX
1376         domain socket definitions.
1377
1378 i_syswait (i_syswait.U):
1379         This variable conditionally defines I_SYS_WAIT, which indicates
1380         to the C program that it should include <sys/wait.h>.
1381
1382 i_termio (i_termio.U):
1383         This variable conditionally defines the I_TERMIO symbol, which
1384         indicates to the C program that it should include <termio.h> rather
1385         than <sgtty.h>.
1386
1387 i_termios (i_termio.U):
1388         This variable conditionally defines the I_TERMIOS symbol, which
1389         indicates to the C program that the POSIX <termios.h> file is
1390         to be included.
1391
1392 i_time (i_time.U):
1393         This variable conditionally defines I_TIME, which indicates
1394         to the C program that it should include <time.h>.
1395
1396 i_unistd (i_unistd.U):
1397         This variable conditionally defines the I_UNISTD symbol, and indicates
1398         whether a C program should include <unistd.h>.
1399
1400 i_utime (i_utime.U):
1401         This variable conditionally defines the I_UTIME symbol, and indicates
1402         whether a C program should include <utime.h>.
1403
1404 i_values (i_values.U):
1405         This variable conditionally defines the I_VALUES symbol, and indicates
1406         whether a C program may include <values.h> to get symbols like MAXLONG
1407         and friends.
1408
1409 i_varargs (i_varhdr.U):
1410         This variable conditionally defines I_VARARGS, which indicates
1411         to the C program that it should include <varargs.h>.
1412
1413 i_varhdr (i_varhdr.U):
1414         Contains the name of the header to be included to get va_dcl definition.
1415         Typically one of varargs.h or stdarg.h.
1416
1417 i_vfork (i_vfork.U):
1418         This variable conditionally defines the I_VFORK symbol, and indicates
1419         whether a C program should include vfork.h.
1420
1421 incpath (usrinc.U):
1422         This variable must preceed the normal include path to get hte
1423         right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
1424         Value can be "" or "/bsd43" on mips.
1425
1426 installarchlib (archlib.U):
1427         This variable is really the same as archlibexp but may differ on
1428         those systems using AFS. For extra portability, only this variable
1429         should be used in makefiles.
1430
1431 installbin (bin.U):
1432         This variable is the same as binexp unless AFS is running in which case
1433         the user is explicitely prompted for it. This variable should always
1434         be used in your makefiles for maximum portability.
1435
1436 installman1dir (man1dir.U):
1437         This variable is really the same as man1direxp, unless you are using
1438         AFS in which case it points to the read/write location whereas
1439         man1direxp only points to the read-only access location. For extra
1440         portability, you should only use this variable within your makefiles.
1441
1442 installman3dir (man3dir.U):
1443         This variable is really the same as man3direxp, unless you are using
1444         AFS in which case it points to the read/write location whereas
1445         man3direxp only points to the read-only access location. For extra
1446         portability, you should only use this variable within your makefiles.
1447
1448 installprivlib (privlib.U):
1449         This variable is really the same as privlibexp but may differ on
1450         those systems using AFS. For extra portability, only this variable
1451         should be used in makefiles.
1452
1453 installscript (scriptdir.U):
1454         This variable is usually the same as scriptdirexp, unless you are on
1455         a system running AFS, in which case they may differ slightly. You
1456         should always use this variable within your makefiles for portability.
1457
1458 installsitearch (sitearch.U):
1459         This variable is really the same as sitearchexp but may differ on
1460         those systems using AFS. For extra portability, only this variable
1461         should be used in makefiles.
1462
1463 installsitelib (sitelib.U):
1464         This variable is really the same as sitelibexp but may differ on
1465         those systems using AFS. For extra portability, only this variable
1466         should be used in makefiles.
1467
1468 intsize (intsize.U):
1469         This variable contains the value of the INTSIZE symbol, which
1470         indicates to the C program how many bytes there are in an int.
1471
1472 known_extensions (Extensions.U):
1473         This variable holds a list of all extensions included in 
1474         the package.
1475
1476 large (models.U):
1477         This variable contains a flag which will tell the C compiler and loader
1478         to produce a program running with a large memory model.  It is up to
1479         the Makefile to use this.
1480
1481 ld (dlsrc.U):
1482         This variable indicates the program to be used to link
1483         libraries for dynamic loading.  On some systems, it is 'ld'.
1484         On ELF systems, it should be $cc.  Mostly, we'll try to respect
1485         the hint file setting.
1486
1487 lddlflags (dlsrc.U):
1488         This variable contains any special flags that might need to be
1489         passed to $ld to create a shared library suitable for dynamic
1490         loading.  It is up to the makefile to use it.  For hpux, it
1491         should be -b.  For sunos 4.1, it is empty.
1492
1493 ldflags (ccflags.U):
1494         This variable contains any additional C loader flags desired by
1495         the user.  It is up to the Makefile to use this.
1496
1497 lib_ext (Unix.U):
1498         This is an old synonym for _a.
1499
1500 libc (libc.U):
1501         This variable contains the location of the C library.
1502
1503 libperl (libperl.U):
1504         The perl executable is obtained by linking perlmain.c with
1505         libperl, any static extensions (usually just DynaLoader),
1506         and any other libraries needed on this system.  libperl
1507         is usually libperl.a, but can also be libperl.so.xxx if
1508         the user wishes to build a perl executable with a shared
1509         library.
1510
1511 libpth (libpth.U):
1512         This variable holds the general path used to find libraries. It is
1513         intended to be used by other units.
1514
1515 libs (libs.U):
1516         This variable holds the additional libraries we want to use.
1517         It is up to the Makefile to deal with it.
1518
1519 libswanted (Myinit.U):
1520         This variable holds a list of all the libraries we want to
1521         search.  The order is chosen to pick up the c library
1522         ahead of ucb or bsd libraries for SVR4.
1523
1524 lkflags (ccflags.U):
1525         This variable contains any additional C partial linker flags desired by
1526         the user.  It is up to the Makefile to use this.
1527
1528 lns (lns.U):
1529         This variable holds the name of the command to make 
1530         symbolic links (if they are supported).  It can be used
1531         in the Makefile. It is either 'ln -s' or 'ln'
1532
1533 locincpth (ccflags.U):
1534         This variable contains a list of additional directories to be
1535         searched by the compiler.  The appropriate -I directives will
1536         be added to ccflags.  This is intended to simplify setting
1537         local directories from the Configure command line.
1538         It's not much, but it parallels the loclibpth stuff in libpth.U.
1539
1540 loclibpth (libpth.U):
1541         This variable holds the paths used to find local libraries.  It is
1542         prepended to libpth, and is intended to be easily set from the
1543         command line.
1544
1545 longdblsize (d_longdbl.U):
1546         This variable contains the value of the LONG_DOUBLESIZE symbol, which
1547         indicates to the C program how many bytes there are in a long double,
1548         if this system supports long doubles.
1549
1550 longsize (intsize.U):
1551         This variable contains the value of the LONGSIZE symbol, which
1552         indicates to the C program how many bytes there are in a long.
1553
1554 lseektype (lseektype.U):
1555         This variable defines lseektype to be something like off_t, long, 
1556         or whatever type is used to declare lseek offset's type in the
1557         kernel (which also appears to be lseek's return type).
1558
1559 make_set_make (make.U):
1560         Some versions of 'make' set the variable MAKE.  Others do not.
1561         This variable contains the string to be included in Makefile.SH
1562         so that MAKE is set if needed, and not if not needed.
1563         Possible values are:
1564         make_set_make='#'               # If your make program handles this for you,
1565         make_set_make="MAKE=$make"      # if it doesn't.
1566         I used a comment character so that we can distinguish a
1567         'set' value (from a previous config.sh or Configure -D option)
1568         from an uncomputed value.
1569
1570 mallocobj (mallocsrc.U):
1571         This variable contains the name of the malloc.o that this package
1572         generates, if that malloc.o is preferred over the system malloc.
1573         Otherwise the value is null.  This variable is intended for generating
1574         Makefiles.  See mallocsrc.
1575
1576 mallocsrc (mallocsrc.U):
1577         This variable contains the name of the malloc.c that comes with
1578         the package, if that malloc.c is preferred over the system malloc.
1579         Otherwise the value is null.  This variable is intended for generating
1580         Makefiles.
1581
1582 malloctype (mallocsrc.U):
1583         This variable contains the kind of ptr returned by malloc and realloc.
1584
1585 man1dir (man1dir.U):
1586         This variable contains the name of the directory in which manual
1587         source pages are to be put.  It is the responsibility of the
1588         Makefile.SH to get the value of this into the proper command.
1589         You must be prepared to do the ~name expansion yourself.
1590
1591 man1direxp (man1dir.U):
1592         This variable is the same as the man1dir variable, but is filename
1593         expanded at configuration time, for convenient use in makefiles.
1594
1595 man1ext (man1dir.U):
1596         This variable contains the extension that the manual page should
1597         have: one of 'n', 'l', or '1'.  The Makefile must supply the '.'.
1598         See man1dir.
1599
1600 man3dir (man3dir.U):
1601         This variable contains the name of the directory in which manual
1602         source pages are to be put.  It is the responsibility of the
1603         Makefile.SH to get the value of this into the proper command.
1604         You must be prepared to do the ~name expansion yourself.
1605
1606 man3direxp (man3dir.U):
1607         This variable is the same as the man3dir variable, but is filename
1608         expanded at configuration time, for convenient use in makefiles.
1609
1610 man3ext (man3dir.U):
1611         This variable contains the extension that the manual page should
1612         have: one of 'n', 'l', or '3'.  The Makefile must supply the '.'.
1613         See man3dir.
1614
1615 medium (models.U):
1616         This variable contains a flag which will tell the C compiler and loader
1617         to produce a program running with a medium memory model.  If the
1618         medium model is not supported, contains the flag to produce large
1619         model programs.  It is up to the Makefile to use this.
1620
1621 mips_type (usrinc.U):
1622         This variable holds the environment type for the mips system.
1623         Possible values are "BSD 4.3" and "System V".
1624
1625 models (models.U):
1626         This variable contains the list of memory models supported by this
1627         system.  Possible component values are none, split, unsplit, small,
1628         medium, large, and huge.  The component values are space separated.
1629
1630 modetype (modetype.U):
1631         This variable defines modetype to be something like mode_t, 
1632         int, unsigned short, or whatever type is used to declare file 
1633         modes for system calls.
1634
1635 myarchname (archname.U):
1636         This variable holds the architecture name computed by Configure in
1637         a previous run. It is not intended to be perused by any user and
1638         should never be set in a hint file.
1639
1640 mydomain (myhostname.U):
1641         This variable contains the eventual value of the MYDOMAIN symbol,
1642         which is the domain of the host the program is going to run on.
1643         The domain must be appended to myhostname to form a complete host name.
1644         The dot comes with mydomain, and need not be supplied by the program.
1645
1646 myuname (Oldconfig.U):
1647         The output of 'uname -a' if available, otherwise the hostname. On Xenix,
1648         pseudo variables assignments in the output are stripped, thank you. The
1649         whole thing is then lower-cased.
1650
1651 n (n.U):
1652         This variable contains the -n flag if that is what causes the echo
1653         command to suppress newline.  Otherwise it is null.  Correct usage is
1654             $echo $n "prompt for a question: $c".
1655
1656 netdb_hlen_type (netdbtype.U):
1657         This variable holds the type used for the 2nd argument to
1658         gethostbyaddr().  Usually, this is int or size_t or unsigned.
1659         This is only useful if you have gethostbyaddr(), naturally.
1660
1661 netdb_host_type (netdbtype.U):
1662         This variable holds the type used for the 1st argument to
1663         gethostbyaddr().  Usually, this is char * or void *,  possibly
1664         with or without a const prefix.
1665         This is only useful if you have gethostbyaddr(), naturally.
1666
1667 netdb_name_type (netdbtype.U):
1668         This variable holds the type used for the argument to
1669         gethostbyname().  Usually, this is char * or const char *.
1670         This is only useful if you have gethostbyname(), naturally.
1671
1672 netdb_net_type (netdbtype.U):
1673         This variable holds the type used for the 1st argument to
1674         getnetbyaddr().  Usually, this is int or long.
1675         This is only useful if you have getnetbyaddr(), naturally.
1676
1677 nm_opt (usenm.U):
1678         This variable holds the options that may be necessary for nm.
1679
1680 nm_so_opt (usenm.U):
1681         This variable holds the options that may be necessary for nm
1682         to work on a shared library but that can not be used on an
1683         archive library.  Currently, this is only used by Linux, where
1684         nm --dynamic is *required* to get symbols from an ELF library which
1685         has been stripped, but nm --dynamic is *fatal* on an archive library.
1686         Maybe Linux should just always set usenm=false.
1687
1688 o_nonblock (nblock_io.U):
1689         This variable bears the symbol value to be used during open() or fcntl()
1690         to turn on non-blocking I/O for a file descriptor. If you wish to switch
1691         between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
1692         but that is only supported by some devices.
1693
1694 obj_ext (Unix.U):
1695         This is an old synonym for _o.
1696
1697 optimize (ccflags.U):
1698         This variable contains any optimizer/debugger flag that should be used.
1699         It is up to the Makefile to use it.
1700
1701 orderlib (orderlib.U):
1702         This variable is "true" if the components of libraries must be ordered
1703         (with `lorder $* | tsort`) before placing them in an archive.  Set to
1704         "false" if ranlib or ar can generate random libraries.
1705
1706 osname (Oldconfig.U):
1707         This variable contains the operating system name (e.g. sunos,
1708         solaris, hpux, etc.).  It can be useful later on for setting
1709         defaults.  Any spaces are replaced with underscores.  It is set
1710         to a null string if we can't figure it out.
1711
1712 osvers (Oldconfig.U):
1713         This variable contains the operating system version (e.g.
1714         4.1.3, 5.2, etc.).  It is primarily used for helping select
1715         an appropriate hints file, but might be useful elsewhere for
1716         setting defaults.  It is set to '' if we can't figure it out.
1717         We try to be flexible about how much of the version number
1718         to keep, e.g. if 4.1.1, 4.1.2, and 4.1.3 are essentially the
1719         same for this package, hints files might just be os_4.0 or
1720         os_4.1, etc., not keeping separate files for each little release.
1721
1722 package (package.U):
1723         This variable contains the name of the package being constructed.
1724         It is primarily intended for the use of later Configure units.
1725
1726 pager (pager.U):
1727         This variable contains the name of the preferred pager on the system.
1728         Usual values are (the full pathnames of) more, less, pg, or cat.
1729
1730 passcat (nis.U):
1731         This variable contains a command that produces the text of the
1732         /etc/passwd file.  This is normally "cat /etc/passwd", but can be
1733         "ypcat passwd" when NIS is used.
1734
1735 patchlevel (patchlevel.U):
1736         The patchlevel level of this package.
1737         The value of patchlevel comes from the patchlevel.h file.
1738
1739 path_sep (Unix.U):
1740         This is an old synonym for p_ in Head.U, the character
1741         used to separate elements in the command shell search PATH.
1742
1743 perladmin (perladmin.U):
1744         Electronic mail address of the perl5 administrator.
1745
1746 perlpath (perlpath.U):
1747         This variable contains the eventual value of the PERLPATH symbol,
1748         which contains the name of the perl interpreter to be used in
1749         shell scripts and in the "eval 'exec'" idiom.
1750
1751 phostname (myhostname.U):
1752         This variable contains the eventual value of the PHOSTNAME symbol,
1753         which is a command that can be fed to popen() to get the host name.
1754         The program should probably not presume that the domain is or isn't
1755         there already.
1756
1757 pidtype (pidtype.U):
1758         This variable defines PIDTYPE to be something like pid_t, int, 
1759         ushort, or whatever type is used to declare process ids in the kernel.
1760
1761 plibpth (libpth.U):
1762         Holds the private path used by Configure to find out the libraries.
1763         Its value is prepend to libpth. This variable takes care of special
1764         machines, like the mips.  Usually, it should be empty.
1765
1766 prefix (prefix.U):
1767         This variable holds the name of the directory below which the
1768         user will install the package.  Usually, this is /usr/local, and
1769         executables go in /usr/local/bin, library stuff in /usr/local/lib,
1770         man pages in /usr/local/man, etc.  It is only used to set defaults
1771         for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
1772
1773 prefixexp (prefix.U):
1774         This variable holds the full absolute path of the directory below
1775         which the user will install the package.  Derived from prefix.
1776
1777 privlib (privlib.U):
1778         This variable contains the eventual value of the PRIVLIB symbol,
1779         which is the name of the private library for this package.  It may
1780         have a ~ on the front. It is up to the makefile to eventually create
1781         this directory while performing installation (with ~ substitution).
1782
1783 privlibexp (privlib.U):
1784         This variable is the ~name expanded version of privlib, so that you
1785         may use it directly in Makefiles or shell scripts.
1786
1787 prototype (prototype.U):
1788         This variable holds the eventual value of CAN_PROTOTYPE, which
1789         indicates the C compiler can handle funciton prototypes.
1790
1791 ptrsize (ptrsize.U):
1792         This variable contains the value of the PTRSIZE symbol, which
1793         indicates to the C program how many bytes there are in a pointer.
1794
1795 randbits (randbits.U):
1796         This variable contains the eventual value of the RANDBITS symbol,
1797         which indicates to the C program how many bits of random number
1798         the rand() function produces.
1799
1800 ranlib (orderlib.U):
1801         This variable is set to the pathname of the ranlib program, if it is
1802         needed to generate random libraries.  Set to ":" if ar can generate
1803         random libraries or if random libraries are not supported
1804
1805 rd_nodata (nblock_io.U):
1806         This variable holds the return code from read() when no data is
1807         present. It should be -1, but some systems return 0 when O_NDELAY is
1808         used, which is a shame because you cannot make the difference between
1809         no data and an EOF.. Sigh!
1810
1811 runnm (usenm.U):
1812         This variable contains 'true' or 'false' depending whether the
1813         nm extraction should be performed or not, according to the value
1814         of usenm and the flags on the Configure command line.
1815
1816 scriptdir (scriptdir.U):
1817         This variable holds the name of the directory in which the user wants
1818         to put publicly scripts for the package in question.  It is either
1819         the same directory as for binaries, or a special one that can be
1820         mounted across different architectures, like /usr/share. Programs
1821         must be prepared to deal with ~name expansion.
1822
1823 scriptdirexp (scriptdir.U):
1824         This variable is the same as scriptdir, but is filename expanded
1825         at configuration time, for programs not wanting to bother with it.
1826
1827 selecttype (selecttype.U):
1828         This variable holds the type used for the 2nd, 3rd, and 4th
1829         arguments to select.  Usually, this is 'fd_set *', if HAS_FD_SET
1830         is defined, and 'int *' otherwise.  This is only useful if you 
1831         have select(), naturally.
1832
1833 sh (sh.U):
1834         This variable contains the full pathname of the shell used
1835         on this system to execute Bourne shell scripts.  Usually, this will be
1836         /bin/sh, though it's possible that some systems will have /bin/ksh,
1837         /bin/pdksh, /bin/ash, /bin/bash, or even something such as
1838         D:/bin/sh.exe.
1839         This unit comes before Options.U, so you can't set sh with a -D
1840         option, though you can override this (and startsh)
1841         with -O -Dsh=/bin/whatever -Dstartsh=whatever
1842
1843 sharpbang (spitshell.U):
1844         This variable contains the string #! if this system supports that
1845         construct.
1846
1847 shmattype (d_shmat.U):
1848         This symbol contains the type of pointer returned by shmat().
1849         It can be 'void *' or 'char *'.
1850
1851 shortsize (intsize.U):
1852         This variable contains the value of the SHORTSIZE symbol which
1853         indicates to the C program how many bytes there are in a short.
1854
1855 shrpenv (libperl.U):
1856         If the user builds a shared libperl.so, then we need to tell the
1857         'perl' executable where it will be able to find the installed libperl.so. 
1858         One way to do this on some systems is to set the environment variable
1859         LD_RUN_PATH to the directory that will be the final location of the
1860         shared libperl.so.  The makefile can use this with something like
1861                 $shrpenv $(CC) -o perl perlmain.o $libperl $libs
1862         Typical values are
1863                 shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
1864         or
1865                 shrpenv=''
1866         See the main perl Makefile.SH for actual working usage.
1867         Alternatively, we might be able to use a command line option such
1868         as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
1869         $archlibexp/CORE (Linux).
1870
1871 shsharp (spitshell.U):
1872         This variable tells further Configure units whether your sh can
1873         handle # comments.
1874
1875 sig_name (sig_name.U):
1876         This variable holds the signal names, space separated. The leading
1877         SIG in signal name is removed.  A ZERO is prepended to the
1878         list.  This is currently not used.
1879
1880 sig_name_init (sig_name.U):
1881         This variable holds the signal names, enclosed in double quotes and
1882         separated by commas, suitable for use in the SIG_NAME definition 
1883         below.  A "ZERO" is prepended to the list, and the list is 
1884         terminated with a plain 0.  The leading SIG in signal names
1885         is removed. See sig_num.
1886
1887 sig_num (sig_name.U):
1888         This variable holds the signal numbers, comma separated. A 0 is
1889         prepended to the list (corresponding to the fake SIGZERO), and 
1890         the list is terminated with a 0.  Those numbers correspond to 
1891         the value of the signal listed in the same place within the
1892         sig_name list.
1893
1894 signal_t (d_voidsig.U):
1895         This variable holds the type of the signal handler (void or int).
1896
1897 sitearch (sitearch.U):
1898         This variable contains the eventual value of the SITEARCH symbol,
1899         which is the name of the private library for this package.  It may
1900         have a ~ on the front. It is up to the makefile to eventually create
1901         this directory while performing installation (with ~ substitution).
1902
1903 sitearchexp (sitearch.U):
1904         This variable is the ~name expanded version of sitearch, so that you
1905         may use it directly in Makefiles or shell scripts.
1906
1907 sitelib (sitelib.U):
1908         This variable contains the eventual value of the SITELIB symbol,
1909         which is the name of the private library for this package.  It may
1910         have a ~ on the front. It is up to the makefile to eventually create
1911         this directory while performing installation (with ~ substitution).
1912
1913 sitelibexp (sitelib.U):
1914         This variable is the ~name expanded version of sitelib, so that you
1915         may use it directly in Makefiles or shell scripts.
1916
1917 sizetype (sizetype.U):
1918         This variable defines sizetype to be something like size_t, 
1919         unsigned long, or whatever type is used to declare length 
1920         parameters for string functions.
1921
1922 small (models.U):
1923         This variable contains a flag which will tell the C compiler and loader
1924         to produce a program running with a small memory model.  It is up to
1925         the Makefile to use this.
1926
1927 so (so.U):
1928         This variable holds the extension used to identify shared libraries
1929         (also known as shared objects) on the system. Usually set to 'so'.
1930
1931 sockethdr (d_socket.U):
1932         This variable has any cpp -I flags needed for socket support.
1933
1934 socketlib (d_socket.U):
1935         This variable has the names of any libraries needed for socket support.
1936
1937 spackage (package.U):
1938         This variable contains the name of the package being constructed,
1939         with the first letter uppercased, i.e. suitable for starting
1940         sentences.
1941
1942 spitshell (spitshell.U):
1943         This variable contains the command necessary to spit out a runnable
1944         shell on this system.  It is either cat or a grep -v for # comments.
1945
1946 split (models.U):
1947         This variable contains a flag which will tell the C compiler and loader
1948         to produce a program that will run in separate I and D space, for those
1949         machines that support separation of instruction and data space.  It is
1950         up to the Makefile to use this.
1951
1952 ssizetype (ssizetype.U):
1953         This variable defines ssizetype to be something like ssize_t, 
1954         long or int.  It is used by functions that return a count 
1955         of bytes or an error condition.  It must be a signed type.
1956         We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
1957
1958 startperl (startperl.U):
1959         This variable contains the string to put on the front of a perl
1960         script to make sure (hopefully) that it runs with perl and not some
1961         shell. Of course, that leading line must be followed by the classical
1962         perl idiom:
1963                 eval 'exec perl -S $0 ${1+"$@"}'
1964                         if $running_under_some_shell;
1965         to guarantee perl startup should the shell execute the script. Note
1966         that this magic incatation is not understood by csh.
1967
1968 startsh (startsh.U):
1969         This variable contains the string to put on the front of a shell
1970         script to make sure (hopefully) that it runs with sh and not some
1971         other shell.
1972
1973 static_ext (Extensions.U):
1974         This variable holds a list of extension files we want to
1975         link statically into the package.  It is used by Makefile.
1976
1977 stdchar (stdchar.U):
1978         This variable conditionally defines STDCHAR to be the type of char
1979         used in stdio.h.  It has the values "unsigned char" or "char".
1980
1981 stdio_base (d_stdstdio.U):
1982         This variable defines how, given a FILE pointer, fp, to access the
1983         _base field (or equivalent) of stdio.h's FILE structure.  This will
1984         be used to define the macro FILE_base(fp).
1985
1986 stdio_bufsiz (d_stdstdio.U):
1987         This variable defines how, given a FILE pointer, fp, to determine
1988         the number of bytes store in the I/O buffer pointer to by the
1989         _base field (or equivalent) of stdio.h's FILE structure.  This will
1990         be used to define the macro FILE_bufsiz(fp).
1991
1992 stdio_cnt (d_stdstdio.U):
1993         This variable defines how, given a FILE pointer, fp, to access the
1994         _cnt field (or equivalent) of stdio.h's FILE structure.  This will
1995         be used to define the macro FILE_cnt(fp).
1996
1997 stdio_filbuf (d_stdstdio.U):
1998         This variable defines how, given a FILE pointer, fp, to tell
1999         stdio to refill it's internal buffers (?).  This will
2000         be used to define the macro FILE_filbuf(fp).
2001
2002 stdio_ptr (d_stdstdio.U):
2003         This variable defines how, given a FILE pointer, fp, to access the
2004         _ptr field (or equivalent) of stdio.h's FILE structure.  This will
2005         be used to define the macro FILE_ptr(fp).
2006
2007 strings (i_string.U):
2008         This variable holds the full path of the string header that will be
2009         used. Typically /usr/include/string.h or /usr/include/strings.h.
2010
2011 subversion (patchlevel.U):
2012         The subversion level of this package.
2013         The value of subversion comes from the patchlevel.h file.
2014         This is unique to perl.
2015
2016 sysman (sysman.U):
2017         This variable holds the place where the manual is located on this
2018         system. It is not the place where the user wants to put his manual
2019         pages. Rather it is the place where Configure may look to find manual
2020         for unix commands (section 1 of the manual usually). See mansrc.
2021
2022 timeincl (i_time.U):
2023         This variable holds the full path of the included time header(s).
2024
2025 timetype (d_time.U):
2026         This variable holds the type returned by time(). It can be long,
2027         or time_t on BSD sites (in which case <sys/types.h> should be
2028         included). Anyway, the type Time_t should be used.
2029
2030 uidtype (uidtype.U):
2031         This variable defines Uid_t to be something like uid_t, int, 
2032         ushort, or whatever type is used to declare user ids in the kernel.
2033
2034 usedl (dlsrc.U):
2035         This variable indicates if the the system supports dynamic
2036         loading of some sort.  See also dlsrc and dlobj.
2037
2038 usemymalloc (mallocsrc.U):
2039         This variable contains y if the malloc that comes with this package
2040         is desired over the system's version of malloc.  People often include
2041         special versions of malloc for effiency, but such versions are often
2042         less portable.  See also mallocsrc and mallocobj.
2043         If this is 'y', then -lmalloc is removed from $libs.
2044
2045 usenm (usenm.U):
2046         This variable contains 'true' or 'false' depending whether the
2047         nm extraction is wanted or not.
2048
2049 useopcode (Extensions.U):
2050         This variable holds either 'true' or 'false' to indicate
2051         whether the Opcode extension should be used.  The sole
2052         use for this currently is to allow an easy mechanism
2053         for users to skip the Opcode extension from the Configure
2054         command line.
2055
2056 useperlio (useperlio.U):
2057         This variable conditionally defines the USE_PERLIO symbol,
2058         and indicates that the PerlIO abstraction should be
2059         used throughout.
2060
2061 useposix (Extensions.U):
2062         This variable holds either 'true' or 'false' to indicate
2063         whether the POSIX extension should be used.  The sole
2064         use for this currently is to allow an easy mechanism
2065         for hints files to indicate that POSIX will not compile
2066         on a particular system.
2067
2068 usesfio (d_sfio.U):
2069         This variable is set to true when the user agrees to use sfio.
2070         It is set to false when sfio is not available or when the user
2071         explicitely requests not to use sfio.  It is here primarily so
2072         that command-line settings can override the auto-detection of
2073         d_sfio without running into a "WHOA THERE".
2074
2075 useshrplib (libperl.U):
2076         This variable is set to 'yes' if the user wishes
2077         to build a shared libperl, and 'no' otherwise.
2078
2079 usethreads (usethreads.U):
2080         This variable conditionally defines the USE_THREADS symbol,
2081         and indicates that Perl should be built to use threads.
2082
2083 usevfork (d_vfork.U):
2084         This variable is set to true when the user accepts to use vfork.
2085         It is set to false when no vfork is available or when the user
2086         explicitely requests not to use vfork.
2087
2088 usrinc (usrinc.U):
2089         This variable holds the path of the include files, which is
2090         usually /usr/include. It is mainly used by other Configure units.
2091
2092 voidflags (voidflags.U):
2093         This variable contains the eventual value of the VOIDFLAGS symbol,
2094         which indicates how much support of the void type is given by this
2095         compiler.  See VOIDFLAGS for more info.
2096