--- shiela.pod 2002/12/21 11:00:17 1.8
+++ shiela.pod 2002/12/22 11:06:50 1.9
@@ -91,6 +91,7 @@
[Program sendmail <path>;]
[Program cvs <path>;]
[Program diff <path>;]
+ [Program xdelta <path>;]
[Program uuencode <path>;]
};
@@ -102,29 +103,47 @@
This overrides the path to the F<sendmail> executable. Per default
B<OSSP shiela> determines this automatically through the inherited C<$PATH>
-variable. Use this either if you have Sendmail not in C<$PATH> or if you
-have multiple Sendmail instances installed.
+variable. Use this either if you have B<Sendmail> not in C<$PATH> or if you
+have multiple B<Sendmail> instances installed. The F<sendmail> executable
+is mandatory for the operation of B<OSSP shiela>.
=item B<Program cvs E<lt>pathE<gt>;>
This overrides the path to the F<cvs> executable. Per default B<OSSP shiela>
determines this automatically through the inherited C<$PATH> variable.
-Use this either if you have CVS not in C<$PATH> or if you have multiple
-CVS instances installed.
+Use this either if you have B<CVS> not in C<$PATH> or if you have multiple
+B<CVS> instances installed. The F<cvs> executable is mandatory for the
+operation of B<OSSP shiela>.
=item B<Program diff E<lt>pathE<gt>;>
This overrides the path to the F<diff> executable. Per default B<OSSP
shiela> determines this automatically through the inherited C<$PATH>
-variable. Use this either if you have GNU Diffutils not in C<$PATH> or
-if you have multiple GNU Diffutils instances installed.
+variable. Use this either if you have B<GNU Diffutils> not in C<$PATH>
+or if you have multiple B<GNU Diffutils> instances installed. The
+F<diff> executable is required for the operation of B<OSSP shiela>
+if change summary information on text files is used in reports (see
+C<details> in C<Content>).
+
+=item B<Program xdelta E<lt>pathE<gt>;>
+
+This overrides the path to the F<xdelta> executable. Per default B<OSSP
+shiela> determines this automatically through the inherited C<$PATH>
+variable. Use this either if you have B<XDelta> not in C<$PATH> or if
+you have multiple B<XDelta> instances installed. The F<xdelta>
+executable is required for the operation of B<OSSP shiela> if change
+summary information on binary files is used in reports (see C<summary>
+in C<Content>).
=item B<Program uuencode E<lt>pathE<gt>;>
This overrides the path to the F<uuencode> executable. Per default
B<OSSP shiela> determines this automatically through the inherited
-C<$PATH> variable. Use this either if you have GNU Sharutils not in
-C<$PATH> or if you have multiple GNU Sharutils instances installed.
+C<$PATH> variable. Use this either if you have B<GNU Sharutils> not in
+C<$PATH> or if you have multiple B<GNU Sharutils> instances installed.
+The F<uuencode> executable is required for the operation of B<OSSP
+shiela> if change summary information on binary files is used in reports
+(see C<summary> in C<Content>).
=back
@@ -361,11 +380,11 @@
=item B<Details E<lt>typeE<gt>:E<lt>argE<gt>;>
This configures how the details (see B<Content> directive) actually look. The
-following type/argument combinations are currently supported: "C<diff:plain>"
+following type/argument combinations are currently supported: "C<patch:plain>"
(the default) which produces a long details text consisting of concatenated
-"C<cvs diff>" outputs; "C<diff:mime>" which produces the same contents as
-"C<diff:plain>", but instead of just concatenating the individual difference
-texts, it encapsulates them into MIME attachments (which is useful when the
+patching shell commands for reproducing the change; "C<patch:mime>" which produces the same contents as
+"C<patch:plain>", but instead of just concatenating the individual scripts,
+it encapsulates them into MIME attachments (which is useful when the
E<lt>targetE<gt> of a B<Log> directive is an Email address only); and
"C<url:>I<url>" which produces just an URL per modified file by expanding
"C<%s>" (the file path relative to C<$CVSROOT>), "C<%V>" (the old revision)
@@ -392,6 +411,7 @@
Program sendmail /e/foo/sw/bin/sendmail;
Program cvs /e/foo/sw/bin/cvs;
Program diff /e/foo/sw/bin/diff;
+ Program xdelta /e/foo/sw/bin/xdelta;
Program uuencode /e/foo/sw/bin/uuencode;
};
@@ -427,12 +447,12 @@
Acl modules *:core *:devel;
Acl * *:core;
Log passwd none;
- Log modules mail.diff:foo-cvs@foo.dom file:CVSROOT/commit.log;
- Log * mail.diff:foo-core@foo.dom;
+ Log modules mail.patch:foo-cvs@foo.dom file:CVSROOT/commit.log;
+ Log * mail.patch:foo-core@foo.dom;
};
Module foo-adm "FOO Administration" {
Acl * *:core;
- Log * mail.diff:foo-core@foo.dom file:CVSROOT/commit.log;
+ Log * mail.patch:foo-core@foo.dom file:CVSROOT/commit.log;
};
Module foo-src "FOO Source" {
Acl *:VENDOR foo;
@@ -447,10 +467,10 @@
# define the logging details
Logging {
Reports {
- Report mail.diff {
+ Report mail.patch {
Prefix " ";
Content title rule header files log summary rule details;
- Details diff:mime;
+ Details patch:mime;
};
Report mail.url {
Prefix " ";
|
