Git: Nail

Nail @ 26170ca8394267eafab091e6d42f1b00c00a200f

.TH NAIL 1
.SH NAME
Nail \- view mail in acme

.SH SYNOPSIS

Nail
[
.B -Ts
]
[
.B -m
.I maildir
]
[
.B -f
.I format
]

.SH DESCRIPTION
.PP
.B Nail
edits a mailbox in an
.IR acme (1)
environment.
The default mailbox is /mail/fs/mbox.
Nail shows 3 views:
The list view, the message view, and the composition view.

.PP
At startup,
.B Nail
takes the following options:
.PD 0
.TP
.B -T
Disable threading
.PD 0
.TP
.BI -m " maildir
Open the maildir
.I maildir
instead of the default
.PD 0
.TP
.BI -s
Accept sendmail plumb messages. By default, only
the Nail instance viewing /mail/fs/mbox will
accept plumb messages.
.PD 0
.TP
.BI -f " format
Define the format of individual messages in the list view
(see "Format strings" below).

.PP
Nail presents a typical acme interface. When started,
text commands are inserted into the tag bar. In the message
view, the commands typically apply to the selected messages.
In the message and composition views, they typically apply
to the current message.

.PP
The following text commands are recognized by the message
list:

.TP
.B Put
Flush pending changes back to
.IR upasfs (4).
.PD 0
.TP
.B Delmesg, Undelmesg
Flags a message for deletion on the next
.I Put
invocation.
.PD 0
.TP
.B Next
Select the next unread message in the mailbox.
.PD 0
.TP
.B Mark [┬▒flags]
Add or remove message flags. The flags recognized
are listed in
.IR upasfs (4)
.PD 0
.TP
.B Redraw
Redraws the contents of the mailbox.

.PP
The following text commands are recognized by the message
view:

.TP
.B [Q] Reply [all]
Replies to a message. If 'Q' is specified, quote the open message.
If all is specified, reply to all addresses on the message.
.PD 0
.TP
.B Delmesg, Undelmesg
As with the message view, but applied to the open message.
.PD 0
.TP
.B Mark
As with the message view, but applied to the open message.

.PP
The following text commands are recognized by the composition
window:

.TP
.B Post
Sends the message currently being composed.

.SS Format strings
The formatting of messages in the list view is controlled by the
format string defined through the
.I -f
flag.
The format string is composed of multiple directives: plain 
characters, which are displayed unchanged; indentation directives,
which allows spacing based on thread depth; and messages directives, 
which display message fields.
.PP
Directives have the following format:
.IP
.B "% [flags] [width] verb
.PP
.IR width
limits the number of characters displayed.
If width is negative, text is aligned right instead of left.
.PP
The supported flags are:
.PD 0
.TP
.B >
Insert indentation into the start of the field. This
does not increase the width of the field.

.PP
Messages directives are:
.PD 0
.TP
.B s
Subject
.PD 0
.TP
.B f
From field
.PD 0
.TP
.B F
From field including sender's name
.PD 0
.TP
.B t
To field
.PD 0
.TP
.B c
Cc field
.PD 0
.TP
.B r
Reply-to field

.PP
Indentation directives are:
.PD 0
.TP
.B i
Adds spacing depending on message depth in thread but limited to a single level.
If
.IR width
is not specified, adds a tabulation otherwise
.IR width
specifies the number of spaces to display.
.PD 0
.TP
.B I
Similar to
.IR i
but not limited to a single level.

.PP
Two special directives are also available:
.PD 0
.TP
.B "[...]
Text within the brackets is displayed if the message is not the toplevel message of a thread.
.PD 0
.TP
.B "{...}
Text within the braces is used as the format string for tmfmt(2).

.PP
The default format string is "%>48s\\t<%f>"

.SH FILES

.SH "SEE ALSO"
.IR mail (1),
.IR aliasmail (8),
.IR filter (1),
.IR marshal (1),
.IR mlmgr (1),
.IR nedmail (1),
.IR upasfs (4),
.IR smtp (8),
.IR faces (1),
.IR rewrite (6)

.SH BUGS
Probably.