sys/man/1/newt

   1 .TH NEWT 1
   2 .SH NAME
   3 newt \- network news transport protocol (NNTP) client
   4 .SH SYNOPSIS
   5 .B newt
   6 [
   7 .B -f
   8 .I newsgroup
   9 ] [
  10 .B -m
  11 .I mountpoint
  12 ] [
  13 .B -p
  14 .I maxposts
  15 ]
  16 .SH DESCRIPTION
  17 .I Newt
  18 provides an interactive, text-based interface to NNTP
  19 articles served by
  20 .IR nntpfs (4) .
  21 .PP
  22 There are a number of options:
  23 .TP
  24 .B  -f
  25 Load the specified newsgroup. Default is
  26 .B alt.test.
  27 .TP
  28 .B  -m
  29 Directory where
  30 .I nntpfs
  31 is mounted. Default is
  32 .B /mnt/news.
  33 .TP
  34 .B -p
  35 Number of posts to display, up to and including the most recent post.
  36 Default is 30.
  37 .PP
  38 .I Newt
  39 starts by reading the list of messages in the
  40 .I newsgroup,
  41 printing out the number of messages, and then prompting for commands.
  42 The prompt itself represents the name of the group followed by the
  43 message number in the form of a file system path, relative to the
  44 .I mountpoint.
  45 .PP
  46 Commands, as in
  47 .IR ed (1),
  48 are of the form
  49 .RI `[ range ]
  50 .I command
  51 .RI [ arguments ]'.
  52 The command is applied to each message in the (optional) range.
  53 .PD
  54 .PP
  55 The address range can be:
  56 .TP 1.4i
  57 .I address
  58 to indicate a single message header.
  59 .PD
  60 .TP
  61 .IB address , address
  62 to indicate a range of contiguous message headers.
  63 .PD
  64 .PP
  65 The addresses can be:
  66 .TP 1.4i
  67 .I number
  68 to indicate a particular message.
  69 .PD
  70 .PP
  71 The commands are:
  72 .PP
  73 .TP
  74 .I number
  75 Print message
  76 .I number.
  77 .TP
  78 .B b
  79 Print the headers for the next ten messages.
  80 .TP
  81 .B e
  82 Enter a new message, honoring the environment variable
  83 .I editor.
  84 Default is
  85 .IR hold (1) .
  86 .TP
  87 .BI g " newsgroup
  88 Change to the specified
  89 .I newsgroup.
  90 The name of a group may be provided in dotted
  91 (\fIalt.test\fR) or path (\fIalt/test\fR) format.
  92 .TP
  93 .B h
  94 Print the disposition, date, sender and subject line
  95 of the message. These lines are suitable for selecting
  96 and sending to the prompt, in order to print messages
  97 either singly or in aggregate.
  98 .TP
  99 .B help
 100 Print a summary of the available commands.
 101 .TP
 102 .BI k " [newsgroup]
 103 Without an argument,
 104 .I k
 105 walks the directories under the current group
 106 and prints commands suitable for changing to each
 107 available sub-group. When provided with an argument,
 108 it instead walks the directories under the group specified
 109 by the argument.
 110 .TP
 111 .BI kf " regexp
 112 Greps
 113 .B $home/lib/newsgroups
 114 for
 115 .I regexp
 116 and prints commands suitable for changing to each match.
 117 .TP
 118 .B p
 119 Print the current message with minimal headers.
 120 .TP
 121 .B P
 122 Print the raw message with full headers.
 123 .TP
 124 .B q
 125 Quit.
 126 .TP
 127 .B r
 128 Reply to the current message.
 129 .TP
 130 .B y
 131 Synchronize message list with the server.
 132 .TP
 133 .BI | command
 134 Run the
 135 .I command
 136 with the message body as standard input.
 137 .TP
 138 .BI || command
 139 Run the
 140 .I command
 141 with the whole message as standard input.
 142 .TP
 143 .BI ! command
 144 Escape to the shell to do command.
 145 .TP
 146 \fB"\fP
 147 Print the current message in quoted form, suitable for reply.
 148 .PP
 149 The environment variables
 150 .B $editor
 151 and
 152 .B $pager
 153 are honored.
 154 .SH FILES
 155 .B $home/lib/newsgroups
 156 list of newsgroups, one per line
 157 .SH SOURCE
 158 .B /rc/bin/newt
 159 .SH "SEE ALSO"
 160 .IR nntpfs (4)
 161 .SH BUGS
 162 The list of available newsgroups offered by a given server
 163 may be quite large. This complicates walking the list over
 164 a slow Internet connection, and renders searching in real-time
 165 all but infeasible. Grepping a pre-generated
 166 .B newsgroups
 167 file is a compromise.
 168 .SH HISTORY
 169 .I Newt
 170 first appeared in 9front (April, 2014).