perl 5.003_07: MANIFEST
[perl.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 alignbytes (alignbytes.U):
6         This variable holds the number of bytes required to align a
7         double. Usual values are 2, 4 and 8.
8
9 ar (Unix.U):
10         This variable defines the command to use to create an archive 
11         library.  For unix, it is 'ar'.
12
13 archlib (archlib.U):
14         This variable holds the name of the directory in which the user wants
15         to put architecture-dependent public library files for $package.
16         It is most often a local directory such as /usr/local/lib.
17         Programs using this variable must be prepared to deal
18         with filename expansion.
19
20 archlibexp (archlib.U):
21         This variable is the same as the archlib variable, but is
22         filename expanded at configuration time, for convenient use.
23
24 archobjs (Unix.U):
25         This variable defines any additional objects that must be linked
26         in with the program on this architecture.  On unix, it is usually
27         empty.  It is typically used to include emulations of unix calls
28         or other facilities.  For perl on OS/2, for example, this would
29         include os2/os2.obj.
30
31 bin (bin.U):
32         This variable holds the name of the directory in which the user wants
33         to put publicly executable images for the package in question.  It
34         is most often a local directory such as /usr/local/bin. Programs using
35         this variable must be prepared to deal with ~name substitution.
36
37 byteorder (byteorder.U):
38         This variable holds the byte order. In the following, larger digits
39         indicate more significance.  The variable byteorder is either 4321
40         on a big-endian machine, or 1234 on a little-endian, or 87654321
41         on a Cray ... or 3412 with weird order !
42
43 c (n.U):
44         This variable contains the \c string if that is what causes the echo
45         command to suppress newline.  Otherwise it is null.  Correct usage is
46             $echo $n "prompt for a question: $c".
47
48 castflags (d_castneg.U):
49         This variable contains a flag that precise difficulties the
50         compiler has casting odd floating values to unsigned long:
51                 0 = ok
52                 1 = couldn't cast < 0
53                 2 = couldn't cast >= 0x80000000
54                 4 = couldn't cast in argument expression list
55
56 cc (cc.U):
57         This variable holds the name of a command to execute a C compiler which
58         can resolve multiple global references that happen to have the same
59         name.  Usual values are "cc", "Mcc", "cc -M", and "gcc".
60
61 cccdlflags (dlsrc.U):
62         This variable contains any special flags that might need to be
63         passed with cc -c to compile modules to be used to create a shared
64         library that will be used for dynamic loading.  For hpux, this 
65         should be +z.  It is up to the makefile to use it.
66
67 ccdlflags (dlsrc.U):
68         This variable contains any special flags that might need to be
69         passed to cc to link with a shared library for dynamic loading. 
70         It is up to the makefile to use it.  For sunos 4.1, it should
71         be empty.
72
73 ccflags (ccflags.U):
74         This variable contains any additional C compiler flags desired by
75         the user.  It is up to the Makefile to use this.
76
77 cf_by (cf_who.U):
78         Login name of the person who ran the Configure script and answered the
79         questions. This is used to tag both config.sh and config_h.SH.
80
81 cf_time (cf_who.U):
82         Holds the output of the "date" command when the configuration file was
83         produced. This is used to tag both config.sh and config_h.SH.
84
85 cpp_stuff (cpp_stuff.U):
86         This variable contains an identification of the catenation mechanism
87         used by the C preprocessor.
88
89 cppflags (ccflags.U):
90         This variable holds the flags that will be passed to the C pre-
91         processor. It is up to the Makefile to use it.
92
93 cppminus (cppstdin.U):
94         This variable contains the second part of the string which will invoke
95         the C preprocessor on the standard input and produce to standard
96         output.  This variable will have the value "-" if cppstdin needs a minus
97         to specify standard input, otherwise the value is "".
98
99 cppstdin (cppstdin.U):
100         This variable contains the command which will invoke the C
101         preprocessor on standard input and put the output to stdout.
102         It is primarily used by other Configure units that ask about
103         preprocessor symbols.
104
105 cryptlib (d_crypt.U):
106         This variable holds -lcrypt or the path to a libcrypt.a archive if
107         the crypt() function is not defined in the standard C library. It is
108         up to the Makefile to use this.
109
110 d_Gconvert (d_gconvert.U):
111         This variable holds what Gconvert is defined as to convert
112         floating point numbers into strings. It could be 'gconvert'
113         or a more complex macro emulating gconvert with gcvt() or sprintf.
114
115 d_access (d_access.U):
116         This variable conditionally defines HAS_ACCESS if the access() system
117         call is available to check for access permissions using real IDs.
118
119 d_alarm (d_alarm.U):
120         This variable conditionally defines the HAS_ALARM symbol, which
121         indicates to the C program that the alarm() routine is available.
122
123 d_archlib (archlib.U):
124         This variable conditionally defines ARCHLIB to hold the pathname
125         of architecture-dependent library files for $package.  If
126         $archlib is the same as $privlib, then this is set to undef.
127
128 d_bcmp (d_bcmp.U):
129         This variable conditionally defines the HAS_BCMP symbol if
130         the bcmp() routine is available to compare strings.
131
132 d_bcopy (d_bcopy.U):
133         This variable conditionally defines the HAS_BCOPY symbol if
134         the bcopy() routine is available to copy strings.
135
136 d_bsdgetpgrp (d_getpgrp.U):
137         This variable conditionally defines USE_BSD_GETPGRP if
138         getpgrp needs one arguments whereas USG one needs none.
139
140 d_bsdpgrp (d_setpgrp.U):
141         This variable conditionally defines USE_BSDPGRP if the notion of
142         process group is the BSD one. This means setpgrp needs two arguments
143         whereas USG one needs none.
144
145 d_bsdsetpgrp (d_setpgrp.U):
146         This variable conditionally defines USE_BSD_SETPGRP if
147         setpgrp needs two arguments whereas USG one needs none.
148         See also d_setpgid for a POSIX interface.
149
150 d_bzero (d_bzero.U):
151         This variable conditionally defines the HAS_BZERO symbol if
152         the bzero() routine is available to set memory to 0.
153
154 d_casti32 (d_casti32.U):
155         This variable conditionally defines CASTI32, which indicates
156         whether the C compiler can cast large floats to 32-bit ints.
157
158 d_castneg (d_castneg.U):
159         This variable conditionally defines CASTNEG, which indicates
160         wether the C compiler can cast negative float to unsigned.
161
162 d_charvspr (d_vprintf.U):
163         This variable conditionally defines CHARVSPRINTF if this system
164         has vsprintf returning type (char*).  The trend seems to be to
165         declare it as "int vsprintf()".
166
167 d_chown (d_chown.U):
168         This variable conditionally defines the HAS_CHOWN symbol, which
169         indicates to the C program that the chown() routine is available.
170
171 d_chroot (d_chroot.U):
172         This variable conditionally defines the HAS_CHROOT symbol, which
173         indicates to the C program that the chroot() routine is available.
174
175 d_chsize (d_chsize.U):
176         This variable conditionally defines the CHSIZE symbol, which
177         indicates to the C program that the chsize() routine is available
178         to truncate files.  You might need a -lx to get this routine.
179
180 d_const (d_const.U):
181         This variable conditionally defines the HASCONST symbol, which
182         indicates to the C program that this C compiler knows about the
183         const type.
184
185 d_crypt (d_crypt.U):
186         This variable conditionally defines the CRYPT symbol, which
187         indicates to the C program that the crypt() routine is available
188         to encrypt passwords and the like.
189
190 d_csh (d_csh.U):
191         This variable conditionally defines the CSH symbol, which
192         indicates to the C program that the C-shell exists.
193
194 d_cuserid (d_cuserid.U):
195         This variable conditionally defines the HAS_CUSERID symbol, which
196         indicates to the C program that the cuserid() routine is available
197         to get character login names.
198
199 d_dbl_dig (d_dbl_dig.U):
200         This variable conditionally defines d_dbl_dig if this system's
201         header files provide DBL_DIG, which is the number of significant
202         digits in a double precision number.
203
204 d_difftime (d_difftime.U):
205         This variable conditionally defines the HAS_DIFFTIME symbol, which
206         indicates to the C program that the difftime() routine is available.
207
208 d_dirnamlen (i_dirent.U):
209         This variable conditionally defines DIRNAMLEN, which indicates
210         to the C program that the length of directory entry names is
211         provided by a d_namelen field.
212
213 d_dlerror (d_dlerror.U):
214         This variable conditionally defines the HAS_DLERROR symbol, which
215         indicates to the C program that the dlerror() routine is available.
216
217 d_dlsymun (d_dlsymun.U):
218         This variable conditionally defines DLSYM_NEEDS_UNDERSCORE, which
219         indicates that we need to prepend an underscore to the symbol
220         name before calling dlsym().
221
222 d_dosuid (d_dosuid.U):
223         This variable conditionally defines the symbol DOSUID, which
224         tells the C program that it should insert setuid emulation code
225         on hosts which have setuid #! scripts disabled.
226
227 d_dup2 (d_dup2.U):
228         This variable conditionally defines HAS_DUP2 if dup2() is
229         available to duplicate file descriptors.
230
231 d_eofnblk (nblock_io.U):
232         This variable conditionally defines EOF_NONBLOCK if EOF can be seen
233         when reading from a non-blocking I/O source.
234
235 d_fchmod (d_fchmod.U):
236         This variable conditionally defines the HAS_FCHMOD symbol, which
237         indicates to the C program that the fchmod() routine is available
238         to change mode of opened files.
239
240 d_fchown (d_fchown.U):
241         This variable conditionally defines the HAS_FCHOWN symbol, which
242         indicates to the C program that the fchown() routine is available
243         to change ownership of opened files.
244
245 d_fcntl (d_fcntl.U):
246         This variable conditionally defines the HAS_FCNTL symbol, and indicates
247         whether the fcntl() function exists
248
249 d_fgetpos (d_fgetpos.U):
250         This variable conditionally defines HAS_FGETPOS if fgetpos() is
251         available to get the file position indicator.
252
253 d_flexfnam (d_flexfnam.U):
254         This variable conditionally defines the FLEXFILENAMES symbol, which
255         indicates that the system supports filenames longer than 14 characters.
256
257 d_flock (d_flock.U):
258         This variable conditionally defines HAS_FLOCK if flock() is
259         available to do file locking.
260
261 d_fork (d_fork.U):
262         This variable conditionally defines the HAS_FORK symbol, which
263         indicates to the C program that the fork() routine is available.
264
265 d_fpathconf (d_pathconf.U):
266         This variable conditionally defines the HAS_FPATHCONF symbol, which
267         indicates to the C program that the pathconf() routine is available
268         to determine file-system related limits and options associated
269         with a given open file descriptor.
270
271 d_fsetpos (d_fsetpos.U):
272         This variable conditionally defines HAS_FSETPOS if fsetpos() is
273         available to set the file position indicator.
274
275 d_gethent (d_gethent.U):
276         This variable conditionally defines HAS_GETHOSTENT if gethostent() is
277         available to dup file descriptors.
278
279 d_getlogin (d_getlogin.U):
280         This variable conditionally defines the HAS_GETLOGIN symbol, which
281         indicates to the C program that the getlogin() routine is available
282         to get the login name.
283
284 d_getpgid (d_getpgid.U):
285         This variable conditionally defines the HAS_GETPGID symbol, which
286         indicates to the C program that the getpgid(pid) function
287         is available to get the process group id.
288
289 d_getpgrp (d_getpgrp.U):
290         This variable conditionally defines HAS_GETPGRP if getpgrp() is
291         available to get the current process group.
292
293 d_getpgrp2 (d_getpgrp2.U):
294         This variable conditionally defines the HAS_GETPGRP2 symbol, which
295         indicates to the C program that the getpgrp2() (as in DG/UX) routine
296         is available to get the current process group.
297
298 d_getppid (d_getppid.U):
299         This variable conditionally defines the HAS_GETPPID symbol, which
300         indicates to the C program that the getppid() routine is available
301         to get the parent process ID.
302
303 d_getprior (d_getprior.U):
304         This variable conditionally defines HAS_GETPRIORITY if getpriority()
305         is available to get a process's priority.
306
307 d_htonl (d_htonl.U):
308         This variable conditionally defines HAS_HTONL if htonl() and its
309         friends are available to do network order byte swapping.
310
311 d_index (d_strchr.U):
312         This variable conditionally defines HAS_INDEX if index() and
313         rindex() are available for string searching.
314
315 d_isascii (d_isascii.U):
316         This variable conditionally defines the HAS_ISASCII constant,
317         which indicates to the C program that isascii() is available.
318
319 d_killpg (d_killpg.U):
320         This variable conditionally defines the HAS_KILLPG symbol, which
321         indicates to the C program that the killpg() routine is available
322         to kill process groups.
323
324 d_link (d_link.U):
325         This variable conditionally defines HAS_LINK if link() is
326         available to create hard links.
327
328 d_locconv (d_locconv.U):
329         This variable conditionally defines HAS_LOCALECONV if localeconv() is
330         available for numeric and monetary formatting conventions.
331
332 d_lockf (d_lockf.U):
333         This variable conditionally defines HAS_LOCKF if lockf() is
334         available to do file locking.
335
336 d_lstat (d_lstat.U):
337         This variable conditionally defines HAS_LSTAT if lstat() is
338         available to do file stats on symbolic links.
339
340 d_mblen (d_mblen.U):
341         This variable conditionally defines the HAS_MBLEN symbol, which
342         indicates to the C program that the mblen() routine is available
343         to find the number of bytes in a multibye character.
344
345 d_mbstowcs (d_mbstowcs.U):
346         This variable conditionally defines the HAS_MBSTOWCS symbol, which
347         indicates to the C program that the mbstowcs() routine is available
348         to convert a multibyte string into a wide character string.
349
350 d_mbtowc (d_mbtowc.U):
351         This variable conditionally defines the HAS_MBTOWC symbol, which
352         indicates to the C program that the mbtowc() routine is available
353         to convert multibyte to a wide character.
354
355 d_memcmp (d_memcmp.U):
356         This variable conditionally defines the HAS_MEMCMP symbol, which
357         indicates to the C program that the memcmp() routine is available
358         to compare blocks of memory.
359
360 d_memcpy (d_memcpy.U):
361         This variable conditionally defines the HAS_MEMCPY symbol, which
362         indicates to the C program that the memcpy() routine is available
363         to copy blocks of memory.
364
365 d_memmove (d_memmove.U):
366         This variable conditionally defines the HAS_MEMMOVE symbol, which
367         indicates to the C program that the memmove() routine is available
368         to copy potentatially overlapping blocks of memory.
369
370 d_memset (d_memset.U):
371         This variable conditionally defines the HAS_MEMSET symbol, which
372         indicates to the C program that the memset() routine is available
373         to set blocks of memory.
374
375 d_mkdir (d_mkdir.U):
376         This variable conditionally defines the HAS_MKDIR symbol, which
377         indicates to the C program that the mkdir() routine is available
378         to create directories..
379
380 d_mkfifo (d_mkfifo.U):
381         This variable conditionally defines the HAS_MKFIFO symbol, which
382         indicates to the C program that the mkfifo() routine is available.
383
384 d_mktime (d_mktime.U):
385         This variable conditionally defines the HAS_MKTIME symbol, which
386         indicates to the C program that the mktime() routine is available.
387
388 d_msg (d_msg.U):
389         This variable conditionally defines the HAS_MSG symbol, which
390         indicates that the entire msg*(2) library is present.
391
392 d_mymalloc (mallocsrc.U):
393         This variable conditionally defines MYMALLOC in case other parts
394         of the source want to take special action if MYMALLOC is used.
395         This may include different sorts of profiling or error detection.
396
397 d_nice (d_nice.U):
398         This variable conditionally defines the HAS_NICE symbol, which
399         indicates to the C program that the nice() routine is available.
400
401 d_oldarchlib (oldarchlib.U):
402         This variable conditionally defines OLDARCHLIB to hold the pathname
403         of architecture-dependent library files for a previous
404         version of $package.
405
406 d_open3 (d_open3.U):
407         This variable conditionally defines the HAS_OPEN3 manifest constant,
408         which indicates to the C program that the 3 argument version of
409         the open(2) function is available.
410
411 d_pathconf (d_pathconf.U):
412         This variable conditionally defines the HAS_PATHCONF symbol, which
413         indicates to the C program that the pathconf() routine is available
414         to determine file-system related limits and options associated
415         with a given filename.
416
417 d_pause (d_pause.U):
418         This variable conditionally defines the HAS_PAUSE symbol, which
419         indicates to the C program that the pause() routine is available
420         to suspend a process until a signal is received.
421
422 d_pipe (d_pipe.U):
423         This variable conditionally defines the HAS_PIPE symbol, which
424         indicates to the C program that the pipe() routine is available
425         to create an inter-process channel.
426
427 d_poll (d_poll.U):
428         This variable conditionally defines the HAS_POLL symbol, which
429         indicates to the C program that the poll() routine is available
430         to poll active file descriptors.
431
432 d_pwage (i_pwd.U):
433         This varaible conditionally defines PWAGE, which indicates
434         that struct passwd contains pw_age.
435
436 d_pwchange (i_pwd.U):
437         This varaible conditionally defines PWCHANGE, which indicates
438         that struct passwd contains pw_change.
439
440 d_pwclass (i_pwd.U):
441         This varaible conditionally defines PWCLASS, which indicates
442         that struct passwd contains pw_class.
443
444 d_pwcomment (i_pwd.U):
445         This varaible conditionally defines PWCOMMENT, which indicates
446         that struct passwd contains pw_comment.
447
448 d_pwexpire (i_pwd.U):
449         This varaible conditionally defines PWEXPIRE, which indicates
450         that struct passwd contains pw_expire.
451
452 d_pwquota (i_pwd.U):
453         This varaible conditionally defines PWQUOTA, which indicates
454         that struct passwd contains pw_quota.
455
456 d_readdir (d_readdir.U):
457         This variable conditionally defines HAS_READDIR if readdir() is
458         available to read directory entries.
459
460 d_readlink (d_readlink.U):
461         This variable conditionally defines the HAS_READLINK symbol, which
462         indicates to the C program that the readlink() routine is available
463         to read the value of a symbolic link.
464
465 d_rename (d_rename.U):
466         This variable conditionally defines the HAS_RENAME symbol, which
467         indicates to the C program that the rename() routine is available
468         to rename files.
469
470 d_rewinddir (d_readdir.U):
471         This variable conditionally defines HAS_REWINDDIR if rewinddir() is
472         available.
473
474 d_rmdir (d_rmdir.U):
475         This variable conditionally defines HAS_RMDIR if rmdir() is
476         available to remove directories.
477
478 d_safebcpy (d_safebcpy.U):
479         This variable conditionally defines the HAS_SAFE_BCOPY symbol if
480         the bcopy() routine can do overlapping copies.
481
482 d_safemcpy (d_safemcpy.U):
483         This variable conditionally defines the HAS_SAFE_MEMCPY symbol if
484         the memcpy() routine can do overlapping copies.
485
486 d_seekdir (d_readdir.U):
487         This variable conditionally defines HAS_SEEKDIR if seekdir() is
488         available.
489
490 d_select (d_select.U):
491         This variable conditionally defines HAS_SELECT if select() is
492         available to select active file descriptors. A <sys/time.h>
493         inclusion may be necessary for the timeout field.
494
495 d_sem (d_sem.U):
496         This variable conditionally defines the HAS_SEM symbol, which
497         indicates that the entire sem*(2) library is present.
498
499 d_setegid (d_setegid.U):
500         This variable conditionally defines the HAS_SETEGID symbol, which
501         indicates to the C program that the setegid() routine is available
502         to change the effective gid of the current program.
503
504 d_seteuid (d_seteuid.U):
505         This variable conditionally defines the HAS_SETEUID symbol, which
506         indicates to the C program that the seteuid() routine is available
507         to change the effective uid of the current program.
508
509 d_setlinebuf (d_setlnbuf.U):
510         This variable conditionally defines the HAS_SETLINEBUF symbol, which
511         indicates to the C program that the setlinebuf() routine is available
512         to change stderr or stdout from block-buffered or unbuffered to a
513         line-buffered mode.
514
515 d_setlocale (d_setlocale.U):
516         This variable conditionally defines HAS_SETLOCALE if setlocale() is
517         available to handle locale-specific ctype implementations.
518
519 d_setpgid (d_setpgid.U):
520         This variable conditionally defines the HAS_SETPGID symbol, which
521         indicates to the C program that the setpgid(pid, gpid) function
522         is available to set the process group id.
523
524 d_setpgrp (d_setpgrp.U):
525         This variable conditionally defines HAS_SETPGRP if setpgrp() is
526         available to set the current process group.
527
528 d_setpgrp2 (d_setpgrp2.U):
529         This variable conditionally defines the HAS_SETPGRP2 symbol, which
530         indicates to the C program that the setpgrp2() (as in DG/UX) routine
531         is available to set the current process group.
532
533 d_setprior (d_setprior.U):
534         This variable conditionally defines HAS_SETPRIORITY if setpriority()
535         is available to set a process's priority.
536
537 d_setregid (d_setregid.U):
538         This variable conditionally defines HAS_SETREGID if setregid() is
539         available to change the real and effective gid of the current
540         process.
541
542 d_setresgid (d_setregid.U):
543         This variable conditionally defines HAS_SETRESGID if setresgid() is
544         available to change the real, effective and saved gid of the current
545         process.
546
547 d_setresuid (d_setreuid.U):
548         This variable conditionally defines HAS_SETREUID if setresuid() is
549         available to change the real, effective and saved uid of the current
550         process.
551
552 d_setreuid (d_setreuid.U):
553         This variable conditionally defines HAS_SETREUID if setreuid() is
554         available to change the real and effective uid of the current
555         process.
556
557 d_setrgid (d_setrgid.U):
558         This variable conditionally defines the HAS_SETRGID symbol, which
559         indicates to the C program that the setrgid() routine is available
560         to change the real gid of the current program.
561
562 d_setruid (d_setruid.U):
563         This variable conditionally defines the HAS_SETRUID symbol, which
564         indicates to the C program that the setruid() routine is available
565         to change the real uid of the current program.
566
567 d_setsid (d_setsid.U):
568         This variable conditionally defines HAS_SETSID if setsid() is
569         available to set the process group ID.
570
571 d_sfio (d_sfio.U):
572         This variable conditionally defines the USE_SFIO symbol,
573         and indicates whether sfio is available (and should be used).
574
575 d_shm (d_shm.U):
576         This variable conditionally defines the HAS_SHM symbol, which
577         indicates that the entire shm*(2) library is present.
578
579 d_shmatprototype (d_shmat.U):
580         This variable conditionally defines the HAS_SHMAT_PROTOTYPE 
581         symbol, which indicates that sys/shm.h has a prototype for
582         shmat.
583
584 d_sigaction (d_sigaction.U):
585         This variable conditionally defines the HAS_SIGACTION symbol, which
586         indicates that the Vr4 sigaction() routine is available.
587
588 d_sigsetjmp (d_sigsetjmp.U):
589         This variable conditionally defines the HAS_SIGSETJMP symbol,
590         which indicates that the sigsetjmp() routine is available to
591         call setjmp() and optionally save the process's signal mask.
592
593 d_socket (d_socket.U):
594         This variable conditionally defines HAS_SOCKET, which indicates
595         that the BSD socket interface is supported.
596
597 d_sockpair (d_socket.U):
598         This variable conditionally defines the HAS_SOCKETPAIR symbol, which
599         indicates that the BSD socketpair() is supported.
600
601 d_statblks (d_statblks.U):
602         This variable conditionally defines USE_STAT_BLOCKS if this system
603         has a stat structure declaring st_blksize and st_blocks.
604
605 d_stdio_cnt_lval (d_stdstdio.U):
606         This variable conditionally defines STDIO_CNT_LVALUE if the
607         FILE_cnt macro can be used as an lvalue.
608
609 d_stdio_ptr_lval (d_stdstdio.U):
610         This variable conditionally defines STDIO_PTR_LVALUE if the
611         FILE_ptr macro can be used as an lvalue.
612
613 d_stdiobase (d_stdstdio.U):
614         This variable conditionally defines USE_STDIO_BASE if this system
615         has a FILE structure declaring a usable _base field (or equivalent)
616         in stdio.h.
617
618 d_stdstdio (d_stdstdio.U):
619         This variable conditionally defines USE_STDIO_PTR if this system
620         has a FILE structure declaring usable _ptr and _cnt fields (or
621         equivalent) in stdio.h.
622
623 d_strchr (d_strchr.U):
624         This variable conditionally defines HAS_STRCHR if strchr() and
625         strrchr() are available for string searching.
626
627 d_strcoll (d_strcoll.U):
628         This variable conditionally defines HAS_STRCOLL if strcoll() is
629         available to compare strings using collating information.
630
631 d_strctcpy (d_strctcpy.U):
632         This variable conditionally defines the USE_STRUCT_COPY symbol, which
633         indicates to the C program that this C compiler knows how to copy
634         structures.
635
636 d_strerrm (d_strerror.U):
637         This variable holds what Strerrr is defined as to translate an error
638         code condition into an error message string. It could be 'strerror'
639         or a more complex macro emulating strrror with sys_errlist[], or the
640         "unknown" string when both strerror and sys_errlist are missing.
641
642 d_strerror (d_strerror.U):
643         This variable conditionally defines HAS_STRERROR if strerror() is
644         available to translate error numbers to strings.
645
646 d_strxfrm (d_strxfrm.U):
647         This variable conditionally defines HAS_STRXFRM if strxfrm() is
648         available to transform strings.
649
650 d_suidsafe (d_dosuid.U):
651         This variable conditionally defines SETUID_SCRIPTS_ARE_SECURE_NOW
652         if setuid scripts can be secure.  This test looks in /dev/fd/.
653
654 d_symlink (d_symlink.U):
655         This variable conditionally defines the HAS_SYMLINK symbol, which
656         indicates to the C program that the symlink() routine is available
657         to create symbolic links.
658
659 d_syscall (d_syscall.U):
660         This variable conditionally defines HAS_SYSCALL if syscall() is
661         available call arbitrary system calls.
662
663 d_sysconf (d_sysconf.U):
664         This variable conditionally defines the HAS_SYSCONF symbol, which
665         indicates to the C program that the sysconf() routine is available
666         to determine system related limits and options.
667
668 d_syserrlst (d_strerror.U):
669         This variable conditionally defines HAS_SYS_ERRLIST if sys_errlist[] is
670         available to translate error numbers to strings.
671
672 d_system (d_system.U):
673         This variable conditionally defines HAS_SYSTEM if system() is
674         available to issue a shell command.
675
676 d_tcgetpgrp (d_tcgtpgrp.U):
677         This variable conditionally defines the HAS_TCGETPGRP symbol, which
678         indicates to the C program that the tcgetpgrp() routine is available.
679         to get foreground process group ID.
680
681 d_tcsetpgrp (d_tcstpgrp.U):
682         This variable conditionally defines the HAS_TCSETPGRP symbol, which
683         indicates to the C program that the tcsetpgrp() routine is available
684         to set foreground process group ID.
685
686 d_telldir (d_readdir.U):
687         This variable conditionally defines HAS_TELLDIR if telldir() is
688         available.
689
690 d_times (d_times.U):
691         This variable conditionally defines the HAS_TIMES symbol, which indicates
692         that the times() routine exists.  The times() routine is normaly
693         provided on UNIX systems. You may have to include <sys/times.h>.
694
695 d_truncate (d_truncate.U):
696         This variable conditionally defines HAS_TRUNCATE if truncate() is
697         available to truncate files.
698
699 d_tzname (d_tzname.U):
700         This variable conditionally defines HAS_TZNAME if tzname[] is
701         available to access timezone names.
702
703 d_umask (d_umask.U):
704         This variable conditionally defines the HAS_UMASK symbol, which
705         indicates to the C program that the umask() routine is available.
706         to set and get the value of the file creation mask.
707
708 d_uname (d_gethname.U):
709         This variable conditionally defines the HAS_UNAME symbol, which
710         indicates to the C program that the uname() routine may be
711         used to derive the host name.
712
713 d_vfork (d_vfork.U):
714         This variable conditionally defines the HAS_VFORK symbol, which
715         indicates the vfork() routine is available.
716
717 d_void_closedir (d_closedir.U):
718         This variable conditionally defines VOID_CLOSEDIR if closedir()
719         does not return a value.
720
721 d_volatile (d_volatile.U):
722         This variable conditionally defines the HASVOLATILE symbol, which
723         indicates to the C program that this C compiler knows about the
724         volatile declaration.
725
726 d_vprintf (d_vprintf.U):
727         This variable conditionally defines the HAS_VPRINTF symbol, which
728         indicates to the C program that the vprintf() routine is available
729         to printf with a pointer to an argument list.
730
731 d_wait4 (d_wait4.U):
732         This variable conditionally defines the HAS_WAIT4 symbol, which
733         indicates the wait4() routine is available.
734
735 d_waitpid (d_waitpid.U):
736         This variable conditionally defines HAS_WAITPID if waitpid() is
737         available to wait for child process.
738
739 d_wcstombs (d_wcstombs.U):
740         This variable conditionally defines the HAS_WCSTOMBS symbol, which
741         indicates to the C program that the wcstombs() routine is available
742         to convert wide character strings to multibyte strings.
743
744 d_wctomb (d_wctomb.U):
745         This variable conditionally defines the HAS_WCTOMB symbol, which
746         indicates to the C program that the wctomb() routine is available
747         to convert a wide character to a multibyte.
748
749 db_hashtype (i_db.U):
750         This variable contains the type of the hash structure element
751         in the <db.h> header file.  In older versions of DB, it was
752         int, while in newer ones it is u_int32_t.
753
754 db_prefixtype (i_db.U):
755         This variable contains the type of the prefix structure element
756         in the <db.h> header file.  In older versions of DB, it was
757         int, while in newer ones it is size_t.
758
759 direntrytype (i_dirent.U):
760         This symbol is set to 'struct direct' or 'struct dirent' depending on
761         whether dirent is available or not. You should use this pseudo type to
762         portably declare your directory entries.
763
764 dlext (dlext.U):
765         This variable contains the extension that is to be used for the
766         dynamically loaded modules that perl generaties.
767
768 dlsrc (dlsrc.U):
769         This variable contains the name of the dynamic loading file that
770         will be used with the package.
771
772 dynamic_ext (Extensions.U):
773         This variable holds a list of extension files we want to
774         link dynamically into the package.  It is used by Makefile.
775
776 eagain (nblock_io.U):
777         This variable bears the symbolic errno code set by read() when no
778         data is present on the file and non-blocking I/O was enabled (otherwise,
779         read() blocks naturally).
780
781 eunicefix (Init.U):
782         When running under Eunice this variable contains a command which will
783         convert a shell script to the proper form of text file for it to be
784         executable by the shell.  On other systems it is a no-op.
785
786 exe_ext (Unix.U):
787         This variable defines the extension used for executable files.
788         For unix it is empty.  Other possible values include '.exe'.
789
790 firstmakefile (Unix.U):
791         This variable defines the first file searched by make.  On unix,
792         it is makefile (then Makefile).  On case-insensitive systems,
793         it might be something else.  This is only used to deal with
794         convoluted make depend tricks.
795
796 fpostype (fpostype.U):
797         This variable defines Fpos_t to be something like fpost_t, long, 
798         uint, or whatever type is used to declare file positions in libc.
799
800 freetype (mallocsrc.U):
801         This variable contains the return type of free().  It is usually
802         void, but occasionally int.
803
804 full_csh (d_csh.U):
805         This variable contains the full pathname to 'csh', whether or
806         not the user has specified 'portability'.  This is only used
807         in the compiled C program, and we assume that all systems which
808         can share this executable will have the same full pathname to
809         'csh.'
810
811 full_sed (Loc_sed.U):
812         This variable contains the full pathname to 'sed', whether or
813         not the user has specified 'portability'.  This is only used
814         in the compiled C program, and we assume that all systems which
815         can share this executable will have the same full pathname to
816         'sed.'
817
818 gidtype (gidtype.U):
819         This variable defines Gid_t to be something like gid_t, int,
820         ushort, or whatever type is used to declare the return type
821         of getgid().  Typically, it is the type of group ids in the kernel.
822
823 groupstype (groupstype.U):
824         This variable defines Groups_t to be something like gid_t, int, 
825         ushort, or whatever type is used for the second argument to
826         getgroups().  Usually, this is the same of gidtype, but
827         sometimes it isn't.
828
829 i_dirent (i_dirent.U):
830         This variable conditionally defines I_DIRENT, which indicates
831         to the C program that it should include <dirent.h>.
832
833 i_dlfcn (i_dlfcn.U):
834         This variable conditionally defines the I_DLFCN symbol, which
835         indicates to the C program that <dlfcn.h> exists and should
836         be included.
837
838 i_fcntl (i_fcntl.U):
839         This variable controls the value of I_FCNTL (which tells
840         the C program to include <fcntl.h>).
841
842 i_float (i_float.U):
843         This variable conditionally defines the I_FLOAT symbol, and indicates
844         whether a C program may include <float.h> to get symbols like DBL_MAX
845         or DBL_MIN, i.e. machine dependent floating point values.
846
847 i_grp (i_grp.U):
848         This variable conditionally defines the I_GRP symbol, and indicates
849         whether a C program should include <grp.h>.
850
851 i_limits (i_limits.U):
852         This variable conditionally defines the I_LIMITS symbol, and indicates
853         whether a C program may include <limits.h> to get symbols like WORD_BIT
854         and friends.
855
856 i_locale (i_locale.U):
857         This variable conditionally defines the I_LOCALE symbol,
858         and indicates whether a C program should include <locale.h>.
859
860 i_math (i_math.U):
861         This variable conditionally defines the I_MATH symbol, and indicates
862         whether a C program may include <math.h>.
863
864 i_memory (i_memory.U):
865         This variable conditionally defines the I_MEMORY symbol, and indicates
866         whether a C program should include <memory.h>.
867
868 i_neterrno (i_neterrno.U):
869         This variable conditionally defines the I_NET_ERRNO symbol, which
870         indicates to the C program that <net/errno.h> exists and should
871         be included.
872
873 i_niin (i_niin.U):
874         This variable conditionally defines I_NETINET_IN, which indicates
875         to the C program that it should include <netinet/in.h>. Otherwise,
876         you may try <sys/in.h>.
877
878 i_pwd (i_pwd.U):
879         This variable conditionally defines I_PWD, which indicates
880         to the C program that it should include <pwd.h>.
881
882 i_rpcsvcdbm (i_dbm.U):
883         This variable conditionally defines the I_RPCSVC_DBM symbol, which
884         indicates to the C program that <rpcsvc/dbm.h> exists and should
885         be included.  Some System V systems might need this instead of <dbm.h>.
886
887 i_sfio (i_sfio.U):
888         This variable conditionally defines the I_SFIO symbol,
889         and indicates whether a C program should include <sfio.h>.
890
891 i_sgtty (i_termio.U):
892         This variable conditionally defines the I_SGTTY symbol, which
893         indicates to the C program that it should include <sgtty.h> rather
894         than <termio.h>.
895
896 i_stdarg (i_varhdr.U):
897         This variable conditionally defines the I_STDARG symbol, which
898         indicates to the C program that <stdarg.h> exists and should
899         be included.
900
901 i_stddef (i_stddef.U):
902         This variable conditionally defines the I_STDDEF symbol, which
903         indicates to the C program that <stddef.h> exists and should
904         be included.
905
906 i_stdlib (i_stdlib.U):
907         This variable conditionally defines the I_STDLIB symbol, which
908         indicates to the C program that <stdlib.h> exists and should
909         be included.
910
911 i_string (i_string.U):
912         This variable conditionally defines the I_STRING symbol, which
913         indicates that <string.h> should be included rather than <strings.h>.
914
915 i_sysdir (i_sysdir.U):
916         This variable conditionally defines the I_SYS_DIR symbol, and indicates
917         whether a C program should include <sys/dir.h>.
918
919 i_sysfile (i_sysfile.U):
920         This variable conditionally defines the I_SYS_FILE symbol, and indicates
921         whether a C program should include <sys/file.h> to get R_OK and friends.
922
923 i_sysioctl (i_sysioctl.U):
924         This variable conditionally defines the I_SYS_IOCTL symbol, which
925         indicates to the C program that <sys/ioctl.h> exists and should
926         be included.
927
928 i_sysndir (i_sysndir.U):
929         This variable conditionally defines the I_SYS_NDIR symbol, and indicates
930         whether a C program should include <sys/ndir.h>.
931
932 i_sysparam (i_sysparam.U):
933         This variable conditionally defines the I_SYS_PARAM symbol, and indicates
934         whether a C program should include <sys/param.h>.
935
936 i_sysresrc (i_sysresrc.U):
937         This variable conditionally defines the I_SYS_RESOURCE symbol,
938         and indicates whether a C program should include <sys/resource.h>.
939
940 i_sysselct (i_sysselct.U):
941         This variable conditionally defines I_SYS_SELECT, which indicates
942         to the C program that it should include <sys/select.h> in order to
943         get the definition of struct timeval.
944
945 i_sysstat (i_sysstat.U):
946         This variable conditionally defines the I_SYS_STAT symbol,
947         and indicates whether a C program should include <sys/stat.h>.
948
949 i_systime (i_time.U):
950         This variable conditionally defines I_SYS_TIME, which indicates
951         to the C program that it should include <sys/time.h>.
952
953 i_systimek (i_time.U):
954         This variable conditionally defines I_SYS_TIME_KERNEL, which
955         indicates to the C program that it should include <sys/time.h>
956         with KERNEL defined.
957
958 i_systimes (i_systimes.U):
959         This variable conditionally defines the I_SYS_TIMES symbol, and indicates
960         whether a C program should include <sys/times.h>.
961
962 i_systypes (i_systypes.U):
963         This variable conditionally defines the I_SYS_TYPES symbol,
964         and indicates whether a C program should include <sys/types.h>.
965
966 i_sysun (i_sysun.U):
967         This variable conditionally defines I_SYS_UN, which indicates
968         to the C program that it should include <sys/un.h> to get UNIX
969         domain socket definitions.
970
971 i_syswait (i_syswait.U):
972         This variable conditionally defines I_SYS_WAIT, which indicates
973         to the C program that it should include <sys/wait.h>.
974
975 i_termio (i_termio.U):
976         This variable conditionally defines the I_TERMIO symbol, which
977         indicates to the C program that it should include <termio.h> rather
978         than <sgtty.h>.
979
980 i_termios (i_termio.U):
981         This variable conditionally defines the I_TERMIOS symbol, which
982         indicates to the C program that the POSIX <termios.h> file is
983         to be included.
984
985 i_time (i_time.U):
986         This variable conditionally defines I_TIME, which indicates
987         to the C program that it should include <time.h>.
988
989 i_unistd (i_unistd.U):
990         This variable conditionally defines the I_UNISTD symbol, and indicates
991         whether a C program should include <unistd.h>.
992
993 i_utime (i_utime.U):
994         This variable conditionally defines the I_UTIME symbol, and indicates
995         whether a C program should include <utime.h>.
996
997 i_values (i_values.U):
998         This variable conditionally defines the I_VALUES symbol, and indicates
999         whether a C program may include <values.h> to get symbols like MAXLONG
1000         and friends.
1001
1002 i_varargs (i_varhdr.U):
1003         This variable conditionally defines I_VARARGS, which indicates
1004         to the C program that it should include <varargs.h>.
1005
1006 i_varhdr (i_varhdr.U):
1007         Contains the name of the header to be included to get va_dcl definition.
1008         Typically one of varargs.h or stdarg.h.
1009
1010 i_vfork (i_vfork.U):
1011         This variable conditionally defines the I_VFORK symbol, and indicates
1012         whether a C program should include vfork.h.
1013
1014 installbin (bin.U):
1015         This variable is the same as binexp unless AFS is running in which case
1016         the user is explicitely prompted for it. This variable should always
1017         be used in your makefiles for maximum portability.
1018
1019 installprivlib (privlib.U):
1020         This variable is really the same as privlibexp but may differ on
1021         those systems using AFS. For extra portability, only this variable
1022         should be used in makefiles.
1023
1024 intsize (intsize.U):
1025         This variable contains the value of the INTSIZE symbol,
1026         which indicates to the C program how many bytes there are
1027         in an integer.
1028
1029 large (models.U):
1030         This variable contains a flag which will tell the C compiler and loader
1031         to produce a program running with a large memory model.  It is up to
1032         the Makefile to use this.
1033
1034 ld (dlsrc.U):
1035         This variable indicates the program to be used to link
1036         libraries for dynamic loading.  On some systems, it is 'ld'.
1037         On ELF systems, it should be $cc.  Mostly, we'll try to respect
1038         the hint file setting.
1039
1040 lddlflags (dlsrc.U):
1041         This variable contains any special flags that might need to be
1042         passed to $ld to create a shared library suitable for dynamic
1043         loading.  It is up to the makefile to use it.  For hpux, it
1044         should be -b.  For sunos 4.1, it is empty.
1045
1046 ldflags (ccflags.U):
1047         This variable contains any additional C loader flags desired by
1048         the user.  It is up to the Makefile to use this.
1049
1050 lib_ext (Unix.U):
1051         This variable defines the extension used for ordinary libraries.
1052         For unix, it is '.a'.  The '.' is included.  Other possible
1053         values include '.lib'.
1054
1055 libperl (libperl.U):
1056         The perl executable is obtained by linking perlmain.c with
1057         libperl, any static extensions (usually just DynaLoader),
1058         and any other libraries needed on this system.  libperl
1059         is usually libperl.a, but can also be libperl.so.xxx if
1060         the user wishes to build a perl executable with a shared
1061         library.
1062
1063 libs (libs.U):
1064         This variable holds the additional libraries we want to use.
1065         It is up to the Makefile to deal with it.
1066
1067 lns (lns.U):
1068         This variable holds the name of the command to make 
1069         symbolic links (if they are supported).  It can be used
1070         in the Makefile. It is either 'ln -s' or 'ln'
1071
1072 lseektype (lseektype.U):
1073         This variable defines lseektype to be something like off_t, long, 
1074         or whatever type is used to declare lseek offset's type in the
1075         kernel (which also appears to be lseek's return type).
1076
1077 make (make.U):
1078         This variable sets the path to the 'make' command.  It is
1079         here rather than in Loc.U so that users can override it
1080         with  Configure -Dmake=pmake, or equivalent.
1081
1082 make_set_make (make.U):
1083         Some versions of 'make' set the variable MAKE.  Others do not.
1084         This variable contains the string to be included in Makefile.SH
1085         so that MAKE is set if needed, and not if not needed.
1086         Possible values are:
1087         make_set_make='#'       # If your make program handles this for you,
1088         make_set_make=$make     # if it doesn't.
1089         I used a comment character so that we can distinguish a
1090         'set' value (from a previous config.sh or Configure -D option)
1091         from an uncomputed value.
1092
1093 mallocobj (mallocsrc.U):
1094         This variable contains the name of the malloc.o that this package
1095         generates, if that malloc.o is preferred over the system malloc.
1096         Otherwise the value is null.  This variable is intended for generating
1097         Makefiles.  See mallocsrc.
1098
1099 mallocsrc (mallocsrc.U):
1100         This variable contains the name of the malloc.c that comes with
1101         the package, if that malloc.c is preferred over the system malloc.
1102         Otherwise the value is null.  This variable is intended for generating
1103         Makefiles.
1104
1105 malloctype (mallocsrc.U):
1106         This variable contains the kind of ptr returned by malloc and realloc.
1107
1108 man1dir (man1dir.U):
1109         This variable contains the name of the directory in which manual
1110         source pages are to be put.  It is the responsibility of the
1111         Makefile.SH to get the value of this into the proper command.
1112         You must be prepared to do the ~name expansion yourself.
1113
1114 man1ext (man1dir.U):
1115         This variable contains the extension that the manual page should
1116         have: one of 'n', 'l', or '1'.  The Makefile must supply the '.'.
1117         See man1dir.
1118
1119 man3dir (man3dir.U):
1120         This variable contains the name of the directory in which manual
1121         source pages are to be put.  It is the responsibility of the
1122         Makefile.SH to get the value of this into the proper command.
1123         You must be prepared to do the ~name expansion yourself.
1124
1125 man3ext (man3dir.U):
1126         This variable contains the extension that the manual page should
1127         have: one of 'n', 'l', or '3'.  The Makefile must supply the '.'.
1128         See man3dir.
1129
1130 modetype (modetype.U):
1131         This variable defines modetype to be something like mode_t, 
1132         int, unsigned short, or whatever type is used to declare file 
1133         modes for system calls.
1134
1135 n (n.U):
1136         This variable contains the -n flag if that is what causes the echo
1137         command to suppress newline.  Otherwise it is null.  Correct usage is
1138             $echo $n "prompt for a question: $c".
1139
1140 o_nonblock (nblock_io.U):
1141         This variable bears the symbol value to be used during open() or fcntl()
1142         to turn on non-blocking I/O for a file descriptor. If you wish to switch
1143         between blocking and non-blocking, you may try ioctl(FIOSNBIO) instead,
1144         but that is only supported by some devices.
1145
1146 oldarchlib (oldarchlib.U):
1147         This variable holds the name of the directory in which perl5.000
1148         and perl5.001 stored 
1149         architecture-dependent public library files.
1150
1151 oldarchlibexp (oldarchlib.U):
1152         This variable is the same as the oldarchlib variable, but is 
1153         filename expanded at configuration time, for convenient use.
1154
1155 optimize (ccflags.U):
1156         This variable contains any optimizer/debugger flag that should be used.
1157         It is up to the Makefile to use it.
1158
1159 osname (Oldconfig.U):
1160         This variable contains the operating system name (e.g. sunos,
1161         solaris, hpux, etc.).  It can be useful later on for setting
1162         defaults.  Any spaces are replaced with underscores.  It is set
1163         to a null string if we can't figure it out.
1164
1165 pager (pager.U):
1166         This variable contains the name of the preferred pager on the system.
1167         Usual values are (the full pathnames of) more, less, pg, or cat.
1168
1169 path_sep (Unix.U):
1170         This variable defines the character used to separate elements in
1171         the shell's PATH environment variable.  On Unix, it is ':'.
1172         This is probably identical to Head.U's p_ variable and can
1173         probably be dropped.
1174
1175 perladmin (perladmin.U):
1176         Electronic mail address of the perl5 administrator.
1177
1178 prefix (prefix.U):
1179         This variable holds the name of the directory below which the
1180         user will install the package.  Usually, this is /usr/local, and
1181         executables go in /usr/local/bin, library stuff in /usr/local/lib,
1182         man pages in /usr/local/man, etc.  It is only used to set defaults
1183         for things in bin.U, mansrc.U, privlib.U, or scriptdir.U.
1184
1185 privlib (privlib.U):
1186         This variable contains the eventual value of the PRIVLIB symbol,
1187         which is the name of the private library for this package.  It may
1188         have a ~ on the front. It is up to the makefile to eventually create
1189         this directory while performing installation (with ~ substitution).
1190
1191 privlibexp (privlib.U):
1192         This variable is the ~name expanded version of privlib, so that you
1193         may use it directly in Makefiles or shell scripts.
1194
1195 prototype (prototype.U):
1196         This variable holds the eventual value of CAN_PROTOTYPE, which
1197         indicates the C compiler can handle funciton prototypes.
1198
1199 randbits (randbits.U):
1200         This variable contains the eventual value of the RANDBITS symbol,
1201         which indicates to the C program how many bits of random number
1202         the rand() function produces.
1203
1204 ranlib (orderlib.U):
1205         This variable is set to the pathname of the ranlib program, if it is
1206         needed to generate random libraries.  Set to ":" if ar can generate
1207         random libraries or if random libraries are not supported
1208
1209 rd_nodata (nblock_io.U):
1210         This variable holds the return code from read() when no data is
1211         present. It should be -1, but some systems return 0 when O_NDELAY is
1212         used, which is a shame because you cannot make the difference between
1213         no data and an EOF.. Sigh!
1214
1215 scriptdir (scriptdir.U):
1216         This variable holds the name of the directory in which the user wants
1217         to put publicly scripts for the package in question.  It is either
1218         the same directory as for binaries, or a special one that can be
1219         mounted across different architectures, like /usr/share. Programs
1220         must be prepared to deal with ~name expansion.
1221
1222 selecttype (selecttype.U):
1223         This variable holds the type used for the 2nd, 3rd, and 4th
1224         arguments to select.  Usually, this is 'fd_set *', if HAS_FD_SET
1225         is defined, and 'int *' otherwise.  This is only useful if you 
1226         have select(), naturally.
1227
1228 sh (sh.U):
1229         This variable contains the full pathname of the shell used
1230         on this system to execute Bourne shell scripts.  Usually, this will be
1231         /bin/sh, though it's possible that some systems will have /bin/ksh,
1232         /bin/pdksh, /bin/ash, /bin/bash, or even something such as
1233         D:/bin/sh.exe.
1234         This unit comes before Options.U, so you can't set sh with a -D
1235         option, though you can override this (and startsh)
1236         with -O -Dsh=/bin/whatever -Dstartsh=whatever
1237
1238 shmattype (d_shmat.U):
1239         This symbol contains the type of pointer returned by shmat().
1240         It can be 'void *' or 'char *'.
1241
1242 shrpenv (libperl.U):
1243         If the user builds a shared libperl.so, then we need to tell the
1244         'perl' executable where it will be able to find the installed libperl.so. 
1245         One way to do this on some systems is to set the environment variable
1246         LD_RUN_PATH to the directory that will be the final location of the
1247         shared libperl.so.  The makefile can use this with something like
1248                 $shrpenv $(CC) -o perl perlmain.o $libperl $libs
1249         Typical values are
1250                 shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
1251         or
1252                 shrpenv=''
1253         See the main perl Makefile.SH for actual working usage.
1254         Alternatively, we might be able to use a command line option such
1255         as -R $archlibexp/CORE (Solaris, NetBSD) or -Wl,-rpath
1256         $archlibexp/CORE (Linux).
1257
1258 sig_name (sig_name.U):
1259         This variable holds the signal names, space separated. The leading
1260         SIG in signals name is removed. See sig_num.
1261
1262 sig_num (sig_name.U):
1263         This variable holds the signal numbers, space separated. Those numbers
1264         correspond to the value of the signal listed in the same place within
1265         the sig_name list.
1266
1267 signal_t (d_voidsig.U):
1268         This variable holds the type of the signal handler (void or int).
1269
1270 sitearch (sitearch.U):
1271         This variable contains the eventual value of the SITEARCH symbol,
1272         which is the name of the private library for this package.  It may
1273         have a ~ on the front. It is up to the makefile to eventually create
1274         this directory while performing installation (with ~ substitution).
1275
1276 sitearchexp (sitearch.U):
1277         This variable is the ~name expanded version of sitearch, so that you
1278         may use it directly in Makefiles or shell scripts.
1279
1280 sitelib (sitelib.U):
1281         This variable contains the eventual value of the SITELIB symbol,
1282         which is the name of the private library for this package.  It may
1283         have a ~ on the front. It is up to the makefile to eventually create
1284         this directory while performing installation (with ~ substitution).
1285
1286 sitelibexp (sitelib.U):
1287         This variable is the ~name expanded version of sitelib, so that you
1288         may use it directly in Makefiles or shell scripts.
1289
1290 sizetype (sizetype.U):
1291         This variable defines sizetype to be something like size_t, 
1292         unsigned long, or whatever type is used to declare length 
1293         parameters for string functions.
1294
1295 small (models.U):
1296         This variable contains a flag which will tell the C compiler and loader
1297         to produce a program running with a small memory model.  It is up to
1298         the Makefile to use this.
1299
1300 spitshell (spitshell.U):
1301         This variable contains the command necessary to spit out a runnable
1302         shell on this system.  It is either cat or a grep -v for # comments.
1303
1304 split (models.U):
1305         This variable contains a flag which will tell the C compiler and loader
1306         to produce a program that will run in separate I and D space, for those
1307         machines that support separation of instruction and data space.  It is
1308         up to the Makefile to use this.
1309
1310 ssizetype (ssizetype.U):
1311         This variable defines ssizetype to be something like ssize_t, 
1312         long or int.  It is used by functions that return a count 
1313         of bytes or an error condition.  It must be a signed type.
1314         We will pick a type such that sizeof(SSize_t) == sizeof(Size_t).
1315
1316 startperl (startperl.U):
1317         This variable contains the string to put on the front of a perl
1318         script to make sure (hopefully) that it runs with perl and not some
1319         shell. Of course, that leading line must be followed by the classical
1320         perl idiom:
1321                 eval 'exec perl -S $0 "$@"'
1322                         if $running_under_some_shell;
1323         to guarantee perl startup should the shell execute the script. Note
1324         that this magic incatation is not understood by csh.
1325
1326 startsh (startsh.U):
1327         This variable contains the string to put on the front of a shell
1328         script to make sure (hopefully) that it runs with sh and not some
1329         other shell.
1330
1331 static_ext (Extensions.U):
1332         This variable holds a list of extension files we want to
1333         link statically into the package.  It is used by Makefile.
1334
1335 stdchar (stdchar.U):
1336         This variable conditionally defines STDCHAR to be the type of char
1337         used in stdio.h.  It has the values "unsigned char" or "char".
1338
1339 timetype (d_time.U):
1340         This variable holds the type returned by time(). It can be long,
1341         or time_t on BSD sites (in which case <sys/types.h> should be
1342         included). Anyway, the type Time_t should be used.
1343
1344 uidtype (uidtype.U):
1345         This variable defines Uid_t to be something like uid_t, int, 
1346         ushort, or whatever type is used to declare user ids in the kernel.
1347
1348 useperlio (useperlio.U):
1349         This variable conditionally defines the USE_PERLIO symbol,
1350         and indicates that the PerlIO abstraction should be
1351         used throughout.
1352
1353 useshrplib (libperl.U):
1354         This variable is set to 'yes' if the user wishes
1355         to build a shared libperl, and 'no' otherwise.
1356
1357 voidflags (voidflags.U):
1358         This variable contains the eventual value of the VOIDFLAGS symbol,
1359         which indicates how much support of the void type is given by this
1360         compiler.  See VOIDFLAGS for more info.
1361