1 files changed, 20 insertions, 38 deletions
diff --git a/doc/wydawca.texi b/doc/wydawca.texi
index 64a6e36..b05e8b0 100644
--- a/doc/wydawca.texi
+++ b/doc/wydawca.texi
@@ -444,16 +444,13 @@ $ wydawca --spool=ftp --spool=test --source=/home/ftp/test-upload
 @anchor{debug}
 @xopindex{debug, described}
 @sopindex{d, described}
-  The @option{--debug} (@option{-d}) option tells the program to increase its
-debugging level by 1. The @dfn{debugging level} determines amount
-of information the program reports when it runs. Default level is 0,
-which means that only errors and other critical conditions are
-reported. Raising it may be necessary when debugging new configurations. Each
-@option{-d} option raises the level by one, so you can say
-@command{wydawca -dd} to obtain level 2, for example. The maximum
-debugging level (currently it is 4) prints an impractically big
-amount of information, and is useful mainly for @command{wydawca}
-developers.
+  The @option{--debug} (@option{-d}) option tells the program to set its
+debugging level to the given integer value. @dfn{Debugging level}
+determines the amount of information the program reports when it
+runs. Default level is 0, which means that only errors and other
+critical conditions are reported. Raising it may be necessary when
+debugging new configurations. @samp{Wydawca} version @value{version}
+implements 4 distinct debuggin levels.
 
 @anchor{dry-run}
 @xopindex{dry-run, described}
@@ -463,9 +460,11 @@ developers.
 modifications to the disk contents, and to print a verbose description
 of any actions it would have taken. It sets the debugging level to 1
 and directs the diagnostics output to the standard error, as if
-@option{--debug --stderr} options were given. You can raise
-debugging level further by supplying additional @option{--debug}
-options. The @option{--dry-run} option is useful when testing new
+@option{--debug=1 --stderr} options were given. You can further
+control the debugging level by supplying additional @option{--debug}
+options @emph{after} the @option{--dry-run} option.
+
+The @option{--dry-run} option is useful when testing new
 configurations, for example:
 
 @smallexample
@@ -498,10 +497,11 @@ reports them on its error output and exits with a non-zero status.
 other inconsistencies. If no errors were detected, the program exits
 with code 0. Otherwise, the exit code is 78.
 
-  Using this option together with @option{-d} (@option{--debug}),
+  Using this option together with @option{-d1} (@option{--debug=1}),
 causes @command{wydawca} to produce a dump of the configuration parse
-tree. Using the @option{-d} option twice prefixes each statement in
-the dump with the file location where it appeared.
+tree. Setting a higher debugging level (e.g. @option{-d2} option) will
+additionally prefix each statement in the dump with the file location
+where it appeared.
 
 @sopindex{E, introduced}
 @xopindex{no-preprocessor, introduced}
@@ -980,15 +980,6 @@ If @var{bool} is @samp{yes}, run in foreground. @xref{invocation,
 foreground}.
 @end deffn
 
-@deffn {Config} single-process bool
-Configure single process mode. Normally @command{wydawca}
-spawns subprocesses for handling incoming connections and spool jobs.
-This is disabled if @var{bool} is @samp{yes} (a so-called
-@dfn{single-processs mode}). This mode is designed for debugging
-purposes. Do not use it in production environments, because it
-severely impairs performance.
-@end deffn
-
 @deffn {Config} umask value
 Set the default umask. The @var{value} argument must be an octal number.
 @end deffn
@@ -3328,10 +3319,6 @@ daemon @var{arg:@i{boolean}};
 # @xref{general, foreground}.
 foreground @var{arg:@i{boolean}};
 
-# @r{Do not spawn subprocesses.}
-# @xref{general, single-process}.
-single-process @var{arg:@i{boolean}};
-
 # @r{Set pid file name.}
 # @xref{general, pidfile}.
 pidfile @var{file:@i{string}};
@@ -3655,9 +3642,9 @@ Run in daemon mode. @xref{starting,, daemon}.
 
 @opsummary{debug}
 @sopindex{d, summary}
-@item --debug
-@itemx -d
-Increase debugging level by 1.
+@item --debug=@var{n}
+@itemx -d @var{n}
+Set the debugging level to @var{n}.
 
 @xref{debug, The @option{--debug} option}.
 
@@ -3683,7 +3670,7 @@ Dump lexical analyzer traces. This is useful for debugging
 @item --dry-run
 @itemx -n
 @dfn{Dry-run mode}: do nothing, print almost everything. This option
-implies @option{--debug --stderr}.
+implies @option{--debug=1 --stderr}.
 
 @xref{dry-run, The dry-run mode}.
 
@@ -3741,11 +3728,6 @@ Disable preprocessor. @pxref{Preprocessor}.
 @item --preprocessor=@var{command}
 Use @var{command} instead of the default preprocessor. @pxref{Preprocessor}.
 
-@opsummary{single-process}
-@item --single-process
-Serialize job invocations by not forking subprocesses for each job.
-@emph{Do not use this option in production environment}.
-
 @opsummary{source}
 @sopindex{s, summary}
 @item --source=@var{name}