aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org>2021-02-02 21:36:00 +0200
committerSergey Poznyakoff <gray@gnu.org>2021-02-03 07:51:00 +0200
commitc3ee8d97ea8a427abd455c903157da94623e83dd (patch)
tree6048cbc108e4a76ff56d6429e60150611bee11be /doc
parent494fe491d81505a83207602d5ec129b0bf33a484 (diff)
downloadpies-c3ee8d97ea8a427abd455c903157da94623e83dd.tar.gz
pies-c3ee8d97ea8a427abd455c903157da94623e83dd.tar.bz2
External preprocessor can be selected when building the package and at runtime.
* configure.ac: Report selected preprocessor. Version 1.5.90. * doc/Makefile.am: Don't distribute gendocs.pl and gendocs_template * grecs: Upgrade. * lib/pp.c (pp_command_line): Use the grecs_preprocessor variable instead of DEFAULT_PREPROCESSOR macro. * src/cmdline.opt: New options: --preprocessor and --no-preprocessor. Report the preprocessor command and setup file when called with --help. * src/pies.c (config_init): Initialize grecs_preprocessor. * NEWS: Document changes. * doc/pies.texi: Document new options. * tests/accept.at: Invoke pies with --no-preprocessor. * tests/builtin.at: Likewise. * tests/control.at: Likewise. * tests/cyclic.at: Likewise. * tests/env.at: Likewise. * tests/envglobal.at: Likewise. * tests/expandenv.at: Likewise. * tests/inet.at: Likewise. * tests/maxinst.at: Likewise. * tests/passfd.at: Likewise. * tests/redirect.at: Likewise. * tests/respawn.at: Likewise. * tests/ret-exec.at: Likewise. * tests/ret-notify.at: Likewise. * tests/shell.at: Likewise. * tests/shutdown.at: Likewise. * tests/startup.at: Likewise.
Diffstat (limited to 'doc')
-rw-r--r--doc/Makefile.am4
-rw-r--r--doc/pies.texi79
2 files changed, 51 insertions, 32 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am
index dddf34b..15b5ca2 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -22,9 +22,6 @@ pies_TEXINFOS=\
macros.texi\
usr-acl.texi
-EXTRA_DIST = \
- gendocs_template
-
clean-local:
@rm -rf manual
@@ -76,7 +73,6 @@ untabify: imprimatur-untabify
final: imprimatur-final
GENDOCS = perl gendocs.pl
-EXTRA_DIST += gendocs.pl
TEXI2DVI=texi2dvi -t '@set $(RENDITION)' -I $(top_srcdir)/imprimatur
diff --git a/doc/pies.texi b/doc/pies.texi
index 0e95138..d5b39ca 100644
--- a/doc/pies.texi
+++ b/doc/pies.texi
@@ -656,17 +656,27 @@ been included, it will not be included again.
@end table
@cindex m4
- The obtained material is then passed to @command{m4} for
-preprocessing. For a complete user manual, refer
-to
+@cindex preprocessor, external
+@cindex external preprocessor
+ The obtained material is then passed to @dfn{external
+preprocessor}. By default, @command{pies} uses GNU @command{m4}@footnote{The
+default preprocessor can be changed (or even disabled) when building the
+package. When invoked with the @option{--help} option @command{pies}
+reports, among others, the preprocessor it is configured to use and
+the location of the preprocessor startup file.
+
+The use of alternative preprocessor can also be requested when
+invoking @command{pies} by the @option{--preprocessor} option or even
+disabled, using the @option{--no-preprocessor}.}. It is a powerful
+macro processor, described in detail in
@ifnothtml
@ref{Top, GNU M4 manual, GNU M4, m4, GNU M4 macro processor}.
@end ifnothtml
@ifhtml
-@uref{http://www.gnu.org/software/m4/manual}.
+@uref{http://www.gnu.org/software/m4/manual, GNU M4 manual}.
@end ifhtml
-In this subsection we assume the reader is sufficiently
-acquainted with @command{m4} macro processor.
+For the rest of this subsection we assume the reader is sufficiently
+acquainted with the @command{m4} macro processor.
@anchor{pp-setup}
@flindex pp-setup
@@ -4380,28 +4390,6 @@ of @var{level}.
@item --dump-depmap
Dump dependency map. @xref{dump-depmap}.
-@opsummary{no-init}
-@item --no-init
-Don't assume @dfn{init mode} (@pxref{Init Process}) if running with PID
-1. @xref{Docker Entrypoint}.
-
-@opsummary{trace-depend}
-@item --trace-depend
-List dependencies for components named in the command line. Without
-arguments, dependencies for each component are listed. @xref{trace-depend}.
-
-@opsummary{trace-prereq}
-@item --trace-prereq
-List prerequisites for components named in the command line. Without
-arguments, prerequisites for each component are listed. @xref{trace-prereq}.
-
-@opsummary{telinit}
-@item --telinit
-@item -T
-Emulate the @command{telinit} legacy interface. The rest of command
-line following this option is processed as @command{telinit} options.
-@xref{telinit command}, for a detailed description of these.
-
@item -E
Preprocess configuration file and exit. @xref{Preprocessor}.
@@ -4437,6 +4425,24 @@ Define the name of the @command{pies} instance. @xref{instances}.
@item --lint
@itemx -t
+@opsummary{no-init}
+@item --no-init
+Don't assume @dfn{init mode} (@pxref{Init Process}) if running with PID
+1. @xref{Docker Entrypoint}.
+
+@opsummary{no-preprocessor}
+@item --no-preprocessor
+Disable the use of the external preprocessor.
+
+@xref{Preprocessor}.
+
+@opsummary{preprocessor}
+@item --preprocessor=@var{cmd}
+Use the command @var{cmd} as the external preprocessor, instead of the
+default @command{m4}.
+
+@xref{Preprocessor}.
+
@opsummary{source-info}
@item --source-info
Show source info with debugging messages. @xref{source-info}.
@@ -4483,6 +4489,23 @@ Native @command{pies} configuration. @xref{Configuration}.
@item --syslog
Log to syslog. This is the default.
+@opsummary{telinit}
+@item --telinit
+@item -T
+Emulate the @command{telinit} legacy interface. The rest of command
+line following this option is processed as @command{telinit} options.
+@xref{telinit command}, for a detailed description of these.
+
+@opsummary{trace-depend}
+@item --trace-depend
+List dependencies for components named in the command line. Without
+arguments, dependencies for each component are listed. @xref{trace-depend}.
+
+@opsummary{trace-prereq}
+@item --trace-prereq
+List prerequisites for components named in the command line. Without
+arguments, prerequisites for each component are listed. @xref{trace-prereq}.
+
@opsummary{rate}
@item --rate=@var{r}
Set maximum connection rate (connections per second) for inetd-style

Return to:

Send suggestions and report system problems to the System administrator.