170 lines
3.2 KiB
Text
170 lines
3.2 KiB
Text
.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).
|