path: root/doc/wydawca.texi
authorSergey Poznyakoff <>2007-09-06 18:51:59 (GMT)
committer Sergey Poznyakoff <>2007-09-06 18:51:59 (GMT)
commit744d3ba681631fed3d8d06efe1ee3d61e174924e (patch) (side-by-side diff)
tree3e7fa786ccdfe6dd39ba11ce200be35207291a7e /doc/wydawca.texi
parent747e41693d7f2a808b3314cf82b3af38f98daf2d (diff)
git-svn-id: file:///svnroot/wydawca/trunk@317 6bb4bd81-ecc2-4fd4-a2d4-9571d19c0d33
Diffstat (limited to 'doc/wydawca.texi') (more/less context) (ignore whitespace changes)
1 files changed, 130 insertions, 3 deletions
diff --git a/doc/wydawca.texi b/doc/wydawca.texi
index b313e4f..1f7ad70 100644
--- a/doc/wydawca.texi
+++ b/doc/wydawca.texi
@@ -1121,7 +1121,7 @@ attempts, or any bad signature was uploaded:
mail-admin-stat stat-msg errors access-violations bad-signatures
@end smallexample
+@kwindex admin-address
The recipient address for these notifications is set using
@code{admin-address} statement. Its argument is either a single
@acronym{RFC} 822 email address, or a comma-separated list of such
@@ -1192,8 +1192,8 @@ end
@subsection User Notification
@cindex mail notification, project admin
- Project administrators can be notified via email about any of the
-following events:
+ Project administrators (@dfn{owners}) and/or users may recieve email
+notifications about any of the following events:
@table @code
@kwindex success
@@ -1215,6 +1215,133 @@ uploader.
@end table
+@kwindex notify-event
+ These notifications are configured using the following statement:
+notify-event @var{event} @var{who} @var{msg-id}
+@end smallexample
+where @var{event} is one of the events described above, @var{msg-id}
+is the identifier of a previously defined message template
+(@pxref{templates}), and @var{who} determines who should receive the
+notification. The following values for @var{who} are allowed:
+@table @code
+@kwindex admin
+@item admin
+The system administrator.
+@kwindex owner
+@item owner
+Administrators of the project for which the files where uploaded.
+@kwindex user
+@item user
+A user who uploaded files.
+@end table
+ For example, the following two statements instruct @command{wydawca}
+to email notifications about @code{bad-directive-signature} event to
+project administrators and to the user who did the upload, using two
+different templates:
+notify-event bad-directive-signature user user-bad-directive-signature
+notify-event bad-directive-signature owner owner-bad-directive-signature
+@end smallexample
+ The following macro-variables may be used in templates for these
+@table @code
+@kwindex project
+@item project
+Project system name.
+@kwindex url
+@acronym{URL} of the distribution site.
+@kwindex dir
+Directory (relative to the project distribution root) to where the
+files where uploaded.
+@kwindex dest-dir
+Value of the @code{destination} keyword.
+@kwindex source-dir
+Value of the @code{source} keyword.
+@kwindex triplet:full
+@item triplet:full
+Full listing of the uploaded triplet. It is equivalent to:
+@end group
+@end smallexample
+For example:
+@kwindex triplet:upload
+@item triplet:upload
+Listing of the uploaded files.
+@kwindex triplet:dist
+@item triplet:dist
+Listing of the main distribution file.
+@kwindex triplet:sig
+@item triplet:sig
+Listing of the detached signature file.
+@kwindex triplet:dir
+@item triplet:dir
+Listing of the directive file.
+@kwindex user
+@kwindex user:name
+@item user
+@itemx user:name
+System name of the user who uploaded the triplet.
+@kwindex user:real-name
+@item user:real-name
+Real name of the user who uploaded the triplet.
+@kwindex user:email
+@item user:email
+Email of the user who uploaded the triplet.
+@end table
+ The following example shows how to configure success notification
+for the user:
+define-message user-success
+Subject: Upload of %@{project@} successful
+Upload of %@{project@} to %@{dir@} finished successfully.
+Files uploaded:
+The Project Submission Robot
+notify-event success user user-success
+@end smallexample
@node wydawca.rc, invocation, configuring, Top
@chapter @command{Wydawca} configuration file.
@cindex configuration statements, reference

Return to:

Send suggestions and report system problems to the System administrator.