Re: [alot] announcing v0.2 aka. "robot santa"

[Patrick Totzke <patricktotzke@googlemail.com>]

[-- Attachment #1: Type: text/plain, Size: 621 bytes --]

Quoting Jameson Graef Rollins (2011-12-12 00:12:04)
>It's mostly there, but we still need a couple of things (figure out all
>of the dependencies, make a man page...

Hi Jamie,
I took the time to write a first draft for a manpage (attached).
This file is content only, the formating for the man-system
is yet to be done.

Thanks to some very helpful feedback I have been able to spot and fix a few rather nasty
bugs. I am going to make a minor bugfix release in the next few days.

Note that I moved the bleeding-edge code to branch "testing" and
am trying to keep "master" as stable branch.

Best,
/p


[-- Attachment #2: manpage --]
[-- Type: application/octet-stream, Size: 2072 bytes --]

NAME
     alot - mail user agent for the notmuch mail system

SYNOPSIS
     alot [-h] [-c CONFIGFILE] [-n NOTMUCHCONFIGFILE] [-C {1,16,256}] [-r] [-p DB_PATH]
     [-d {debug,info,warning,error}] [-l LOGFILE] [-v] [command]

DESCRIPTION
      A terminal-based interface for the notmuch mail system.
      It features a modular and command prompt driven interface to provide a full mail
      user agent experience.

      In all views, arrows, page-up/down, `j`,`k` and `Space` can be used to move the
      focus.  `Escape` cancels prompts and `Enter` selects. Hit `:` at any time and type
      in commands to the prompt. Usage information on any command can be listed by typing
      `help YOURCOMMAND` to the prompt; The keybindings for the current mode are listet
      upon pressing `?`.

OPTIONS
     -h, --help
          show usage help message and exit

     -c CONFIGFILE
          Use given config file instead of ~/.config/alot/config

     -n NOTMUCHCONFIGFILE
          Use alternate config file for the notmuch system instead of the default
          ~/.notmuchrc

     -C {1,16,256}
          terminal colour mode

     -r
          open db in read only mode

     -p DB_PATH
          path to notmuch index. Overides the default read from NOTMUCHCONFIGFILE

     -d {debug,info,warning,error}
          debug level used in combination with -l

     -l LOGFILE
          logfile

     -v, --version
          show program's version number and exit


FILES
     ~/.config/alot/config
          configuration file for the alot interface

     ~/.notmuchrc
          configuration file for the notmuch mail system

     /etc/mailcap
          The system wide mailcap file. See mailcap(5) for further details.

     ~/.mailcap
          Per user malcap file. See mailcap(5) for further details.


BUGS
     Alot is a fairly new project, so expect misbehaviour. Bugs can be reported via the
     issue tracker on the projecs github page (https://github.com/pazz/alot).

AUTHOR
     Patrick Totzke <patricktotzke at googlemail dot com>

SEE ALSO
     notmuch(1)