Penguin
Recent Changes
Annotated edit history of autoscan(1) version 2 showing authors affecting page license. View with all changes included.
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
111 David !MacKenzie, with help from Franc,ois Pinard, Karl
112 Berry, Richard Pixley, Ian Lance Taylor, Roland !McGrath,
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.