Repository List / allegro / allegrowww / docs / sf_cron_author_statistics_update.txt @ HEAD

===================================================
SourceForge cron script author_statistics_update.sh
===================================================

This is a small document for SourceForge administrators reviewing
the crontab entry used to update the Allegro web page.


Contents:
  1. `Purpose of the script`_
  2. `Contact`_
  3. `Current user running this script`_


Purpose of the script
=====================

The script ``author_statistics_update.sh`` is stored in
the ``allegrowww`` module just like the rest of the web page
source. The purpose of the script is to review CVS history looking
for contributions from translation webmasters and noting down their
last commits.  Then, these commits are stored in a temporary file
which is mailed to alleg-www-commits@lists.sourceforge.net.

The script only needs to be run once a month, and it is not CPU
intensive, it takes about 30 seconds (usually less) to run in an
interactive shell session on the SF servers. Most of the script
itself is devoted to protect multiple instances of it through a
.lock file.

If the script is unable to check out the CVS history for some reason,
like a temporary CVS failure, the script will sleep 1 hour before
running again. To verify this, search for the string ``Be kind to
SF``. This shouldn't be much of a problem, given that the script
is scheduled to run once a month.


Contact
=======

Should problems arise, and the author of the cron
entry not answer emails, you can send an email to
alleg-developers@lists.sourceforge.net, where other administrators
of the Allegro project are available.


Current user running this script
================================

Right now the user ``gradha`` is running this script from his crontab.