]> git.pld-linux.org Git - packages/autoconf.git/blob - autoconf-man.patch
- added x patch (fix libX11 detection without xmkmf and libXt
[packages/autoconf.git] / autoconf-man.patch
1 --- autoconf-2.13.orig/autoconf.1
2 +++ autoconf-2.13/autoconf.1
3 @@ -0,0 +1,126 @@
4 +.\" Copyright (C) 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
5 +.\" Copyright (C) 1998 Ben Pfaff.
6 +.\"
7 +.\" Permission is granted to make and distribute verbatim copies of
8 +.\" this manual provided the copyright notice and this permission notice
9 +.\" are preserved on all copies.
10 +.\" 
11 +.\" Permission is granted to copy and distribute modified versions of this
12 +.\" manual under the conditions for verbatim copying, provided that the entire
13 +.\" resulting derived work is distributed under the terms of a permission
14 +.\" notice identical to this one.
15 +.\" 
16 +.\" Permission is granted to copy and distribute translations of this manual
17 +.\" into another language, under the above conditions for modified versions,
18 +.\" except that this permission notice may be stated in a translation approved
19 +.\" by the Foundation.
20 +.\"
21 +.TH AUTOCONF 1 "Autoconf"
22 +.SH NAME
23 +autoconf - creates scripts to configure source code packages using templates
24 +.SH SYNOPSIS
25 +.B autoconf
26 +[
27 +.B --help
28 +|
29 +.B -h
30 +] [
31 +.B --localdir=dir
32 +|
33 +.B -l dir
34 +] [
35 +.B --macrodir=dir
36 +|
37 +.B -m dir
38 +] [
39 +.B --version
40 +]
41 +.SH DESCRIPTION
42 +.PP
43 +To create 
44 +.B configure
45 +from 
46 +.BR configure.in , run the 
47 +.B autoconf
48 +program with no arguments.  
49 +.B autoconf
50 +processes 
51 +.B configure.in
52 +with
53 +the 
54 +.B m4
55 +macro processor, using the Autoconf macros.  If you give
56 +.B autoconf
57 +an argument, it reads that file instead of 
58 +.B configure.in
59 +and writes the configuration script to the standard output instead of
60 +to 
61 +.B configure
62 +.  If you give 
63 +.B autoconf
64 +the argument 
65 +.BR - ,
66 +it reads the
67 +standard input instead of 
68 +.B configure.in
69 +and writes the configuration
70 +script on the standard output.
71 +.PP
72 +The Autoconf macros are defined in several files.  Some of the files
73 +are distributed with Autoconf; 
74 +.B autoconf
75 +reads them first.  Then it
76 +looks for the optional file 
77 +.B acsite.m4
78 +in the directory that contains
79 +the distributed Autoconf macro files, and for the optional file
80 +.B aclocal.m4
81 +in the current directory.  Those files can contain your
82 +site's or the package's own Autoconf macro definitions.  If a macro is
83 +defined in more than one of the files that 
84 +.B autoconf
85 +reads, the last
86 +definition it reads overrides the earlier ones.
87 +.PP
88 +
89 +.B autoconf
90 +accepts the following options:
91 +.TP
92 +.BI --help
93 +.TP
94 +.BI -h
95 +Print a summary of the command line options and exit.
96 +.TP
97 +.BI --localdir=DIR
98 +.TP
99 +.BI -l\ DIR
100 +Look for the package file 
101 +.B aclocal.m4
102 +in directory DIR instead of
103 +in the current directory.
104 +.TP
105 +.BI --macrodir=DIR
106 +.TP
107 +.BI -m\ DIR
108 +Look for the installed macro files in directory DIR.  You can also
109 +set the 
110 +.B AC_MACRODIR
111 +environment variable to a directory; this
112 +option overrides the environment variable.
113 +.TP
114 +.BI --version
115 +Print the version number of Autoconf and exit.
116 +.PP
117 +.SH "SEE ALSO"
118 +.BR autoheader (1),
119 +.BR autoreconf (1),
120 +.BR autoscan (1),
121 +.BR autoupdate (1),
122 +.BR ifnames (1)
123 +.SH AUTHORS
124 +David MacKenzie, with help from Franc,ois Pinard, Karl Berry, Richard
125 +Pixley, Ian Lance Taylor, Roland McGrath, Noah Friedman, David
126 +D. Zuhn, and many others.  This manpage written by Ben Pfaff
127 +<pfaffben@pilot.msu.edu> for the Debian GNU/Linux
128 +.B autoconf
129 +package.
130 --- autoconf-2.13.orig/autoheader.1
131 +++ autoconf-2.13/autoheader.1
132 @@ -0,0 +1,197 @@
133 +.\" Copyright (C) 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
134 +.\" Copyright (C) 1998 Ben Pfaff.
135 +.\"
136 +.\" Permission is granted to make and distribute verbatim copies of
137 +.\" this manual provided the copyright notice and this permission notice
138 +.\" are preserved on all copies.
139 +.\" 
140 +.\" Permission is granted to copy and distribute modified versions of this
141 +.\" manual under the conditions for verbatim copying, provided that the entire
142 +.\" resulting derived work is distributed under the terms of a permission
143 +.\" notice identical to this one.
144 +.\" 
145 +.\" Permission is granted to copy and distribute translations of this manual
146 +.\" into another language, under the above conditions for modified versions,
147 +.\" except that this permission notice may be stated in a translation approved
148 +.\" by the Foundation.
149 +.\"
150 +.TH AUTOHEADER 1 "Autoconf"
151 +.SH NAME
152 +autoheader - creates a template file of C #define's for use by
153 +configure.
154 +.SH SYNOPSIS
155 +.B autoheader
156 +[
157 +.B --help
158 +|
159 +.B -h
160 +] [
161 +.B --localdir=dir
162 +|
163 +.B -l dir
164 +] [
165 +.B --macrodir=dir
166 +|
167 +.B -m dir
168 +] [
169 +.B --version
170 +]
171 +.SH DESCRIPTION
172 +.PP
173 +The 
174 +.B autoheader
175 +program can create a template file of C 
176 +.B #define
177 +statements for 
178 +.B configure
179 +to use.  If 
180 +.B configure.in
181 +invokes
182 +.BR AC_CONFIG_HEADER(FILE) , 
183 +.B autoheader
184 +creates 
185 +.BR FILE.in ; 
186 +if multiple
187 +file arguments are given, the first one is used.  Otherwise,
188 +.B autoheader
189 +creates 
190 +.BR config.h.in .
191 +.PP
192 +If you give 
193 +.B autoheader
194 +an argument, it uses that file instead of
195 +.B configure.in
196 +and writes the header file to the standard output
197 +instead of to 
198 +.B config.h.in
199 +.  If you give 
200 +.B autoheader
201 +an argument of
202 +.BR - , 
203 +it reads the standard input instead of 
204 +.B configure.in
205 +and writes
206 +the header file to the standard output.
207 +.PP
208 +.B autoheader
209 +scans 
210 +.B configure.in
211 +and figures out which C
212 +preprocessor symbols it might define.  It copies comments and 
213 +.B #define
214 +and 
215 +.B #undef
216 +statements from a file called 
217 +.BR acconfig.h , 
218 +which comes
219 +with and is installed with Autoconf.  It also uses a file called
220 +.B acconfig.h
221 +in the current directory, if present.  If you 
222 +.B AC_DEFINE
223 +any additional symbols, you must create that file with entries for
224 +them.  For symbols defined by 
225 +.BR AC_CHECK_HEADERS , 
226 +.BR AC_CHECK_FUNCS ,
227 +.BR AC_CHECK_SIZEOF , 
228 +or 
229 +.BR AC_CHECK_LIB , 
230 +.B autoheader
231 +generates comments
232 +and 
233 +.B #undef
234 +statements itself rather than copying them from a file,
235 +since the possible symbols are effectively limitless.
236 +.PP
237 +The file that 
238 +.B autoheader
239 +creates contains mainly 
240 +.B #define
241 +and
242 +.B #undef
243 +statements and their accompanying comments.  If 
244 +.B ./acconfig.h
245 +contains the string 
246 +.BR @TOP@ , 
247 +.B autoheader
248 +copies the lines before the
249 +line containing 
250 +.B @TOP@
251 +into the top of the file that it generates.
252 +Similarly, if 
253 +.B ./acconfig.h
254 +contains the string 
255 +.BR @BOTTOM@ ,
256 +.B autoheader
257 +copies the lines after that line to the end of the file it
258 +generates.  Either or both of those strings may be omitted.
259 +.PP
260 +An alternate way to produce the same effect is to create the files
261 +.B FILE.top
262 +(typically 
263 +.BR config.h.top ) 
264 +and/or 
265 +.B FILE.bot
266 +in the current
267 +directory.  If they exist, 
268 +.B autoheader
269 +copies them to the beginning
270 +and end, respectively, of its output.  Their use is discouraged because
271 +they have file names that contain two periods, and so can not be stored
272 +on MS-DOS; also, they are two more files to clutter up the directory.
273 +But if you use the 
274 +.B --localdir=DIR
275 +option to use an 
276 +.B acconfig.h
277 +in
278 +another directory, they give you a way to put custom boilerplate in each
279 +individual 
280 +.BR config.h.in .
281 +.PP
282 +.B autoheader
283 +accepts the following options:
284 +.TP
285 +.BI --help
286 +.TP
287 +.BI -h
288 +Print a summary of the command line options and exit.
289 +.TP
290 +.BI --localdir=DIR
291 +.TP
292 +.BI -l\ DIR
293 +Look for the package files 
294 +.B aclocal.m4
295 +and 
296 +.B acconfig.h
297 +(but not
298 +.B FILE.top
299 +and 
300 +.BR FILE.bot ) 
301 +in directory DIR instead of in the current
302 +directory.
303 +.TP
304 +.BI --macrodir=DIR
305 +.TP
306 +.BI -m\ DIR
307 +Look for the installed macro files and 
308 +.B acconfig.h
309 +in directory DIR.
310 +You can also set the 
311 +.B AC_MACRODIR
312 +environment variable to a
313 +directory; this option overrides the environment variable.
314 +.TP
315 +.BI --version
316 +Print the version number of Autoconf and exit.
317 +.SH "SEE ALSO"
318 +.BR autoconf (1),
319 +.BR autoreconf (1),
320 +.BR autoscan (1),
321 +.BR autoupdate (1),
322 +.BR ifnames (1)
323 +.SH AUTHORS
324 +David MacKenzie, with help from Franc,ois Pinard, Karl Berry, Richard
325 +Pixley, Ian Lance Taylor, Roland McGrath, Noah Friedman, David
326 +D. Zuhn, and many others.  This manpage written by Ben Pfaff
327 +<pfaffben@pilot.msu.edu> for the Debian GNU/Linux
328 +.B autoconf
329 +package.
330 --- autoconf-2.13.orig/autoreconf.1
331 +++ autoconf-2.13/autoreconf.1
332 @@ -0,0 +1,165 @@
333 +.\" Copyright (C) 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
334 +.\" Copyright (C) 1998 Ben Pfaff.
335 +.\"
336 +.\" Permission is granted to make and distribute verbatim copies of
337 +.\" this manual provided the copyright notice and this permission notice
338 +.\" are preserved on all copies.
339 +.\" 
340 +.\" Permission is granted to copy and distribute modified versions of this
341 +.\" manual under the conditions for verbatim copying, provided that the entire
342 +.\" resulting derived work is distributed under the terms of a permission
343 +.\" notice identical to this one.
344 +.\" 
345 +.\" Permission is granted to copy and distribute translations of this manual
346 +.\" into another language, under the above conditions for modified versions,
347 +.\" except that this permission notice may be stated in a translation approved
348 +.\" by the Foundation.
349 +.\"
350 +.TH AUTORECONF 1 "Autoconf"
351 +.SH NAME
352 +autoreconf - update configure scripts
353 +.SH SYNOPSIS
354 +.B autoreconf
355 +[
356 +.B --help
357 +|
358 +.B -h
359 +] [
360 +.B --force
361 +|
362 +.B -f
363 +] [
364 +.B --localdir=dir
365 +|
366 +.B -l dir
367 +] [
368 +.B --macrodir=dir
369 +|
370 +.B -m dir
371 +] [
372 +.B --verbose
373 +] [
374 +.B --version
375 +]
376 +.SH DESCRIPTION
377 +.PP
378 +If you have a lot of Autoconf-generated 
379 +.B configure
380 +scripts, the
381 +.B autoreconf
382 +program can save you some work.  It runs 
383 +.B autoconf
384 +(and
385 +.BR autoheader , 
386 +where appropriate) repeatedly to remake the Autoconf
387 +.B configure
388 +scripts and configuration header templates in the directory
389 +tree rooted at the current directory.  By default, it only remakes
390 +those files that are older than their 
391 +.B configure.in
392 +or (if present)
393 +.BR aclocal.m4 .  
394 +Since 
395 +.B autoheader
396 +does not change the timestamp of its
397 +output file if the file wouldn't be changing, this is not necessarily
398 +the minimum amount of work.  If you install a new version of Autoconf,
399 +you can make 
400 +.B autoreconf
401 +remake 
402 +.I all
403 +of the files by giving it the
404 +.B --force
405 +option.
406 +.PP
407 +If you give 
408 +.B autoreconf
409 +the 
410 +.B --macrodir=DIR
411 +or 
412 +.B --localdir=DIR
413 +options, it passes them down to 
414 +.B autoconf
415 +and 
416 +.B autoheader
417 +(with
418 +relative paths adjusted properly).
419 +.PP
420 +.B autoreconf
421 +does not support having, in the same directory tree,
422 +both directories that are parts of a larger package (sharing
423 +.B aclocal.m4
424 +and 
425 +.BR acconfig.h ), 
426 +and directories that are independent
427 +packages (each with their own 
428 +.B aclocal.m4
429 +and 
430 +.BR acconfig.h ).  
431 +It
432 +assumes that they are all part of the same package, if you use
433 +.BR --localdir , 
434 +or that each directory is a separate package, if you
435 +don't use it.  This restriction may be removed in the future.
436 +.PP
437 +.B autoreconf
438 +accepts the following options:
439 +.TP
440 +.BI --help
441 +.TP
442 +.BI -h
443 +Print a summary of the command line options and exit.
444 +.TP
445 +.BI --force
446 +.TP
447 +.BI -f
448 +Remake even 
449 +.B configure
450 +scripts and configuration headers that are
451 +newer than their input files
452 +.RB ( configure.in
453 +and, if present,
454 +.BR aclocal.m4 ).
455 +.TP
456 +.BI --localdir=DIR
457 +.TP
458 +.BI -l\ DIR
459 +Look for the package file 
460 +.B aclocal.m4
461 +in directory DIR instead of
462 +in the current directory.
463 +.TP
464 +.BI --macrodir=DIR
465 +.TP
466 +.BI -m\ DIR
467 +Look for the installed macro files in directory DIR.  You can also
468 +set the 
469 +.B AC_MACRODIR
470 +environment variable to a directory; this
471 +option overrides the environment variable.
472 +.TP
473 +.BI --verbose
474 +Print the name of each directory where 
475 +.B autoreconf
476 +runs
477 +.B autoconf
478 +(and 
479 +.BR autoheader , 
480 +if appropriate).
481 +.TP
482 +.BI --version
483 +Print the version number of Autoconf and exit.
484 +.PP
485 +.SH "SEE ALSO"
486 +.BR autoconf (1),
487 +.BR autoheader (1),
488 +.BR autoscan (1),
489 +.BR autoupdate (1),
490 +.BR ifnames (1)
491 +.SH AUTHORS
492 +David MacKenzie, with help from Franc,ois Pinard, Karl Berry, Richard
493 +Pixley, Ian Lance Taylor, Roland McGrath, Noah Friedman, David
494 +D. Zuhn, and many others.  This manpage written by Ben Pfaff
495 +<pfaffben@pilot.msu.edu> for the Debian GNU/Linux
496 +.B autoconf
497 +package.
498 --- autoconf-2.13.orig/autoscan.1
499 +++ autoconf-2.13/autoscan.1
500 @@ -0,0 +1,122 @@
501 +.\" Copyright (C) 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
502 +.\" Copyright (C) 1998 Ben Pfaff.
503 +.\"
504 +.\" Permission is granted to make and distribute verbatim copies of
505 +.\" this manual provided the copyright notice and this permission notice
506 +.\" are preserved on all copies.
507 +.\" 
508 +.\" Permission is granted to copy and distribute modified versions of this
509 +.\" manual under the conditions for verbatim copying, provided that the entire
510 +.\" resulting derived work is distributed under the terms of a permission
511 +.\" notice identical to this one.
512 +.\" 
513 +.\" Permission is granted to copy and distribute translations of this manual
514 +.\" into another language, under the above conditions for modified versions,
515 +.\" except that this permission notice may be stated in a translation approved
516 +.\" by the Foundation.
517 +.\"
518 +.TH AUTOCONF 1 "Autoconf"
519 +.SH NAME
520 +autoscan - help to create a configure.in file for a software package
521 +.SH SYNOPSIS
522 +.B autoscan
523 +[
524 +.B --help
525 +] [
526 +.B --macrodir=dir
527 +] [
528 +.B --verbose
529 +] [
530 +.B --version
531 +]
532 +.SH DESCRIPTION
533 +The 
534 +.B autoscan
535 +program can help you create a 
536 +.B configure.in
537 +file for a
538 +software package.  
539 +.B autoscan
540 +examines source files in the directory
541 +tree rooted at a directory given as a command line argument, or the
542 +current directory if none is given.  It searches the source files for
543 +common portability problems and creates a file 
544 +.B configure.scan
545 +which
546 +is a preliminary 
547 +.B configure.in
548 +for that package.
549 +.PP
550 +You should manually examine 
551 +.B configure.scan
552 +before renaming it to
553 +.BR configure.in ; 
554 +it will probably need some adjustments.  Occasionally
555 +.B autoscan
556 +outputs a macro in the wrong order relative to another
557 +macro, so that 
558 +.B autoconf
559 +produces a warning; you need to move such
560 +macros manually.  Also, if you want the package to use a configuration
561 +header file, you must add a call to 
562 +.BR AC_CONFIG_HEADER .  
563 +You might
564 +also have to change or add some 
565 +.B #if
566 +directives to your program in
567 +order to make it work with Autoconf (see 
568 +.BR ifnames (1)), 
569 +for information about a program that can help with that job).
570 +.PP
571 +.B autoscan
572 +uses several data files, which are installed along with the
573 +distributed Autoconf macro files, to determine which macros to output
574 +when it finds particular symbols in a package's source files.  These
575 +files all have the same format.  Each line consists of a symbol,
576 +whitespace, and the Autoconf macro to output if that symbol is
577 +encountered.  Lines starting with 
578 +.B #
579 +are comments.
580 +.PP
581 +
582 +.B autoscan
583 +requires that a Perl interpreter is installed.
584 +.PP
585 +
586 +.B autoscan
587 +accepts the following options:
588 +.TP
589 +.BI --help
590 +.TP
591 +.BI -h
592 +Print a summary of the command line options and exit.
593 +.TP
594 +.BI --macrodir=DIR
595 +.TP
596 +.BI -m\ DIR
597 +Look for the installed macro files in directory DIR.  You can also
598 +set the 
599 +.B AC_MACRODIR
600 +environment variable to a directory; this
601 +option overrides the environment variable.
602 +.TP
603 +.BI --verbose
604 +Print the names of the fiels it examines and the potentially
605 +interesting symbols it finds in them.  This output can be voluminous.
606 +.TP
607 +.BI --version
608 +Print the version number of Autoconf and exit.
609 +.PP
610 +.SH "SEE ALSO"
611 +.BR autoconf (1),
612 +.BR autoheader (1),
613 +.BR autoreconf (1),
614 +.BR autoupdate (1),
615 +.BR ifnames (1)
616 +.SH AUTHORS
617 +David MacKenzie, with help from Franc,ois Pinard, Karl Berry, Richard
618 +Pixley, Ian Lance Taylor, Roland McGrath, Noah Friedman, David
619 +D. Zuhn, and many others.  This manpage written by Ben Pfaff
620 +<pfaffben@pilot.msu.edu> for the Debian GNU/Linux
621 +.B autoconf
622 +package.
623 --- autoconf-2.13.orig/autoupdate.1
624 +++ autoconf-2.13/autoupdate.1
625 @@ -0,0 +1,97 @@
626 +.\" Copyright (C) 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
627 +.\" Copyright (C) 1998 Ben Pfaff.
628 +.\"
629 +.\" Permission is granted to make and distribute verbatim copies of
630 +.\" this manual provided the copyright notice and this permission notice
631 +.\" are preserved on all copies.
632 +.\" 
633 +.\" Permission is granted to copy and distribute modified versions of this
634 +.\" manual under the conditions for verbatim copying, provided that the entire
635 +.\" resulting derived work is distributed under the terms of a permission
636 +.\" notice identical to this one.
637 +.\" 
638 +.\" Permission is granted to copy and distribute translations of this manual
639 +.\" into another language, under the above conditions for modified versions,
640 +.\" except that this permission notice may be stated in a translation approved
641 +.\" by the Foundation.
642 +.\"
643 +.TH AUTOUPDATE 1 "Autoconf"
644 +.SH NAME
645 +autoupdate - updates an old configure.in file to version 2
646 +.SH SYNOPSIS
647 +.B autoconf
648 +[
649 +.B --help
650 +|
651 +.B -h
652 +] [
653 +.B --macrodir=dir
654 +|
655 +.B -m dir
656 +] [
657 +.B --version
658 +]
659 +.SH DESCRIPTION
660 +The 
661 +.B autoupdate
662 +program updates a 
663 +.B configure.in
664 +file that calls
665 +Autoconf macros by their old names to use the current macro names.  In
666 +version 2 of Autoconf, most of the macros were renamed to use a more
667 +uniform and descriptive naming scheme.  Although the old names still
668 +work , you can make your 
669 +.B configure.in
670 +files more readable and make
671 +it easier to use the current Autoconf documentation if you update them
672 +to use the new macro names.
673 +If given no arguments, 
674 +.B autoupdate
675 +updates 
676 +.BR configure.in , 
677 +backing up
678 +the original version with the suffix 
679 +.B ~
680 +(or the value of the
681 +environment variable 
682 +.BR SIMPLE_BACKUP_SUFFIX , 
683 +if that is set).  If you
684 +give 
685 +.B autoupdate
686 +an argument, it reads that file instead of
687 +.B configure.in
688 +and writes the updated file to the standard output.
689 +.PP
690 +.B autoconf
691 +accepts the following options:
692 +.TP
693 +.BI --help
694 +.TP
695 +.BI -h
696 +Print a summary of the command line options and exit.
697 +.TP
698 +.BI --macrodir=DIR
699 +.TP
700 +.BI -m\ DIR
701 +Look for the installed macro files in directory DIR.  You can also
702 +set the 
703 +.B AC_MACRODIR
704 +environment variable to a directory; this
705 +option overrides the environment variable.
706 +.TP
707 +.BI --version
708 +Print the version number of Autoconf and exit.
709 +.PP
710 +.SH "SEE ALSO"
711 +.BR autoconf (1),
712 +.BR autoheader (1),
713 +.BR autoreconf (1),
714 +.BR autoscan (1),
715 +.BR ifnames (1)
716 +.SH AUTHORS
717 +David MacKenzie, with help from Franc,ois Pinard, Karl Berry, Richard
718 +Pixley, Ian Lance Taylor, Roland McGrath, Noah Friedman, David
719 +D. Zuhn, and many others.  This manpage written by Ben Pfaff
720 +<pfaffben@pilot.msu.edu> for the Debian GNU/Linux
721 +.B autoconf
722 +package.
723 --- autoconf-2.13.orig/ifnames.1
724 +++ autoconf-2.13/ifnames.1
725 @@ -0,0 +1,98 @@
726 +.\" Copyright (C) 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
727 +.\" Copyright (C) 1998 Ben Pfaff.
728 +.\"
729 +.\" Permission is granted to make and distribute verbatim copies of
730 +.\" this manual provided the copyright notice and this permission notice
731 +.\" are preserved on all copies.
732 +.\" 
733 +.\" Permission is granted to copy and distribute modified versions of this
734 +.\" manual under the conditions for verbatim copying, provided that the entire
735 +.\" resulting derived work is distributed under the terms of a permission
736 +.\" notice identical to this one.
737 +.\" 
738 +.\" Permission is granted to copy and distribute translations of this manual
739 +.\" into another language, under the above conditions for modified versions,
740 +.\" except that this permission notice may be stated in a translation approved
741 +.\" by the Foundation.
742 +.\"
743 +.TH IFNAMES 1 "Autoconf"
744 +.SH NAME
745 +ifnames - print identifiers that a package uses in C preprocessor
746 +conditionals
747 +.SH SYNOPSIS
748 +.B ifnames
749 +[
750 +.B --help
751 +|
752 +.B -h
753 +] [
754 +.B --macrodir=dir
755 +|
756 +.B -m dir
757 +] [
758 +.B --version
759 +]
760 +.SH DESCRIPTION
761 +.PP
762 +.B ifnames
763 +can help when writing a 
764 +.B configure.in
765 +for a software
766 +package.  It prints the identifiers that the package already uses in C
767 +preprocessor conditionals.  If a package has already been set up to
768 +have some portability, this program can help you figure out what its
769 +.B configure
770 +needs to check for.  It may help fill in some gaps in a
771 +.B configure.in
772 +generated by 
773 +.B autoscan
774 +(see 
775 +.BR autoscan (1)).
776 +.PP
777 +.B ifnames
778 +scans all of the C source files named on the command line
779 +(or the standard input, if none are given) and writes to the standard
780 +output a sorted list of all the identifiers that appear in those files
781 +in 
782 +.BR #if , 
783 +.BR #elif , 
784 +.BR #ifdef , 
785 +or 
786 +.B #ifndef
787 +directives.  It prints each
788 +identifier on a line, followed by a space-separated list of the files
789 +in which that identifier occurs.
790 +.PP
791 +.B ifnames
792 +accepts the following options:
793 +.TP
794 +.BI --help
795 +.TP
796 +.BI -h
797 +Print a summary of the command line options and exit.
798 +.TP
799 +.BI --macrodir=DIR
800 +.TP
801 +.BI -m\ DIR
802 +Look for the installed macro files in directory DIR.  You can also
803 +set the 
804 +.B AC_MACRODIR
805 +environment variable to a directory; this
806 +option overrides the environment variable.
807 +.TP
808 +.BI --version
809 +Print the version number of Autoconf and exit.
810 +.PP
811 +.SH "SEE ALSO"
812 +.BR autoconf (1),
813 +.BR autoheader (1),
814 +.BR autoreconf (1),
815 +.BR autoscan (1),
816 +.BR autoupdate (1)
817 +.SH AUTHORS
818 +David MacKenzie, with help from Franc,ois Pinard, Karl Berry, Richard
819 +Pixley, Ian Lance Taylor, Roland McGrath, Noah Friedman, David
820 +D. Zuhn, and many others.  This manpage written by Ben Pfaff
821 +<pfaffben@pilot.msu.edu> for the Debian GNU/Linux
822 +.B autoconf
823 +package.
This page took 0.145368 seconds and 3 git commands to generate.