source: trunk/essentials/sys-devel/automake-1.8/doc/automake.info-2

Last change on this file was 3118, checked in by bird, 18 years ago

automake 1.8.5

File size: 26.9 KB
Line 
1This is automake.info, produced by makeinfo version 4.6 from
2automake.texi.
3
4
5
6 This manual is for GNU Automake (version 1.8.5, 13 May 2004), a
7program which creates GNU standards-compliant Makefiles from template
8files.
9
10 Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
112004 Free Software Foundation, Inc.
12
13 Permission is granted to copy, distribute and/or modify this
14 document under the terms of the GNU Free Documentation License,
15 Version 1.1 or any later version published by the Free Software
16 Foundation; with no Invariant Sections, with the Front-Cover texts
17 being "A GNU Manual," and with the Back-Cover Texts as in (a)
18 below. A copy of the license is included in the section entitled
19 "GNU Free Documentation License."
20
21 (a) The FSF's Back-Cover Text is: "You have freedom to copy and
22 modify this GNU Manual, like GNU software. Copies published by
23 the Free Software Foundation raise funds for GNU development."
24
25INFO-DIR-SECTION Software development
26START-INFO-DIR-ENTRY
27* automake: (automake). Making Makefile.in's.
28END-INFO-DIR-ENTRY
29
30INFO-DIR-SECTION Individual utilities
31START-INFO-DIR-ENTRY
32* aclocal: (automake)Invoking aclocal. Generating aclocal.m4.
33END-INFO-DIR-ENTRY
34
35
36File: automake.info, Node: General Index, Prev: Macro and Variable Index, Up: Indices
37
38General Index
39=============
40
41* Menu:
42
43* ## (special Automake comment): General Operation.
44* --acdir: aclocal options.
45* --add-missing: Invoking Automake.
46* --copy: Invoking Automake.
47* --cygnus: Invoking Automake.
48* --enable-maintainer-mode: Optional.
49* --force: aclocal options.
50* --force-missing: Invoking Automake.
51* --foreign: Invoking Automake.
52* --gnits: Invoking Automake.
53* --gnu: Invoking Automake.
54* --help <1>: aclocal options.
55* --help: Invoking Automake.
56* --include-deps: Invoking Automake.
57* --libdir: Invoking Automake.
58* --no-force: Invoking Automake.
59* --output: aclocal options.
60* --output-dir: Invoking Automake.
61* --print-ac-dir: aclocal options.
62* --verbose <1>: aclocal options.
63* --verbose: Invoking Automake.
64* --version <1>: aclocal options.
65* --version: Invoking Automake.
66* --warnings: Invoking Automake.
67* --with-dmalloc: Public macros.
68* --with-regex: Public macros.
69* -a: Invoking Automake.
70* -c: Invoking Automake.
71* -enable-debug, example: Conditionals.
72* -f: Invoking Automake.
73* -gnits, complete description: Gnits.
74* -gnu, complete description: Gnits.
75* -gnu, required files: Gnits.
76* -hook targets: Extending.
77* -I: aclocal options.
78* -i: Invoking Automake.
79* -local targets: Extending.
80* -module, libtool: Libtool Modules.
81* -o: Invoking Automake.
82* -v: Invoking Automake.
83* -W: Invoking Automake.
84* .la suffix, defined: Libtool Concept.
85* _DATA primary, defined: Data.
86* _DEPENDENCIES, defined: Linking.
87* _HEADERS primary, defined: Headers.
88* _JAVA primary, defined: Java.
89* _LDFLAGS, defined: Linking.
90* _LDFLAGS, libtool: Libtool Flags.
91* _LIBADD primary, defined: A Library.
92* _LIBADD, libtool: Libtool Flags.
93* _LIBRARIES primary, defined: A Library.
94* _LISP primary, defined: Emacs Lisp.
95* _LTLIBRARIES primary, defined: Libtool Libraries.
96* _MANS primary, defined: Man pages.
97* _PROGRAMS primary variable: Uniform.
98* _PYTHON primary, defined: Python.
99* _SCRIPTS primary, defined: Scripts.
100* _SOURCES and header files: Program Sources.
101* _SOURCES primary, defined: Program Sources.
102* _SOURCES, default: Default _SOURCES.
103* _SOURCES, empty: Default _SOURCES.
104* _TEXINFOS primary, defined: Texinfo.
105* AC_SUBST and SUBDIRS: Top level.
106* acinclude.m4, defined: Complete.
107* aclocal program, introduction: Complete.
108* aclocal search path: Macro search path.
109* aclocal's scheduled death: Future of aclocal.
110* aclocal, extending: Extending aclocal.
111* aclocal, Invoking: Invoking aclocal.
112* aclocal, Options: aclocal options.
113* aclocal.m4, preexisting: Complete.
114* Adding new SUFFIXES: Suffixes.
115* all: Extending.
116* all-local: Extending.
117* ALLOCA, special handling: LIBOBJS.
118* AM_CONDITIONAL and SUBDIRS: Top level.
119* AM_INIT_AUTOMAKE, example use: Complete.
120* AM_MAINTAINER_MODE, purpose: maintainer-mode.
121* ansi2knr: ANSI.
122* ansi2knr and LIBOBJS: ANSI.
123* ansi2knr and LTLIBOBJS: ANSI.
124* Append operator: General Operation.
125* autogen.sh and autoreconf: Libtool Issues.
126* Automake constraints: Introduction.
127* Automake options: Invoking Automake.
128* Automake requirements <1>: Requirements.
129* Automake requirements: Introduction.
130* Automake, invoking: Invoking Automake.
131* Automake, recursive operation: General Operation.
132* Automatic dependency tracking: Dependencies.
133* Automatic linker selection: How the Linker is Chosen.
134* autoreconf and libtoolize: Libtool Issues.
135* Auxiliary programs: Auxiliary Programs.
136* Avoiding path stripping: Alternative.
137* bootstrap.sh and autoreconf: Libtool Issues.
138* BUGS, reporting: Introduction.
139* BUILT_SOURCES, defined: Sources.
140* C++ support: C++ Support.
141* canonicalizing Automake variables: Canonicalization.
142* cfortran: Mixing Fortran 77 With C and C++.
143* check: Extending.
144* check primary prefix, definition: Uniform.
145* check-local: Extending.
146* check_PROGRAMS example: Default _SOURCES.
147* clean: Extending.
148* clean-local: Extending.
149* Comment, special to Automake: General Operation.
150* Complete example: Complete.
151* Conditional example, -enable-debug: Conditionals.
152* conditional libtool libraries: Conditional Libtool Libraries.
153* Conditional programs: Conditional Programs.
154* Conditional subdirectories: Top level.
155* Conditional SUBDIRS: Top level.
156* Conditionals: Conditionals.
157* config.guess: Invoking Automake.
158* configure.ac, from GNU Hello: Hello.
159* configure.ac, scanning: configure.
160* conflicting definitions: Extending.
161* Constraints of Automake: Introduction.
162* convenience libraries, libtool: Libtool Convenience Libraries.
163* copying semantics: Extending.
164* cpio example: Uniform.
165* CVS and generated files: CVS.
166* CVS and third-party files: CVS.
167* CVS and timestamps: CVS.
168* cvs-dist: General Operation.
169* cvs-dist, non-standard example: General Operation.
170* Cygnus strictness: Cygnus.
171* DATA primary, defined: Data.
172* de-ANSI-fication, defined: ANSI.
173* default _SOURCES: Default _SOURCES.
174* default source, Libtool modules example: Default _SOURCES.
175* definitions, conflicts: Extending.
176* dejagnu: Tests.
177* depcomp: Dependencies.
178* dependencies and distributed files: distcleancheck.
179* Dependency tracking: Dependencies.
180* Dependency tracking, disabling: Dependencies.
181* dirlist: Macro search path.
182* Disabling dependency tracking: Dependencies.
183* dist: Dist.
184* dist-bzip2 <1>: Options.
185* dist-bzip2: Dist.
186* dist-gzip: Dist.
187* dist-hook <1>: Extending.
188* dist-hook: Dist.
189* dist-shar <1>: Options.
190* dist-shar: Dist.
191* dist-tarZ <1>: Options.
192* dist-tarZ: Dist.
193* dist-zip <1>: Options.
194* dist-zip: Dist.
195* dist_ and nobase_: Alternative.
196* DIST_SUBDIRS, explained: Top level.
197* distcheck: Dist.
198* distclean <1>: distcleancheck.
199* distclean: Extending.
200* distclean, diagnostic: distcleancheck.
201* distclean-local: Extending.
202* distcleancheck <1>: distcleancheck.
203* distcleancheck: Dist.
204* distdir: Third-Party Makefiles.
205* dmalloc, support for: Public macros.
206* dvi: Extending.
207* DVI output using Texinfo: Texinfo.
208* dvi-local: Extending.
209* E-mail, bug reports: Introduction.
210* EDITION Texinfo flag: Texinfo.
211* else: Conditionals.
212* empty _SOURCES: Default _SOURCES.
213* endif: Conditionals.
214* Example conditional -enable-debug: Conditionals.
215* Example of recursive operation: General Operation.
216* Example of shared libraries: Libtool Libraries.
217* Example, EXTRA_PROGRAMS: Uniform.
218* Example, false and true: true.
219* Example, GNU Hello: Hello.
220* Example, handling Texinfo files: Hello.
221* Example, mixed language: Mixing Fortran 77 With C and C++.
222* Example, regression test: Hello.
223* Executable extension: EXEEXT.
224* Exit status 77, special interpretation: Tests.
225* Expected test failure: Tests.
226* Extending aclocal: Extending aclocal.
227* Extending list of installation directories: Uniform.
228* Extension, executable: EXEEXT.
229* Extra files distributed with Automake: Invoking Automake.
230* EXTRA_, prepending: Uniform.
231* EXTRA_prog_SOURCES, defined: Conditional Sources.
232* EXTRA_PROGRAMS, defined <1>: Conditional Programs.
233* EXTRA_PROGRAMS, defined: Uniform.
234* false Example: true.
235* FDL, GNU Free Documentation License: GNU Free Documentation License.
236* Files distributed with Automake: Invoking Automake.
237* First line of Makefile.am: General Operation.
238* FLIBS, defined: Mixing Fortran 77 With C and C++.
239* foreign strictness: Strictness.
240* Fortran 77 support: Fortran 77 Support.
241* Fortran 77, mixing with C and C++: Mixing Fortran 77 With C and C++.
242* Fortran 77, Preprocessing: Preprocessing Fortran 77.
243* generated files and CVS: CVS.
244* generated files, distributed: CVS.
245* Gettext support: gettext.
246* gnits strictness: Strictness.
247* GNU Gettext support: gettext.
248* GNU Hello, configure.ac: Hello.
249* GNU Hello, example: Hello.
250* GNU make extensions: General Operation.
251* GNU Makefile standards: Introduction.
252* gnu strictness: Strictness.
253* GNUmakefile including Makefile: Third-Party Makefiles.
254* Header files in _SOURCES: Program Sources.
255* HEADERS primary, defined: Headers.
256* HEADERS, installation directories: Headers.
257* Hello example: Hello.
258* Hello, configure.ac: Hello.
259* hook targets: Extending.
260* HP-UX 10, lex problems: Public macros.
261* html: Extending.
262* HTML installation, example: Uniform.
263* HTML output using Texinfo: Texinfo.
264* html-local: Extending.
265* id: Tags.
266* if: Conditionals.
267* include: Include.
268* INCLUDES, example usage: Hello.
269* Including Makefile fragment: Include.
270* info <1>: Extending.
271* info: Options.
272* info-local: Extending.
273* install <1>: Extending.
274* install: Install.
275* Install hook: Install.
276* Install, two parts of: Install.
277* install-data: Install.
278* install-data-hook: Extending.
279* install-data-local <1>: Extending.
280* install-data-local: Install.
281* install-exec <1>: Extending.
282* install-exec: Install.
283* install-exec-hook: Extending.
284* install-exec-local <1>: Extending.
285* install-exec-local: Install.
286* install-info <1>: Options.
287* install-info: Texinfo.
288* install-info target: Texinfo.
289* install-man <1>: Options.
290* install-man: Man pages.
291* install-man target: Man pages.
292* install-strip: Install.
293* Installation directories, extending list: Uniform.
294* Installation support: Install.
295* installcheck: Extending.
296* installcheck-local: Extending.
297* installdirs <1>: Extending.
298* installdirs: Install.
299* installdirs-local: Extending.
300* Installing headers: Headers.
301* Installing scripts: Scripts.
302* installing versioned binaries: Extending.
303* Interfacing with third-party packages: Third-Party Makefiles.
304* Invoking aclocal: Invoking aclocal.
305* Invoking Automake: Invoking Automake.
306* JAVA primary, defined: Java.
307* JAVA restrictions: Java.
308* Java support: Java Support.
309* lex problems with HP-UX 10: Public macros.
310* lex, multiple lexers: Yacc and Lex.
311* LIBADD primary, defined: A Library.
312* libltdl, introduction: Libtool Concept.
313* LIBOBJS and ansi2knr: ANSI.
314* LIBOBJS, special handling: LIBOBJS.
315* LIBRARIES primary, defined: A Library.
316* libtool convenience libraries: Libtool Convenience Libraries.
317* libtool libraries, conditional: Conditional Libtool Libraries.
318* libtool library, definition: Libtool Concept.
319* libtool modules: Libtool Modules.
320* Libtool modules, default source example: Default _SOURCES.
321* libtool, introduction: Libtool Concept.
322* libtoolize and autoreconf: Libtool Issues.
323* libtoolize, no longer run by Automake: Libtool Issues.
324* Linking Fortran 77 with C and C++: Mixing Fortran 77 With C and C++.
325* LISP primary, defined: Emacs Lisp.
326* LN_S example: Extending.
327* local targets: Extending.
328* LTLIBOBJS and ansi2knr: ANSI.
329* LTLIBOBJS, special handling: LTLIBOBJ.
330* LTLIBRARIES primary, defined: Libtool Libraries.
331* ltmain.sh not found: Libtool Issues.
332* Macro search path: Macro search path.
333* Macros Automake recognizes: Optional.
334* make check: Tests.
335* make clean support: Clean.
336* make dist: Dist.
337* make distcheck: Dist.
338* make distcleancheck: Dist.
339* make distuninstallcheck: Dist.
340* make install support: Install.
341* make installcheck: Options.
342* Make rules, overriding: General Operation.
343* Make targets, overriding: General Operation.
344* Makefile fragment, including: Include.
345* Makefile.am, first line: General Operation.
346* MANS primary, defined: Man pages.
347* many outputs, rules with: Multiple Outputs.
348* mdate-sh: Texinfo.
349* missing, purpose: maintainer-mode.
350* Mixed language example: Mixing Fortran 77 With C and C++.
351* Mixing Fortran 77 with C and C++: Mixing Fortran 77 With C and C++.
352* Mixing Fortran 77 with C and/or C++: Mixing Fortran 77 With C and C++.
353* modules, libtool: Libtool Modules.
354* mostlyclean: Extending.
355* mostlyclean-local: Extending.
356* Multiple configure.ac files: Invoking Automake.
357* Multiple lex lexers: Yacc and Lex.
358* multiple outputs, rules with: Multiple Outputs.
359* Multiple yacc parsers: Yacc and Lex.
360* no-dependencies: Dependencies.
361* no-dist-gzip: Options.
362* no-installinfo: Texinfo.
363* no-installman: Man pages.
364* no-texinfo.tex: Texinfo.
365* nobase_: Alternative.
366* nobase_ and dist_ or nodist_: Alternative.
367* nodist_ and nobase_: Alternative.
368* noinst primary prefix, definition: Uniform.
369* noinstall-info target: Texinfo.
370* noinstall-man target: Man pages.
371* Non-GNU packages: Strictness.
372* Non-standard targets: General Operation.
373* Objects in subdirectory: Program and Library Variables.
374* Option, ansi2knr: Options.
375* Option, check-news: Options.
376* Option, cygnus: Options.
377* Option, dejagnu: Options.
378* Option, dist-bzip2: Options.
379* Option, dist-shar: Options.
380* Option, dist-tarZ: Options.
381* Option, dist-zip: Options.
382* Option, foreign: Options.
383* Option, gnits: Options.
384* Option, gnu: Options.
385* Option, no-define: Options.
386* Option, no-dependencies: Options.
387* Option, no-dist: Options.
388* Option, no-dist-gzip: Options.
389* Option, no-exeext: Options.
390* Option, no-installinfo: Options.
391* Option, no-installman: Options.
392* Option, no-texinfo: Options.
393* Option, nostdinc: Options.
394* Option, readme-alpha: Options.
395* Option, version: Options.
396* Option, warnings: Options.
397* Options, aclocal: aclocal options.
398* Options, Automake: Invoking Automake.
399* Options, std-options: Options.
400* Overriding make rules: General Operation.
401* Overriding make targets: General Operation.
402* Overriding make variables: General Operation.
403* overriding rules: Extending.
404* overriding semantics: Extending.
405* Path stripping, avoiding: Alternative.
406* pdf: Extending.
407* PDF output using Texinfo: Texinfo.
408* pdf-local: Extending.
409* per-target compilation flags, defined: Program and Library Variables.
410* pkgdatadir, defined: Uniform.
411* pkgincludedir, defined: Uniform.
412* pkglibdir, defined: Uniform.
413* POSIX termios headers: Public macros.
414* Preprocessing Fortran 77: Preprocessing Fortran 77.
415* Primary variable, DATA: Data.
416* Primary variable, defined: Uniform.
417* Primary variable, HEADERS: Headers.
418* Primary variable, JAVA: Java.
419* Primary variable, LIBADD: A Library.
420* Primary variable, LIBRARIES: A Library.
421* Primary variable, LISP: Emacs Lisp.
422* Primary variable, LTLIBRARIES: Libtool Libraries.
423* Primary variable, MANS: Man pages.
424* Primary variable, PROGRAMS: Uniform.
425* Primary variable, PYTHON: Python.
426* Primary variable, SCRIPTS: Scripts.
427* Primary variable, SOURCES: Program Sources.
428* Primary variable, TEXINFOS: Texinfo.
429* prog_LDADD, defined: Linking.
430* PROGRAMS primary variable: Uniform.
431* Programs, auxiliary: Auxiliary Programs.
432* PROGRAMS, bindir: Program Sources.
433* Programs, conditional: Conditional Programs.
434* Proxy Makefile for third-party packages: Third-Party Makefiles.
435* ps: Extending.
436* PS output using Texinfo: Texinfo.
437* ps-local: Extending.
438* PYTHON primary, defined: Python.
439* Ratfor programs: Preprocessing Fortran 77.
440* README-alpha: Gnits.
441* rebuild rules <1>: CVS.
442* rebuild rules: Rebuilding.
443* Recognized macros by Automake: Optional.
444* Recursive operation of Automake: General Operation.
445* recursive targets and third-party Makefiles: Third-Party Makefiles.
446* regex package: Public macros.
447* Regression test example: Hello.
448* Reporting BUGS: Introduction.
449* Requirements of Automake: Requirements.
450* Requirements, Automake: Introduction.
451* Restrictions for JAVA: Java.
452* Rule, install-info: Texinfo.
453* Rule, install-man: Man pages.
454* Rule, noinstall-info: Texinfo.
455* Rule, noinstall-man: Man pages.
456* rules with multiple outputs: Multiple Outputs.
457* rules, conflicting: Extending.
458* rules, overriding: Extending.
459* rx package: Public macros.
460* Scanning configure.ac: configure.
461* SCRIPTS primary, defined: Scripts.
462* SCRIPTS, installation directories: Scripts.
463* Selecting the linker automatically: How the Linker is Chosen.
464* Shared libraries, support for: A Shared Library.
465* site.exp: Tests.
466* SOURCES primary, defined: Program Sources.
467* Special Automake comment: General Operation.
468* Strictness, command line: Invoking Automake.
469* Strictness, defined: Strictness.
470* Strictness, foreign: Strictness.
471* Strictness, gnits: Strictness.
472* Strictness, gnu: Strictness.
473* Subdirectories, building conditionally: Top level.
474* Subdirectory, objects in: Program and Library Variables.
475* SUBDIRS and AC_SUBST: Top level.
476* SUBDIRS and AM_CONDITIONAL: Top level.
477* SUBDIRS, conditional: Top level.
478* SUBDIRS, explained: Top level.
479* suffix .la, defined: Libtool Concept.
480* suffix .lo, defined: Libtool Concept.
481* SUFFIXES, adding: Suffixes.
482* Support for C++: C++ Support.
483* Support for Fortran 77: Fortran 77 Support.
484* Support for GNU Gettext: gettext.
485* Support for Java: Java Support.
486* tags: Tags.
487* TAGS support: Tags.
488* Target, install-info: Texinfo.
489* Target, install-man: Man pages.
490* Target, noinstall-info: Texinfo.
491* Target, noinstall-man: Man pages.
492* termios POSIX headers: Public macros.
493* Test suites: Tests.
494* Tests, expected failure: Tests.
495* Texinfo file handling example: Hello.
496* Texinfo flag, EDITION: Texinfo.
497* Texinfo flag, UPDATED: Texinfo.
498* Texinfo flag, UPDATED-MONTH: Texinfo.
499* Texinfo flag, VERSION: Texinfo.
500* texinfo.tex: Texinfo.
501* TEXINFOS primary, defined: Texinfo.
502* third-party files and CVS: CVS.
503* Third-party packages, interfacing with: Third-Party Makefiles.
504* timestamps and CVS: CVS.
505* true Example: true.
506* underquoted AC_DEFUN: Extending aclocal.
507* Uniform naming scheme: Uniform.
508* uninstall <1>: Extending.
509* uninstall: Install.
510* uninstall-hook: Extending.
511* uninstall-local: Extending.
512* UPDATED Texinfo flag: Texinfo.
513* UPDATED-MONTH Texinfo flag: Texinfo.
514* user variables: User Variables.
515* variables, conflicting: Extending.
516* Variables, overriding: General Operation.
517* variables, reserved for the user: User Variables.
518* VERSION Texinfo flag: Texinfo.
519* version.m4, example: Rebuilding.
520* version.sh, example: Rebuilding.
521* versioned binaries, installing: Extending.
522* wildcards: wildcards.
523* Windows: EXEEXT.
524* yacc, multiple parsers: Yacc and Lex.
525* ylwrap: Yacc and Lex.
526* zardoz example: Complete.
527
528
Note: See TracBrowser for help on using the repository browser.