Wydawca |
|
Release Submission Daemon |
Sergey Poznyakoff |
Before parsing its configuration file, wydawca
preprocesses
it. The built-in preprocessor handles only file inclusion
and #line
statements (see Pragmatic Comments), while the
rest of traditional preprocessing facilities, such as macro expansion,
is supported via m4
, which is used as an external preprocessor.
The detailed description of m4
facilities lies far beyond
the scope of this document. You will find a complete user manual in
http://www.gnu.org/software/m4/manual.
For the rest of this subsection we assume the reader is sufficiently
acquainted with m4
macro processor.
The external preprocessor is invoked with -s flag, which instructs it to include line synchronization information in its output. This information is then used by the parser to display meaningful diagnostic. An initial set of macro definitions is supplied by the pp-setup file, located in $prefix/share/wydawca/version/include directory (where version means the version of Wydawca package).
The default pp-setup file renames all m4
built-in
macro names so they all start with the prefix ‘m4_’. This
is similar to GNU m4 --prefix-builtin options, but has an
advantage that it works with non-GNU m4
implementations as
well.
To examine the preprocessed configuration, use the -E
option. The output from m4
will be printed on the standard
output and the program will terminate.
Additional control over the preprocessor is provided via the following command line options:
Define the preprocessor symbol name as having value, or empty.
Add dir to the list of directories searched for preprocessor include files.
Disable preprocessor.
Use command instead of the default preprocessor.
This document was generated on January 6, 2021 using makeinfo.
Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.