.\" Process this file with
.\" groff -man -Tascii rolo.1
.\"
.\" $Id: rolo.1,v 1.5 2003/04/26 05:07:48 ahsu Rel $
.Dd April 26, 2003
.Os
.Dt ROLO 1
.Sh NAME
.Nm rolo
.Nd text-based contact management software
.Sh SYNOPSIS
.Nm rolo
.Op Fl r
.Op Fl f Ar datafile
.Nm rolo
.Op Fl v
.Nm rolo
.Op Fl V
.Sh DESCRIPTION
Rolo keeps track of your contacts and display them to you with a
text-based menu. Rolo strives to be a well-constructed tool for
complimenting text-based email programs-such as mutt. It utilizes
the vCard version 3.0 format for storing its contacts and it
interfaces with the end-user through a NCurses front-end.
.Pp
The options are as follows:
.Bl -tag -offset indent -width "-V"
.It -r
Open the data file in read-only mode. This essentially disables
adding, editing, and deleting contacts.
.It -f
Use the specified file as the data file.
.It -v
Display the version.
.It -V
Display the copyright and license.
.El
.Sh ENVIRONMENT
.Bl -tag -width "ROLO_EDITOR"
.It ROLO_EDITOR
If ROLO_EDITOR is set, its value is used as the name of the program
to invoke when displaying contact entries in advanced edit. If
ROLO_EDITOR is not set, then EDITOR is used. If EDITOR is also not
set, the default value of /usr/bin/editor is used.
.El
.Sh FILES
.Bl -tag -width "~/.rolo/contacts.vcf" -compact
.It Pa ~/.rolo/contacts.vcf
Default data file that rolo reads upon startup.
.El
.Sh SEE ALSO
.Xr vi 1
.Sh AUTHORS
.An "Andrew Hsu" Aq ahsu@users.sf.net
.Sh BUGS
The read-only option does not work. The configuration file is not used.