| 1 | .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36.
|
|---|
| 2 | .TH AUTOM4TE "1" "November 2006" "autom4te 2.61" "User Commands"
|
|---|
| 3 | .SH NAME
|
|---|
| 4 | autom4te \- Generate files and scripts thanks to M4
|
|---|
| 5 | .SH SYNOPSIS
|
|---|
| 6 | .B autom4te
|
|---|
| 7 | [\fIOPTION\fR] ... [\fIFILES\fR]
|
|---|
| 8 | .SH DESCRIPTION
|
|---|
| 9 | Run GNU M4 on the FILES, avoiding useless runs. Output the traces if tracing,
|
|---|
| 10 | the frozen file if freezing, otherwise the expansion of the FILES.
|
|---|
| 11 | .PP
|
|---|
| 12 | If some of the FILES are named `FILE.m4f' they are considered to be M4
|
|---|
| 13 | frozen files of all the previous files (which are therefore not loaded).
|
|---|
| 14 | If `FILE.m4f' is not found, then `FILE.m4' will be used, together with
|
|---|
| 15 | all the previous files.
|
|---|
| 16 | .PP
|
|---|
| 17 | Some files may be optional, i.e., will only be processed if found in the
|
|---|
| 18 | include path, but then must end in `.m4?'; the question mark is not part of
|
|---|
| 19 | the actual file name.
|
|---|
| 20 | .SS "Operation modes:"
|
|---|
| 21 | .TP
|
|---|
| 22 | \fB\-h\fR, \fB\-\-help\fR
|
|---|
| 23 | print this help, then exit
|
|---|
| 24 | .TP
|
|---|
| 25 | \fB\-V\fR, \fB\-\-version\fR
|
|---|
| 26 | print version number, then exit
|
|---|
| 27 | .TP
|
|---|
| 28 | \fB\-v\fR, \fB\-\-verbose\fR
|
|---|
| 29 | verbosely report processing
|
|---|
| 30 | .TP
|
|---|
| 31 | \fB\-d\fR, \fB\-\-debug\fR
|
|---|
| 32 | don't remove temporary files
|
|---|
| 33 | .TP
|
|---|
| 34 | \fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
|
|---|
| 35 | save output in FILE (defaults to `\-', stdout)
|
|---|
| 36 | .TP
|
|---|
| 37 | \fB\-f\fR, \fB\-\-force\fR
|
|---|
| 38 | don't rely on cached values
|
|---|
| 39 | .TP
|
|---|
| 40 | \fB\-W\fR, \fB\-\-warnings\fR=\fICATEGORY\fR
|
|---|
| 41 | report the warnings falling in CATEGORY
|
|---|
| 42 | .TP
|
|---|
| 43 | \fB\-l\fR, \fB\-\-language\fR=\fILANG\fR
|
|---|
| 44 | specify the set of M4 macros to use
|
|---|
| 45 | .TP
|
|---|
| 46 | \fB\-C\fR, \fB\-\-cache\fR=\fIDIRECTORY\fR
|
|---|
| 47 | preserve results for future runs in DIRECTORY
|
|---|
| 48 | .TP
|
|---|
| 49 | \fB\-\-no\-cache\fR
|
|---|
| 50 | disable the cache
|
|---|
| 51 | .TP
|
|---|
| 52 | \fB\-m\fR, \fB\-\-mode\fR=\fIOCTAL\fR
|
|---|
| 53 | change the non trace output file mode (0666)
|
|---|
| 54 | .TP
|
|---|
| 55 | \fB\-M\fR, \fB\-\-melt\fR
|
|---|
| 56 | don't use M4 frozen files
|
|---|
| 57 | .SS "Languages include:"
|
|---|
| 58 | .TP
|
|---|
| 59 | `Autoconf'
|
|---|
| 60 | create Autoconf configure scripts
|
|---|
| 61 | .TP
|
|---|
| 62 | `Autotest'
|
|---|
| 63 | create Autotest test suites
|
|---|
| 64 | .TP
|
|---|
| 65 | `M4sh'
|
|---|
| 66 | create M4sh shell scripts
|
|---|
| 67 | .TP
|
|---|
| 68 | `M4sugar'
|
|---|
| 69 | create M4sugar output
|
|---|
| 70 | .SS "Warning categories include:"
|
|---|
| 71 | .TP
|
|---|
| 72 | `cross'
|
|---|
| 73 | cross compilation issues
|
|---|
| 74 | .TP
|
|---|
| 75 | `gnu'
|
|---|
| 76 | GNU coding standards (default in gnu and gnits modes)
|
|---|
| 77 | .TP
|
|---|
| 78 | `obsolete'
|
|---|
| 79 | obsolete features or constructions
|
|---|
| 80 | .TP
|
|---|
| 81 | `override'
|
|---|
| 82 | user redefinitions of Automake rules or variables
|
|---|
| 83 | .TP
|
|---|
| 84 | `portability'
|
|---|
| 85 | portability issues (default in gnu and gnits modes)
|
|---|
| 86 | .TP
|
|---|
| 87 | `syntax'
|
|---|
| 88 | dubious syntactic constructs (default)
|
|---|
| 89 | .TP
|
|---|
| 90 | `unsupported'
|
|---|
| 91 | unsupported or incomplete features (default)
|
|---|
| 92 | .TP
|
|---|
| 93 | `all'
|
|---|
| 94 | all the warnings
|
|---|
| 95 | .TP
|
|---|
| 96 | `no\-CATEGORY'
|
|---|
| 97 | turn off warnings in CATEGORY
|
|---|
| 98 | .TP
|
|---|
| 99 | `none'
|
|---|
| 100 | turn off all the warnings
|
|---|
| 101 | .TP
|
|---|
| 102 | `error'
|
|---|
| 103 | treat warnings as errors
|
|---|
| 104 | .PP
|
|---|
| 105 | The environment variables `M4' and `WARNINGS' are honored.
|
|---|
| 106 | .SS "Library directories:"
|
|---|
| 107 | .TP
|
|---|
| 108 | \fB\-B\fR, \fB\-\-prepend\-include\fR=\fIDIR\fR
|
|---|
| 109 | prepend directory DIR to search path
|
|---|
| 110 | .TP
|
|---|
| 111 | \fB\-I\fR, \fB\-\-include\fR=\fIDIR\fR
|
|---|
| 112 | append directory DIR to search path
|
|---|
| 113 | .SS "Tracing:"
|
|---|
| 114 | .TP
|
|---|
| 115 | \fB\-t\fR, \fB\-\-trace\fR=\fIMACRO\fR
|
|---|
| 116 | report the MACRO invocations
|
|---|
| 117 | .TP
|
|---|
| 118 | \fB\-p\fR, \fB\-\-preselect\fR=\fIMACRO\fR
|
|---|
| 119 | prepare to trace MACRO in a future run
|
|---|
| 120 | .SS "Freezing:"
|
|---|
| 121 | .TP
|
|---|
| 122 | \fB\-F\fR, \fB\-\-freeze\fR
|
|---|
| 123 | produce an M4 frozen state file for FILES
|
|---|
| 124 | .SH AUTHOR
|
|---|
| 125 | Written by Akim Demaille.
|
|---|
| 126 | .SH "REPORTING BUGS"
|
|---|
| 127 | Report bugs to <bug\[email protected]>.
|
|---|
| 128 | .SH COPYRIGHT
|
|---|
| 129 | Copyright \(co 2006 Free Software Foundation, Inc.
|
|---|
| 130 | .br
|
|---|
| 131 | This is free software. You may redistribute copies of it under the terms of
|
|---|
| 132 | the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
|
|---|
| 133 | There is NO WARRANTY, to the extent permitted by law.
|
|---|
| 134 | .SH "SEE ALSO"
|
|---|
| 135 | .BR autoconf (1),
|
|---|
| 136 | .BR automake (1),
|
|---|
| 137 | .BR autoreconf (1),
|
|---|
| 138 | .BR autoupdate (1),
|
|---|
| 139 | .BR autoheader (1),
|
|---|
| 140 | .BR autoscan (1),
|
|---|
| 141 | .BR config.guess (1),
|
|---|
| 142 | .BR config.sub (1),
|
|---|
| 143 | .BR ifnames (1),
|
|---|
| 144 | .BR libtool (1).
|
|---|
| 145 | .PP
|
|---|
| 146 | The full documentation for
|
|---|
| 147 | .B autom4te
|
|---|
| 148 | is maintained as a Texinfo manual. If the
|
|---|
| 149 | .B info
|
|---|
| 150 | and
|
|---|
| 151 | .B autom4te
|
|---|
| 152 | programs are properly installed at your site, the command
|
|---|
| 153 | .IP
|
|---|
| 154 | .B info autom4te
|
|---|
| 155 | .PP
|
|---|
| 156 | should give you access to the complete manual.
|
|---|
