This repository contains various small things for the ALICE Experiment at CERN.

Please consult the guide.

Python script for steering the automatic documentation generation with Doxygen.

This script has two main usage modes.

autodoc.py \
  --branch=<GitBranch> \
  --build-path=<LocalDocCache> \
  --git-clone=<PathToLocalGitClone> \
  --output-path=<PrefixForDocGeneration>

The Git branch will be updated from the configured remote, and documentation will be stored under:

<PrefixForDocGeneration>/<GitBranch>

Returns 0 on success, nonzero on failure.

autodoc.py \
  --new-tags \
  --git-clone=<PathToLocalGitClone> \
  --output-path=<PrefixForDocGeneration>

All new tags since the last update will have their documentation generated. No cache directory is used, but temporary directories are created per tag, and they are removed once the generation is done.

Output path:

<PrefixForDocGeneration>/<Tagname>

Returns 0 on success, nonzero on failure.

By default the command outputs a restricted number of messages on both stderr and syslog.

Temporary build directory is deleted on success, and retained by default on error.

• --debug: enables debug messages, and enables output from the external commands
• --syslog-only: only log on syslog, be completely quiet on stderr (useful for cron jobs)
• --always-purge: delete temporary directory also in case of error (this never applies to --build-path which is always retained)
• --smtp-server: if provided, sends notifications using the specified SMTP server, in the form server[:port]
• --mail-to: if provided, sends notifications via the specified SMTP server to the comma-separated list of recipients