aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2009-12-09 15:48:09 +0200
committerSergey Poznyakoff <gray@gnu.org.ua>2009-12-09 15:48:09 +0200
commit41c55a1a93840363c996fc9aae54329dadcf0a86 (patch)
tree737d4789555e44ee1dc7356ae1edcad54cdee623 /doc
parentb63563c9c5271d088d80a31f780be74d1c16fef4 (diff)
downloadpies-41c55a1a93840363c996fc9aae54329dadcf0a86.tar.gz
pies-41c55a1a93840363c996fc9aae54329dadcf0a86.tar.bz2
Improve docs.
* doc/fix-sentence-spacing.sed: New file. * doc/Makefile.am (EXTRA_DIST): Add fix-sentence-spacing.sed. (check-tabs, check-sentence-spacing) (fix-sentence-spacing): New rules. (check-format): Rewrite rule. * doc/pies.texi: Update.
Diffstat (limited to 'doc')
-rw-r--r--doc/Makefile.am22
-rw-r--r--doc/fix-sentence-spacing.sed4
-rw-r--r--doc/pies.texi113
3 files changed, 106 insertions, 33 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 6d47f51..73bd72a 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -25,2 +25,3 @@ EXTRA_DIST = \
check-docs.sh\
+ fix-sentence-spacing.sed\
gendocs_template\
@@ -33,3 +34,3 @@ clean-local:
# Checking
-check-format:
+check-tabs:
@if test -n "`cat $(info_TEXINFOS) $(pies_TEXINFOS) | tr -d -c '\t'`"; then \
@@ -39,2 +40,10 @@ check-format:
+check-sentence-spacing:
+ @if cat $(info_TEXINFOS) $(pies_TEXINFOS) | sed 's/i\.e\. //g;s/e\.g\. //g;s/\.\.\. @//g' | grep -q '\. [@A-Z]'; then \
+ echo >&2 "Sources contain single-space sentence separators"; \
+ echo >&2 "Run make fix-sentence-spacing to fix"; \
+ fi
+
+check-format: check-tabs check-sentence-spacing
+
check-options:
@@ -132,3 +141,12 @@ untabify:
-final: untabify master-menu
+fix-sentence-spacing:
+ for file in $(info_TEXINFOS) $(wydawca_TEXINFOS); \
+ do \
+ if grep -q '\. [@A-Z]' $$file; then \
+ mv $$file $${file}~; \
+ sed -r 's/\. ([@A-Z])/. \1/g' $${file}~ > $$file; \
+ fi; \
+ done
+
+final: untabify fix-sentence-spacing master-menu
diff --git a/doc/fix-sentence-spacing.sed b/doc/fix-sentence-spacing.sed
new file mode 100644
index 0000000..906a670
--- /dev/null
+++ b/doc/fix-sentence-spacing.sed
@@ -0,0 +1,4 @@
+s/\. ([@A-Z])/. \1/g
+s/e\.g\. /e.g. /g
+s/i\.e\. /i.e. /g
+s/\.\.\. @\}/... @}/g
diff --git a/doc/pies.texi b/doc/pies.texi
index 96cbfb5..e21ea62 100644
--- a/doc/pies.texi
+++ b/doc/pies.texi
@@ -314,3 +314,3 @@ directives any time by running @command{pies --config-help}.
There are three classes of lexical tokens: keywords, values, and
-separators. Blanks, tabs, newlines and comments, collectively called
+separators. Blanks, tabs, newlines and comments, collectively called
@dfn{white space} are ignored except as they serve to separate
@@ -651,12 +651,12 @@ meaning as @samp{wait} in @file{inetd.conf} file, i.e. it tells
@command{pies} to wait for the server program to
-return. @FIXME-xref{inetd}.
+return. @FIXME-xref{inetd}.
@item tcpmux
-This is a @acronym{TCPMUX} component. @FIXME-xref{tcpmux}.
+This is a @acronym{TCPMUX} component. @xref{TCPMUX}.
@item tcpmuxplus
-This is a @acronym{TCPMUX+} component. @FIXME-xref{tcpmux}.
+This is a @acronym{TCPMUX+} component. @xref{TCPMUX}.
@item internal
-This is an internal inetd component. @FIXME-xref{internal inetd}.
+This is an internal inetd component. @xref{builtin}.
@@ -664,3 +664,3 @@ This is an internal inetd component. @FIXME-xref{internal inetd}.
This inetd component wants socket description variables in its
-environment. @FIXME-xref{sockenv}.
+environment. @FIXME-xref{sockenv}.
@@ -833,2 +833,7 @@ before assignment.
+@deffn {Config: component} max-instances @var{n}
+Sets the maximum number of simultaneously running instances of this
+component.
+@end deffn
+
@node Actions Before Startup
@@ -1025,15 +1030,19 @@ Define a socket to listen on. Allowed values for @var{url} are:
@table @asis
-@item file name
-Specifies a @acronym{UNIX} socket file name. You may use a relative
-file name, provided that @code{chdir} statement is used for this
-component (@pxref{Actions Before Startup, chdir}).
-
-@item local://@var{file}[;@var{args}]
-@itemx file://@var{file}[;@var{args}]
-@itemx unix://@var{file}[;@var{args}]
+@flindex /etc/protocols
+@item inet[+@var{proto}]://@var{ip}:@var{port}
+Listen on IPv4@footnote{Support for IPv6 will be added in future
+versions.}. address @var{ip} (may be given as a symbolic host name),
+on port @var{port}. Optional @var{proto} defines the protocol
+to use. It must be a valid protocol name as given in
+@file{/etc/protocols}. Default is @samp{tcp}.
+
+@item local[+@var{proto}]://@var{file}[;@var{args}]
+@itemx file[+@var{proto}]://@var{file}[;@var{args}]
+@itemx unix[+@var{proto}]://@var{file}[;@var{args}]
Listen on the @acronym{UNIX} socket file @var{file}, which is either
-an absolute or relative file name, as described above. Optional
-arguments @var{args} control ownership and file mode of @var{file}. They
-are a list of assignments, separated by semicolons. The following
-values are allowed:
+an absolute or relative file name, as described above. The
+@var{proto} part is as described above. Optional arguments, @var{args},
+control ownership and file mode of @var{file}. They are a list of
+assignments, separated by semicolons. The following values are
+allowed:
@@ -1060,11 +1069,53 @@ socket "unix:/var/run/socket;user=nobody;group=mail;mode=770";
-@item inet://@var{ip}:@var{port}
-Listen on IPv4 address @var{ip} (may be given as a symbolic host name),
-on port @var{port}.
+@item file name
+Specifies a @acronym{UNIX} socket file name. It is a shortcut for
+@samp{unix:@var{file-name}}. You may use a relative file name,
+provided that @code{chdir} statement is used for this component
+(@pxref{Actions Before Startup, chdir}).
@end table
+@end deffn
+
+@deffn {Config: component} socket-type @var{type}
+Sets the socket type. Allowed values for @var{type} are:
+@samp{stream}, @samp{dgram}, @samp{raw}, @samp{rdm},
+@samp{seqpacket}. Default is @samp{stream}. Notice that
+some socket types may not be implemented by all protocol
+families, e.g. @samp{seqpacket} is not implemented for
+@samp{inet}.
+@end deffn
+
+@anchor{max-rate}
+@deffn {Config: component} max-rate @var{n}
+Specifies the maximum number of times the component can be invoked in
+one minute; the default is unlimited. A rate of @samp{0} stands for
+@samp{unlimited}.
+@end deffn
+
+@deffn {Config: component} max-instances @var{n}
+Sets the maximum number of simultaneously running instances of this
+component. It is equivalent to the maximum number of simultaneously
+opened connections.
+@end deffn
+
+@menu
+* builtin:: Built-in Inetd Services
+* TCPMUX:: TCPMUX Services
+@end menu
+
+@node builtin
+@subsubsection Built-in Inetd Services
+@cindex builtin services
+@WRITEME
+
+@node TCPMUX
+@subsubsection TCPMUX Services
+@cindex TCPMUX
+@UNREVISED
+
+@deffn {Config: component} service @var{name}
+Sets the name of the service for TCPMUX sub-services.
+@end deffn
-Notice, that @command{pies} version @value{VERSION} handles only
-@acronym{TCP} sockets and only IPv4 addresses. Support for IPv6 will
-be added in future versions. Support for @acronym{UDP} sockets will
-be added if there is a demand.
+@deffn {Config: component} tcpmux-master @var{name}
+Sets the name of the master TCPMUX service.
@end deffn
@@ -1740,3 +1791,3 @@ return-code (EX_USAGE, EX_CONFIG) @{
which means it encountered some configuration problem.
- I will not restart it automatically. Please fix its configuration
+ I will not restart it automatically. Please fix its configuration
and restart it manually at your earliest convenience.
@@ -1964,3 +2015,3 @@ Display a short usage summary and exit.
@itemx -i
-Run in @command{inetd}-compatibility mode. It is roughly
+Run in @command{inetd}-compatibility mode. It is roughly
equivalent to @command{pies --instance=inetd --syntax=inetd}.
@@ -2002,9 +2053,9 @@ for @var{type} are:
@item pies
-Native @command{pies} configuration. @xref{Pies Configuration File}.
+Native @command{pies} configuration. @xref{Pies Configuration File}.
@item inetd
-@samp{Inetd}-style configuration files. @FIXME-xref{inetd}.
+@samp{Inetd}-style configuration files. @FIXME-xref{inetd}.
@item meta1
-@samp{meta1}-style configuration files. @FIXME-xref{meta1}.
+@samp{meta1}-style configuration files. @FIXME-xref{meta1}.
@end table
@@ -2020,3 +2071,3 @@ Log to syslog. This is the default.
Set maximum connection rate (connections per second) for inetd-style
-components. @FIXME-xref{inetd rate}.
+components. @xref{max-rate,, inetd component rate}.

Return to:

Send suggestions and report system problems to the System administrator.