summaryrefslogtreecommitdiffabout
path: root/doc/wydawca.texi
authorSergey Poznyakoff <gray@gnu.org.ua>2012-05-27 12:11:59 (GMT)
committer Sergey Poznyakoff <gray@gnu.org.ua>2012-05-27 12:33:30 (GMT)
commit83d7377354504cf3d92a5bdf9cade07554c6b66e (patch) (side-by-side diff)
tree01d602910d6314edbd5568600e7dfb5b1b215bfa /doc/wydawca.texi
parent5fc301baf79e9cc19b1bc8e7a5940e060611e349 (diff)
downloadwydawca-83d7377354504cf3d92a5bdf9cade07554c6b66e.tar.gz
wydawca-83d7377354504cf3d92a5bdf9cade07554c6b66e.tar.bz2
Implement upload directives version 1.2
* NEWS: Update. * README: Update. * doc/wydawca.texi: Document changes. * src/cmdline.opt: Update copyright years. * src/config.c: Update for new grecs version. New keywords: min-version and max-version. * src/directive.c (directive_unpack_version): New function. (directive_version_in_range_p): Set trp->version and print it. (directive) <replace_dir>: New directive. (directive_table): New directive "replace". (verify_directive_format): Use globals min_directive_version and max_directive_version. (process_directives): Handle replace_dir * src/diskio.c (dir_move_file): Use the "replace" directive to act on existing files. * src/wydawca.c (min_directive_version) (max_directive_version): New globals. (main): Loosen gpgme requirement: version 1.1.0 is Ok. * src/wydawca.h (MAX_DIRECTIVE_VERSION): Set to 102 (file_triplet) <version>: New member. (min_directive_version) (max_directive_version): New globals. (directive_unpack_version): New proto. * tests/upl11.at: New file. * tests/upl12f.at: New file. * tests/upl12t.at: New file. * tests/Makefile.am (TESTSUITE_AT): Add new files. * tests/atlocal.in (wydawca_upload): Change invocation. All uses updated. (wydawca_cmparc): New function. * tests/check-fail.at: Update. * tests/check-notify.at: Update. * tests/check-ok.at: Update. * tests/dist/file12f.directive.asc: New file. * tests/dist/file12t.directive.asc: New file. * tests/etc/wydawca.rcin (test): Define "archive" clause. * tests/mailstats.at: Update. * tests/notify-upl.at: Update. * tests/testsuite.at: Include new files. * tests/upload-dry.at: Update. * tests/upload.at: Update.
Diffstat (limited to 'doc/wydawca.texi') (more/less context) (ignore whitespace changes)
-rw-r--r--doc/wydawca.texi78
1 files changed, 72 insertions, 6 deletions
diff --git a/doc/wydawca.texi b/doc/wydawca.texi
index 1bdea48..1d47cf5 100644
--- a/doc/wydawca.texi
+++ b/doc/wydawca.texi
@@ -31,7 +31,7 @@ Published by the Free Software Foundation,
51 Franklin Street, Fifth Floor
Boston, MA 02110-1301, USA
-Copyright @copyright{} 2007, 2009-2011 Sergey Poznyakoff
+Copyright @copyright{} 2007, 2009-2012 Sergey Poznyakoff
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
@@ -97,6 +97,7 @@ How to Configure @command{wydawca}.
* Syntax:: Configuration file syntax.
* general::
+* versions::
* user privileges::
* daemon::
* tcp-wrapper::
@@ -196,17 +197,27 @@ handle any number of @samp{source/destination} pairs (called
notification mechanism, allowing both package maintainers and site
administrators to be immediately notified about any occurring problems.
- @command{Wydawca} supports version 1.1 of directory file, as
-described in
+ @command{Wydawca} supports upload directive versions 1.1@footnote{
@ifnothtml
-@ref{FTP Upload Directive File - v1.1,
+@xref{FTP Upload Directive File - v1.1,
Standalone directives, Standalone directives,
maintain, Information for maintainers of GNU software}.
@end ifnothtml
@ifhtml
-@uref{http://www.gnu.org/prep/maintain/html_node/FTP-Upload-Directive-File-_002d-v1_002e1.html,
+See @uref{http://www.gnu.org/prep/maintain/html_node/FTP-Upload-Directive-File-_002d-v1_002e1.html,
+Standalone directives}.
+@end ifhtml
+} and 1.2@footnote{
+@ifnothtml
+@xref{FTP Upload Directive File - v1.2,
+Standalone directives, Standalone directives,
+maintain, Information for maintainers of GNU software}.
+@end ifnothtml
+@ifhtml
+See @uref{http://www.gnu.org/prep/maintain/html_node/FTP-Upload-Directive-File-_002d-v1_002e2.html,
Standalone directives}.
@end ifhtml
+}.
The program is written entirely in @acronym{C}, is highly
effective and consumes little resources.
@@ -482,6 +493,7 @@ directives any time by running @command{wydawca --config-help}.
@menu
* Syntax:: Configuration file syntax.
* general::
+* versions::
* user privileges::
* daemon::
* tcp-wrapper::
@@ -950,6 +962,60 @@ outgoing messages are looked up in this directory. @xref{statreports,
gpg-sign}, and @ref{event notification, gpg-sign}.
@end deffn
+@node versions
+@section Upload Directive Versions
+At the time of this writing, FSF has published three versions of the
+upload directives, numbered 1.0 through 1.2. The version 1.0 is
+considered obsolete and was withdrawn in 2006. The only difference
+between versions 1.1 and 1.2 is in handling of files that existed
+prior to upload. The version 1.1 implied automatic archivation of the
+existing files and their replacement with the newly uploaded versions.
+The version 1.2 introduces a new keyword (@samp{replace}) for that
+purpose, which determines its further actions.
+
+For a detailed information about version 1.1, see
+@ifnothtml
+@xref{FTP Upload Directive File - v1.1,
+Standalone directives, Standalone directives,
+maintain, Information for maintainers of GNU software}.
+@end ifnothtml
+@ifhtml
+@uref{http://www.gnu.org/prep/maintain/html_node/FTP-Upload-Directive-File-_002d-v1_002e1.html,
+Standalone directives}.
+@end ifhtml
+
+The version 1.2 and its differences from 1.1 are discussed in
+@ifnothtml
+@xref{FTP Upload Directive File - v1.2,
+Standalone directives, Standalone directives,
+maintain, Information for maintainers of GNU software}.
+@end ifnothtml
+@ifhtml
+@uref{http://www.gnu.org/prep/maintain/html_node/FTP-Upload-Directive-File-_002d-v1_002e2.html,
+Standalone directives}.
+@end ifhtml
+
+By default, @command{wydawca} supports both versions. The supported range of
+versions can be abridged using the following configuration statements:
+
+@deffn {Config} min-version vn
+Sets minimal allowed directive file version. The @var{vn} argument
+must have the form @samp{@var{major}.@var{minor}} and can not be less
+than @samp{1.1}.
+@end deffn
+
+@deffn {Config} max-version vn
+Sets maximal allowed directive file version.
+@end deffn
+
+For example, the following statements configure @command{wydawca} to
+accept only directive files of version 1.2:
+
+@example
+min-version 1.2;
+max-version 1.2;
+@end example
+
@node user privileges
@section User Privileges
@@ -1748,7 +1814,7 @@ Always make numbered backups.
@itemx existing
@kwindex nil@r{, backup method}
@kwindex existing@r{, backup method}
-Make numbered backups of files that already have them, simple backups.
+Make numbered backups of files that already have them, and simple backups
of the others.
@item never

Return to:

Send suggestions and report system problems to the System administrator.