-.TH ABOOK 1 "June 6, 2003"
+.TH ABOOK 1 2006-09-06
.nh
.SH NAME
-abook \- text-based address book program
+abook \- text\-based address book program
.SH SYNOPSIS
.B abook
[ \fIOPTION\fR ]
\fB\-\-datafile\fP \fI<filename>\fR
Use an alternative addressbook file (default is \fI$HOME/.abook/addressbook\fR).
.TP
-\fB\-\-mutt\-query\fP \fI<string>\fR
+\fB\-\-mutt\-query\fP \fI<string>\fR [ \fB\-\-outformat\fP \fI<outputformat>\fR ]
Make a query for mutt (search the addressbook for \fI<string>\fR).
.br
The \fB\-\-datafile\fP option, as documented above, may be used
.BI BEFORE
this option to search a different addressbook file.
+.br
+Only a subset of the below \fI<outputformat>\fR are allowed: \fBmutt\fP (default), \fBvcard\fP and \fBcustom\fP
.TP
\fB\-\-convert\fP [ \fB\-\-informat\fP \fI<inputformat>\fR ] [ \fB\-\-infile\fP \fI<inputfile>\fR ] [ \fB\-\-outformat\fP \fI<outputformat>\fR ] [ \fB\-\-outfile\fP \fI<outputfile>\fR ]
Converts \fI<inputfile>\fR in \fI<inputformat>\fR to \fI<outputfile>\fR in \fI<outputformat>\fR
.br
The following \fIinputformats\fR are supported:
.br
-- \fBabook\fP abook native format
+\- \fBabook\fP abook native format
+.br
+\- \fBldif\fP ldif / Netscape addressbook
+.br
+\- \fBmutt\fP mutt alias
.br
-- \fBldif\fP ldif / Netscape addressbook
+\- \fBpine\fP pine addressbook
.br
-- \fBmutt\fP mutt alias
+\- \fBcsv\fP comma separated values
.br
-- \fBpine\fP pine addressbook
+\- \fBpalmcsv\fP Palm comma separated values
.br
-- \fBcsv\fP comma separated values
+\- \fBvcard\fP VCard addressbook
.br
The following \fIoutputformats\fR are supported:
.br
-- \fBabook\fP abook native format
+\- \fBabook\fP abook native format
+.br
+\- \fBldif\fP ldif / Netscape addressbook (.4ld)
+.br
+\- \fBmutt\fP mutt alias
.br
-- \fBldif\fP ldif / Netscape addressbook (.4ld)
+\- \fBhtml\fP html document
.br
-- \fBmutt\fP mutt alias
+\- \fBpine\fP pine addressbook
.br
-- \fBhtml\fP html document
+\- \fBvcard\fP VCard addressbook
.br
-- \fBpine\fP pine addressbook
+\- \fBcsv\fP comma separated values
.br
-- \fBgcrd\fP GnomeCard (VCard) addressbook
+\- \fBpalmcsv\fP Palm comma separated values
.br
-- \fBcsv\fP comma separated values
+\- \fBelm\fP elm alias
.br
-- \fBpalmcsv\fP Palm comma separated values
+\- \fBtext\fP plain text
+.br
+\- \fBspruce\fP Spruce address book
+.br
+\- \fBwl\fP Wanderlust address book
+.br
+\- \fBbsdcal\fP BSD calendar
+.br
+\- \fBcustom\fP Custom output format, see below
+.TP
+\fB\-\-outformatstr\fP \fI<string>\fR
+Only used if \fB\-\-mutt\-query\fP \fIor\fR \fB\-\-convert\fP is specified \fIand\fR \fB\-\-outformat\fP=\fIcustom\fR. \fI<string>\fR is a format string allowing placeholders.
.br
-- \fBelm\fP elm alias
+A placeholder can be any of the standard fields names (see \fBabookrc\fP(5)) and must be encapsulated by curly brackets.
.br
-- \fBtext\fP plain text
+The default value is "{nick} ({name}): {mobile}"
.br
-- \fBspruce\fP Spruce address book
+If \fI<string>\fR starts with \fI!\fR only entries whose all fields from \fI<string>\fR are non\-NULL are included.
.TP
-\fB\-\-add-email\fP
-Read an e-mail message from stdin and add the sender to the addressbook.
+\fB\-\-add\-email\fP
+Read an e\-mail message from stdin and add the sender to the addressbook.
.TP
-\fB\-\-add-email-quiet\fP
-Same as --add-email but doesn't confirm adding.
+\fB\-\-add\-email\-quiet\fP
+Same as \-\-add\-email but doesn't confirm adding.
.TP
\fB\-\-formats\fP
List available formats.