charisma(1)
NAME
charisma - Utility to generate an index of package's maintainers
SYNOPSIS
charisma [ options ] extra file...
DESCRIPTION
charisma is a utility to generate an index of package's maintainers.
The output format is:
package~version maintainer
The input format of extra files can either be in this form or in the
old style which is similar, but lacking the version number, i.e.:
package maintainer
Charisma will auto-detect the type of layout of the extra file. If the
extra file is in the old style format the records in it are assumed to
supersed any that were seen earlier (i.e. either from earlier extra
files or generated from the SQL).
Charisma determines the maintainer of a package by comparing suite priority (see 'Configuration') and then version number.
OPTIONS
- -h/--help
- Show help and then exit.
CONFIGURATION
charisma uses katie's configuration file. It follows the typical ISC
configuration format as seen in ISC tools like bind 8 and dhcpd. Apart
from being able to alter the defaults for command line options, the
following configuration items are used:
- Suite::<SUITE>::Priority
- Suite priority overrides the version checks charisma does. A package in higher priority suite overrides versions in lower priority suites even if the version number in the higher priority suite is older.
NEW VERSUS OLD OUTPUT FORMAT
Converting the new output format to the old output format is easy with
some simple sed + awk, e.g.
sed -e "s/~[^ ]*\([ ]\)/\1/" | awk '{printf "%-20s ", $1; for (i=2; i<=NF; i++) printf "%s ", $i; printf "\n";}'
DIAGNOSTICS
charisma returns zero on normal operation, non-zero on error.
AUTHOR
- katie was written by James Troup <james@nocrew.org>.