summaryrefslogtreecommitdiffstats
path: root/docs/xml/installation.xml
diff options
context:
space:
mode:
authormozilla%colinogilvie.co.uk <>2005-07-02 07:41:31 +0200
committermozilla%colinogilvie.co.uk <>2005-07-02 07:41:31 +0200
commit8f788c282f54e2f92dcae8d83c2397e4c3848ace (patch)
tree6c4e9c071ef01e03b8469c25f91b4ea82b44571e /docs/xml/installation.xml
parented2904119ddf423b160bc1541b5d5ac324621886 (diff)
downloadbugzilla-8f788c282f54e2f92dcae8d83c2397e4c3848ace.tar.gz
bugzilla-8f788c282f54e2f92dcae8d83c2397e4c3848ace.tar.xz
Bug 274404 - Document the new whining functionality that will be available in 2.20. Patch by A. Karl Kornel <karl@kornel.name> r=colin (carrying forward joel's content r)
Diffstat (limited to 'docs/xml/installation.xml')
-rw-r--r--docs/xml/installation.xml43
1 files changed, 41 insertions, 2 deletions
diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml
index cccac847c..346e86f13 100644
--- a/docs/xml/installation.xml
+++ b/docs/xml/installation.xml
@@ -1,5 +1,5 @@
<!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: installation.xml,v 1.97 2005/07/01 16:21:42 mozilla%colinogilvie.co.uk Exp $ -->
+<!-- $Id: installation.xml,v 1.98 2005/07/01 22:41:31 mozilla%colinogilvie.co.uk Exp $ -->
<chapter id="installing-bugzilla">
<title>Installing Bugzilla</title>
@@ -1176,7 +1176,7 @@ c:\perl\bin\perl.exe -xc:\bugzilla -wT "%s" %s
</para>
</section>
- <section>
+ <section id="installation-whining-cron">
<title>The Whining Cron</title>
<para>What good are
@@ -1202,6 +1202,45 @@ c:\perl\bin\perl.exe -xc:\bugzilla -wT "%s" %s
</note>
</section>
+ <section id="installation-whining">
+ <title>Whining</title>
+
+ <para>
+ As of Bugzilla 2.20, users can configure Bugzilla to regularly annoy
+ them at regular intervals, by having Bugzilla execute saved searches
+ at certain times and emailing the results to the user. This is known
+ as "Whining". The process of configuring Whining is described
+ in <xref linkend="whining"/>, but for it to work a Perl script must be
+ executed at regular intervals.
+ </para>
+
+ <para>
+ This can be done by adding the following command as a daily
+ crontab entry, in the same manner as explained above for bug
+ graphs. This example runs it every 15 minutes.
+ </para>
+
+ <programlisting>*/15 * * * * cd &lt;your-bugzilla-directory&gt; ; ./whine.pl</programlisting>
+
+ <note>
+ <para>
+ Whines can be executed as often as every 15 minutes, so if you specify
+ longer intervals between executions of whine.pl, some users may not
+ be whined at as often as they would expect. Depending on the person,
+ this can either be a very Good Thing or a very Bad Thing.
+ </para>
+ </note>
+
+ <note>
+ <para>
+ Windows does not have 'cron', but it does have the Task
+ Scheduler, which performs the same duties. There are also
+ third-party tools that can be used to implement cron, such as
+ <ulink url="http://www.nncron.ru/">nncron</ulink>.
+ </para>
+ </note>
+ </section>
+
<section id="patch-viewer">
<title>Patch Viewer</title>