-.TH twat 1
+.TH halcyon 1
.SH NAME
-twat \- Twat twats tweets so you don't have to Twitter.
+halcyon \- Halcyon monitors a list of Twitter accounts and displays or
+emails any new tweets.
.SH SYNOPSIS
-\fBtwat\fR [\fBOPTIONS\fR] [\fBUSERNAMES\fR]
+\fBhalcyon\fR [\fBOPTIONS\fR] [\fBUSERNAMES\fR]
.SH INPUT
.P
-Twat takes no input proper; instead, it takes a list of usernames from
-either the command-line or the ~/.twatrc file, and watches those
+Halcyon takes no input proper; instead, it takes a list of usernames from
+either the command-line or the ~/.halcyonrc file, and watches those
users' timelines.
.SH OUTPUT
.P
Any new tweets from watched users are written to stdout. If to/from
email addresses are provided (either on the command-line or in
-~/.twatrc), then sendmail will be used to email the new tweet to the
+~/.halcyonrc), then sendmail will be used to email the new tweet to the
specified \fIfrom\fR address.
.SH DESCRIPTION
.P
-Twat watches a list of Twitter timelines, and writes any new tweets to
+Halcyon watches a list of Twitter timelines, and writes any new tweets to
stdout. It can also optionally email the new tweets to a given email
address.
.P
New tweets are gathered at a fixed interval, specified in seconds by
the \fB\-\-heartbeat\fR (default: 600) option.
.P
-Twat uses the Twitter API, which now requires you to have a developer
+Halcyon uses the Twitter API, which now requires you to have a developer
account. You can sign up for free at https://dev.twitter.com/. Once
you have done this, you can authorize your own account to access
itself. You will then be given four tokens, which need to be fed to
-twat:
+halcyon:
.IP \[bu] 2
Consumer Key
.SH CONFIGURATION FILE
.P
-The file ~/.twatrc can contain any of the options (and usernames) that
-would otherwise be specified on the command-line.
+The file ~/.halcyonrc can contain any of the options (and usernames)
+that would otherwise be specified on the command-line.
.SH BUGS