Various fixes.

* README: Fix typo.
* doc/usr-acl.texi: New file.
* doc/Makefile.am (pies_TEXINFOS): Remove pies.texi,
add usr-acl.texi
(check-config, check-sub-config): Handle @deffnx
* doc/pies.texi: Update.
* src/Makefile.am (AM_CPPFLAGS): Remove superfluous defs,
use ../gnu/configmake.h instead
* src/acl.c (_acl_common_section_parser): Handle tag, depending
on the value of `flag' parameter.
Avoid coredumping on NULL pacl.
(acl_section_parser, defacl_section_parser): Update calls to
_acl_common_section_parser.
* src/pies.c (STATEDIR): Replace with LOCALSTATEDIR.
(GRECS_VALUE_IS_EMPTY): New define (possibly belongs to
grecs more than to pies).
(assert_grecs_value_type)
(return_code_section_parser): Use GRECS_VALUE_IS_EMPTY to check
for empty value.
(_get_array_arg): Bugfix.
(component_keywords, pies_keywords): Add missing docstrings.
* src/progman.c (TYPE_RETR): Rename to TYPE_REDIRECTOR.
All uses updated.

8 files changed, 411 insertions, 163 deletions

diff --git a/README-hacking b/README-hacking
index 9441c46..2f22e74 100644
--- a/README-hacking
+++ b/README-hacking
@@ -47,7 +47,7 @@ contents:
 Replace `$HOME/gnulib' with the actual directory where the Gnulib
 sources reside.
 
-If you wish to avoid synchronising translations, add this option:
+If you wish to avoid synchronizing translations, add this option:
 --skip-po.
 
 For more information about `bootstrap', run `bootstrap --help'.
diff --git a/doc/Makefile.am b/doc/Makefile.am
index fec8df3..bb2ff49 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -18,8 +18,8 @@ info_TEXINFOS=pies.texi
 pies_TEXINFOS=\
  fdl.texi\
  macros.texi\
- pies.texi\
- rendition.texi
+ rendition.texi\
+ usr-acl.texi
 
 EXTRA_DIST = \
  check-docs.sh\
@@ -48,7 +48,7 @@ check-options:
 check-config:
         @check-docs.sh 'configuration statements' \
            '/pies_keywords\[\] *= *{/,/^}/s/[ \t]*{ *"\([^,"]*\)".*/\1/pg' \
-           's/@deffn {Config} *\([^@,]*\).*/\1/p' \
+           's/@deffnx\{0,1\} {Config} *\([^@,]*\).*/\1/p' \
            $(top_srcdir)/src/pies.c -- \
            $(MAKEINFO) $(AM_MAKEINFOFLAGS) $(MAKEINFOFLAGS) -I $(srcdir) -E - \
                 $(info_TEXINFOS) 
@@ -58,7 +58,7 @@ check-sub-config:
         while read ident kw; do \
            check-docs.sh "$$ident configuration statements" \
            "/$$kw"'\[\] *= *{/,/^}/s/[ \t]*{ *"\([^,"]*\)".*/\1/pg' \
-           "s/@deffn {Config: *$${ident}}"' *\([^@,]*\).*/\1/p' \
+           "s/@deffnx\{0,1\} {Config: *$${ident}}"' *\([^@,]*\).*/\1/p' \
            $(top_srcdir)/src/pies.c $(top_srcdir)/src/acl.c -- \
            $(MAKEINFO) $(AM_MAKEINFOFLAGS) $(MAKEINFOFLAGS) -I $(srcdir) -E - \
                 $(info_TEXINFOS); \
diff --git a/doc/pies.texi b/doc/pies.texi
index e1ca650..e47f6a6 100644
--- a/doc/pies.texi
+++ b/doc/pies.texi
@@ -90,8 +90,46 @@ Appendices
 * Concept Index::        Index of Concepts.
 
 @detailmenu
-@end detailmenu
+ --- The Detailed Node Listing ---
+
+Pies Configuration File
+
+* Syntax::               Configuration File Syntax
+* Component Statement::
+* Notification::         Mail Notification
+* ACL::                  Access Control Lists
+* include-meta1::
+* Global Configuration::
+
+Configuration File Syntax
+
+* Comments::
+* Statements::
+* Preprocessor::         Using preprocessor to improve the configuration.
+
+Component Statement
+
+* Prerequisites::
+* Component Privileges::
+* Resources::
+* Actions Before Startup::
+* Exit Actions::
+* Output Redirectors::
+* Inetd-Style Components::
+* Meta1-Style Components::
+* Component Syntax Summary::
+
+Global Configuration
+
+* Less Useful Statements::
+
+Configuration Example
 
+* Simple Pies::
+* Hairy Pies::
+* Inetd Pies::
+
+@end detailmenu
 @end menu
 
 @node Intro
@@ -200,7 +238,7 @@ reports them on the standard error and exits with a non-zero status.
 @command{pies} to check its configuration file and exit with status 0
 if no errors were detected, and with status 1 otherwise.
 
-@opindex -E, introduced
+@cindex @option{-E}, introduced
   Before parsing, configuration file is preprocessed using
 @command{m4} (@pxref{Preprocessor}).  To see the preprocessed
 configuration without actually parsing it, use @option{-E} command
@@ -212,8 +250,9 @@ detail.  You can receive a concise summary of all configuration
 directives any time by running @command{pies --config-help}.
 
 @menu
-* Syntax::               Configuration file syntax.
+* Syntax::               Configuration File Syntax
 * Component Statement::
+* Notification::         Mail Notification
 * ACL::                  Access Control Lists
 * include-meta1::
 * Global Configuration::
@@ -438,21 +477,16 @@ this is not required.
 @subsection Using Preprocessor to Improve the Configuration.
 @cindex preprocessor
 @cindex m4
-  Before parsing configuration file, @command{pies} preprocesses
-it.  The built-in preprocessor handles only file inclusion
-and @code{#line} statements (@FIXME-pxref{Pragmatic Comments}), while the
-rest of traditional preprocessing facilities, such as macro expansion,
-is supported via @command{m4}, which is used as an external preprocessor. 
-
-  The detailed description of @command{m4} facilities lies far beyond
-the scope of this document.  You will find a complete user manual in
+  Before parsing, the configuration file is @dfn{preprocessed} using
+external preprocessor @command{m4}.  For a complete user manual, refer
+to
 @ifnothtml
 @ref{Top, GNU M4 manual, GNU M4, m4, GNU M4 macro processor}.
 @end ifnothtml
 @ifhtml
 @uref{http://www.gnu.org/software/m4/manual}.
 @end ifhtml
-For the rest of this subsection we assume the reader is sufficiently
+In this subsection we assume the reader is sufficiently
 acquainted with @command{m4} macro processor.
 
 @flindex pp-setup
@@ -487,7 +521,8 @@ component @var{tag} @{
 The component is identified by its @dfn{tag}, which is given as
 argument to the @code{component} keyword.
 
-The following statements are allowed within the @code{component} block:
+Following are the basic statements which are allowed within the
+@code{component} block:
 
 @deffn {Config: component} mode @var{mode}
   Declare the type (style) of the component.  Accepted values for
@@ -539,7 +574,14 @@ If @var{bool} is @samp{true}, this component is marked as precious.
 Precious components are never disabled by @command{pies}, even if they
 respawn too fast.
 @end deffn
-  
+
+@deffn {Config: component} acl @{ ... @}
+Set access control list for this component.  @xref{ACL}, for a
+detailed description of access control lists.
+@end deffn
+
+The following subsections describe the rest of @samp{component}
+substatements.
 
 @menu
 * Prerequisites::
@@ -724,7 +766,7 @@ terminates with 0 exit code, a corresponding error message is issued
 to the log file.  This behavior can be modified using
 @code{return-code} statement:
 
-@deffn {Config} return-code
+@deffn {Config: component} return-code
 @smallexample
 return-code @var{codes} @{
   @dots{}
@@ -805,60 +847,13 @@ by the administrator.
 @end deffn
 
 @deffn {Config: return-code} notify @var{email-string}
-Send an email notification to addresses in @var{email-string}.  The
-latter is a comma-separated list of email addresses, e.g.:
-
-@smallexample
-notify "root@@localhost,postmaster@@localhost";
-@end smallexample
-
-The message itself is configured by the @code{message}
-statement.
+Send an email notification to addresses in @var{email-string}.
+@xref{Notification}, for a detailed discussion of this feature.
 @end deffn
 
 @deffn {Config: return-code} message @var{string}
 Supply notification message text to use by @code{notify} statement.
-@var{String} must be a valid RFC 822 message text, i.e. it must begin
-with message headers, followed by an empty line and actual message
-body.
-
-The following macro-variables are expanded within @var{string}:
+@xref{Notification}, for a detailed discussion of this feature.