Penguin
Recent Changes
Annotated edit history of autoscan(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 AUTOCONF
2 !!!AUTOCONF
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 SEE ALSO
7 AUTHORS
8 ----
9 !!NAME
10
11
12 autoscan - help to create a configure.ac file for a software package
13 !!SYNOPSIS
14
15
16 __autoscan__ [[ __--help__ | __-h__ ] [[
17 __--version__ | __-V__ ] [[ __--verbose__ |
18 __-v__ ] [[ __--autoconf-dir=__''dir'' | __-A__
19 ''dir'' ]
20 !!DESCRIPTION
21
22
23 The __autoscan__ program can help you create a
24 __configure.ac__ file for a software package.
25 __autoscan__ examines source files in the directory tree
26 rooted at a directory given as a command line argument, or
27 the current directory if none is given. It searches the
28 source files for common portability problems and creates a
29 file __configure.scan__ which is a preliminary
30 __configure.ac__ for that package.
31
32
33 You should manually examine __configure.scan__ before
34 renaming it to __configure.ac__; it will probably need
35 some adjustments. Occasionally __autoscan__ outputs a
36 macro in the wrong order relative to another macro, so that
37 __autoconf__ produces a warning; you need to move such
38 macros manually. Also, if you want the package to use a
39 configuration header file, you must add a call to
40 __AC_CONFIG_HEADER__. You might also have to change or
41 add some __#if__ directives to your program in order to
42 make it work with Autoconf (see ifnames(1)), for
43 information about a program that can help with that
44 job).
45
46
47 __autoscan__ uses several data files, which are installed
48 along with the distributed Autoconf macro files, to
49 determine which macros to output when it finds particular
50 symbols in a package's source files. These files all have
51 the same format. Each line consists of a symbol, whitespace,
52 and the Autoconf macro to output if that symbol is
53 encountered. Lines starting with __#__ are
54 comments.
55
56
57 __autoscan__ requires that a Perl interpreter is
58 installed.
59
60
61 __autoscan__ accepts the following options:
62
63
64 __--help__
65
66
67 __-h__
68
69
70 Print a summary of the command line options and
71 exit.
72
73
74 __--version__
75
76
77 __-V__
78
79
80 Print the version number of Autoconf and exit.
81
82
83 __--verbose__
84
85
86 __-v__
87
88
89 Report processing steps.
90
91
92 __--autoconf-dir=__''dir''
93
94
95 __-A__ ''dir''
96
97
98 Look for the installed macro files in directory ''dir''.
99 You can also set the __AC_MACRODIR__ environment variable
100 to a directory; this option overrides the environment
101 variable.
102 !!SEE ALSO
103
104
105 autoconf(1), autoheader(1),
106 autoreconf(1), autoupdate(1),
107 ifnames(1)
108 !!AUTHORS
109
110
2 perry 111 David !MacKenzie, with help from Franc,ois Pinard, Karl
112 Berry, Richard Pixley, Ian Lance Taylor, Roland !McGrath,
1 perry 113 Noah Friedman, David D. Zuhn, and many others. This manpage
114 written by Ben Pfaff
115 autoconf__ package.
116 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.