ref: 2ca54f6a26ceda9cfe5012c641154e203ff9a83b
dir: /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).