summaryrefslogtreecommitdiff
path: root/doc/m4.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/m4.1')
-rw-r--r--doc/m4.1121
1 files changed, 121 insertions, 0 deletions
diff --git a/doc/m4.1 b/doc/m4.1
new file mode 100644
index 00000000..beb6a584
--- /dev/null
+++ b/doc/m4.1
@@ -0,0 +1,121 @@
+." DO NOT MODIFY THIS FILE! It was generated by helptoman 1.1.1.1.
+.TH M4 1 "October 1998" "GNU m4 1.4h" "GNU User's Manual"
+.SH NAME
+m4 \- short documentation for m4 1.4h
+.SH SYNOPSIS
+.B m4
+[\fIOPTION\fR]...\fI \fR[\fIFILE\fR]...\fI\fR
+.SH DESCRITION
+.PP
+Mandatory or optional arguments to long options are mandatory or optional
+for short options too.
+.SS "Operation modes:"
+.TP
+\fB\-\-help\fR
+display this help and exit
+.TP
+\fB\-\-version\fR
+output version information and exit
+.TP
+\fB\-e\fR, \fB\-\-interactive\fR
+unbuffer output, ignore interrupts
+.TP
+\fB\-E\fR, \fB\-\-fatal\-warnings\fR
+stop execution after first warning
+.TP
+\fB\-Q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
+suppress some warnings for builtins
+.TP
+\fB\-P\fR, \fB\-\-prefix\-builtins\fR
+force a `m4_' prefix to all builtins
+.SS "Preprocessor features:"
+.TP
+\fB\-I\fR, \fB\-\-include\fR=\fIDIRECTORY\fR
+search this directory second for includes
+.TP
+\fB\-D\fR, \fB\-\-define=NAME\fR[=\fIVALUE\fR]
+enter NAME has having VALUE, or empty
+.TP
+\fB\-U\fR, \fB\-\-undefine\fR=\fINAME\fR
+delete builtin NAME
+.TP
+\fB\-s\fR, \fB\-\-synclines\fR
+generate `#line NO "FILE"' lines
+.SS "Limits control:"
+.TP
+\fB\-G\fR, \fB\-\-traditional\fR
+suppress all GNU extensions
+.TP
+\fB\-H\fR, \fB\-\-hashsize\fR=\fIPRIME\fR
+set symbol lookup hash table size
+.TP
+\fB\-L\fR, \fB\-\-nesting\-limit\fR=\fINUMBER\fR
+change artificial nesting limit
+.SS "Frozen state files:"
+.TP
+\fB\-F\fR, \fB\-\-freeze\-state\fR=\fIFILE\fR
+produce a frozen state on FILE at end
+.TP
+\fB\-R\fR, \fB\-\-reload\-state\fR=\fIFILE\fR
+reload a frozen state from FILE at start
+.SS "Debugging:"
+.TP
+\fB\-d\fR, \fB\-\-debug\fR=\fI[FLAGS]\fR
+set debug level (no FLAGS implies `aeq')
+.TP
+\fB\-t\fR, \fB\-\-trace\fR=\fINAME\fR
+trace NAME when it will be defined
+.TP
+\fB\-l\fR, \fB\-\-arglength\fR=\fINUM\fR
+restrict macro tracing size
+.TP
+\fB\-o\fR, \fB\-\-error\-output\fR=\fIFILE\fR
+redirect debug and trace output
+.SS "FLAGS is any of:"
+.TP
+t
+trace for all macro calls, not only traceon'ed
+.TP
+a
+show actual arguments
+.TP
+e
+show expansion
+.TP
+q
+quote values as necessary, with a or e flag
+.TP
+c
+show before collect, after collect and after call
+.TP
+x
+add a unique macro call id, useful with c flag
+.TP
+f
+say current input file name
+.TP
+l
+say current input line number
+.TP
+p
+show results of path searches
+.TP
+i
+show changes in input files
+.TP
+V
+shorthand for all of the above flags
+.PP
+If no FILE or if FILE is `-', standard input is read.
+.SH SEE ALSO
+The full documentation for
+.B m4
+is maintained as a Texinfo manual. If the
+.B info
+and
+.B m4
+programs are properly installed at your site, the command
+.IP
+.B info m4
+.PP
+should allow you to access the manual as an hypertext.