plan9fox/sys/man/1/newt

.TH NEWT 1
.SH NAME
newt \- network news transport protocol (NNTP) client
.SH SYNOPSIS
.B newt
[
.B -f
.I newsgroup
] [
.B -m
.I mountpoint
] [
.B -p
.I maxposts
]
.SH DESCRIPTION
.I Newt
provides an interactive, text-based interface to NNTP
articles served by
.IR nntpfs (4) .
.PP
There are a number of options:
.TP
.B  -f
Load the specified newsgroup. Default is
.B alt.test.
.TP
.B  -m
Directory where
.I nntpfs
is mounted. Default is
.B /mnt/news.
.TP
.B -p
Number of posts to display, up to and including the most recent post.
Default is 30.
.PP
.I Newt
starts by reading the list of messages in the
.I newsgroup,
printing out the number of messages, and then prompting for commands.
The prompt itself represents the name of the group followed by the
message number in the form of a file system path, relative to the
.I mountpoint.
.PP
Commands, as in
.IR ed (1),
are of the form
.RI `[ range ]
.I command
.RI [ arguments ]'.
The command is applied to each message in the (optional) range.
.PD
.PP
The address range can be:
.TP 1.4i
.I address
to indicate a single message header.
.PD
.TP
.IB address , address
to indicate a range of contiguous message headers.
.PD
.PP
The addresses can be:
.TP 1.4i
.I number
to indicate a particular message.
.PD
.PP
The commands are:
.PP
.TP
.I number
Print message
.I number.
.TP
.B b
Print the headers for the next ten messages.
.TP
.B e
Enter a new message, honoring the environment variable
.I editor.
Default is
.IR hold (1) .
.TP
.BI g " newsgroup
Change to the specified
.I newsgroup.
The name of a group may be provided in dotted
(\fIalt.test\fR) or path (\fIalt/test\fR) format.
.TP
.B h
Print the disposition, date, sender and subject line
of the message. These lines are suitable for selecting
and sending to the prompt, in order to print messages
either singly or in aggregate.
.TP
.B help
Print a summary of the available commands.
.TP
.BI k " [newsgroup]
Without an argument,
.I k
walks the directories under the current group
and prints commands suitable for changing to each
available sub-group. When provided with an argument,
it instead walks the directories under the group specified
by the argument.
.TP
.BI kf " regexp
Greps
.B $home/lib/newsgroups
for
.I regexp
and prints commands suitable for changing to each match.
.TP
.B p
Print the current message with minimal headers.
.TP
.B P
Print the raw message with full headers.
.TP
.B q
Quit.
.TP
.B r
Reply to the current message.
.TP
.B y
Synchronize message list with the server.
.TP
.BI | command
Run the
.I command
with the message body as standard input.
.TP
.BI || command
Run the
.I command
with the whole message as standard input.
.TP
.BI ! command
Escape to the shell to do command.
.TP
\fB"\fP
Print the current message in quoted form, suitable for reply.
.PP
The environment variables
.B $editor
and
.B $pager
are honored.
.SH FILES
.B $home/lib/newsgroups
list of newsgroups, one per line
.SH SOURCE
.B /rc/bin/newt
.SH "SEE ALSO"
.IR nntpfs (4)
.SH BUGS
The list of available newsgroups offered by a given server
may be quite large. This complicates walking the list over 
a slow Internet connection, and renders searching in real-time
all but infeasible. Grepping a pre-generated
.B newsgroups
file is a compromise.
.SH HISTORY
.I Newt
first appeared in 9front (April, 2014).