Bug#395063: cyrus-imapd-2.2: squatter documentation incomplete

[Ross Boylan]

Package: cyrus-imapd-2.2
Version: 2.2.13-8
Severity: minor

Also affects cyrus-doc-2.2 (squatter.8.html).
An upstream issue.

1. command line arguments
The man page for squatter say
SYNOPSIS
       squatter [ -C config-file ] [ -r ] [ -s ] [ -a ] [ -v ] mailbox...

The mailbox argument is never explained.  Is it the path on disk, an
IMAP like designation (with what path separator), or something else?

Also, I infer from the the default cyrus.conf EVENTS that the mailbox
argument can be omitted.  I'm guessing this implies recursive (-r) and
starts at the top of the tree.

2. Apparently you need to be the cyrus user.  It would be good to say so.

3. I get the following error
$ nice squatter -v
nice: squatter: No such file or directory

This is weird, since the only 2 files mentioned in FILES are present.

As a non-documentation issue, I'm trying to got squatter back in order
after the events described in bug 393596.  That involved a purge of
2.1 inadvertently removing stuff that 2.2 was using; something
connected with squat apparently was hit.  I have rebooted since then.


-- System Information:
Debian Release: testing/unstable
  APT prefers testing
  APT policy: (500, 'testing'), (500, 'stable'), (50, 'unstable'), (40, 'experimental')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.16-2-k7-smp
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)

Versions of packages cyrus-imapd-2.2 depends on:
ii  cyrus-common-2.2        2.2.13-8         Cyrus mail system (common files)
ii  libc6                   2.3.6.ds1-4      GNU C Library: Shared libraries
ii  libdb4.2                4.2.52+dfsg-1    Berkeley v4.2 Database Libraries [
ii  libsasl2                2.1.19.dfsg1-0.5 Authentication abstraction library
ii  libssl0.9.8             0.9.8c-3         SSL shared libraries
ii  libwrap0                7.6.dbs-11       Wietse Venema's TCP wrappers libra

cyrus-imapd-2.2 recommends no packages.

-- no debconf information