aboutsummaryrefslogtreecommitdiff
path: root/doc/wydawca.texi
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org>2020-04-23 21:14:49 +0300
committerSergey Poznyakoff <gray@gnu.org>2020-04-23 21:27:47 +0300
commit8234484dba123ad8001657def8fb57133f9610bf (patch)
tree3c648730985b0ec37ed6fa5af7fe35fedaeb3c31 /doc/wydawca.texi
parent80466e8f237077f11134554ab1a68b47f49616e2 (diff)
downloadwydawca-8234484dba123ad8001657def8fb57133f9610bf.tar.gz
wydawca-8234484dba123ad8001657def8fb57133f9610bf.tar.bz2
Rewrite the testsuite.
Use gpg2 to create the keys, and sign files as necessary. * NEWS: Update. * doc/wydawca.texi: Update. * configure.ac: Detect the presence of GPG version 2. * src/cmdline.opt (--single-process): Remove. * src/config.c: Remove the "single-process" statement. * src/triplet.c (triplet_enqueue): Fix eventual NULL dereference. (wy_triplet_wait): Update the WY_STAT_INCOMPLETE_TRIPLETS counter. * src/wydawca.c (single_process_option): Remove global. * src/wydawca.h (single_process): Remove global. * tests/.gitignore: Update. * tests/Makefile.am: Update. * tests/atlocal.in: Rewrite. * tests/chargen.c: New auxiliary tool * tests/dist/file: Remove. * tests/dist/file.directive.asc: Remove. * tests/dist/file.sig: Remove. * tests/dist/file12f.directive.asc: Remove. * tests/dist/file12t.directive.asc: Reemove. * tests/dist/rmsymlink.directive.asc: Remove. * tests/dist/symlink.directive.asc: Remove. * tests/etc/notify.cfin: Rename to tests/etc/notify.cf * tests/etc/Makefile.am: Update. * tests/etc/dbgen.sh: New file. * tests/etc/keygen.sh: New file. * tests/etc/project: New file. * tests/etc/pubring.asc: Remove. * tests/etc/secring.asc: Remove. * tests/etc/wydawca.cfin: Remove. * tests/*.at: Rewrite.
Diffstat (limited to 'doc/wydawca.texi')
-rw-r--r--doc/wydawca.texi58
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}

Return to:

Send suggestions and report system problems to the System administrator.