diff options
author | Sergey Poznyakoff <gray@gnu.org> | 2021-02-02 21:36:00 +0200 |
---|---|---|
committer | Sergey Poznyakoff <gray@gnu.org> | 2021-02-03 07:51:00 +0200 |
commit | c3ee8d97ea8a427abd455c903157da94623e83dd (patch) | |
tree | 6048cbc108e4a76ff56d6429e60150611bee11be /doc | |
parent | 494fe491d81505a83207602d5ec129b0bf33a484 (diff) | |
download | pies-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.am | 4 | ||||
-rw-r--r-- | doc/pies.texi | 79 |
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 |