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 .PP
  37 .I Newt
  38 starts by reading the list of messages in the
  39 .I newsgroup,
  40 printing out the number of messages, and then prompting for commands
  41 from standard input. The prompt itself presents the name of the group
  42 and the message number in the form of a file system path relative to the
  43 .I mountpoint.
  44 .PP
  45 The commands are:
  46 .PP
  47 .TP
  48 .I number
  49 Print message
  50 .I number.
  51 .TP
  52 .B b
  53 Print the previous message.
  54 .TP
  55 .B e
  56 Enter a new message, honoring the environment variable
  57 .I editor.
  58 Default is
  59 .IR hold (1) .
  60 .TP
  61 .B f
  62 Jump to the first message in the group.
  63 .TP
  64 .BI g " newsgroup
  65 Change to the specified
  66 .I newsgroup.
  67 The name of a group may be provided in dotted
  68 (\fIalt.test\fR) or path (\fIalt/test\fR) format.
  69 .TP
  70 .B h
  71 Print the disposition, date, sender and subject line
  72 of all messages in the group. These lines are suitable
  73 for selecting and sending to the prompt, in order to
  74 print messages either singly or in aggregate.
  75 .TP
  76 .B help
  77 Print a summary of the available commands.
  78 .TP
  79 .BI k " [newsgroup]
  80 Without an argument,
  81 .I k
  82 walks the directories under the current group
  83 and prints commands suitable for changing to each
  84 available sub-group. When provided with an argument,
  85 it instead walks the directories under the group specified
  86 by the argument.
  87 .TP
  88 .BI kf " regexp
  89 Greps
  90 .B $home/lib/newsgroups
  91 for
  92 .I regexp
  93 and prints commands suitable for changing to each match.
  94 .TP
  95 .B l
  96 Jump to the last message in the group.
  97 .TP
  98 .B n, or enter key
  99 Print the next message.
 100 .TP
 101 .B p
 102 Print the current message with minimal headers.
 103 .TP
 104 .B P
 105 Print the raw message with full headers.
 106 .TP
 107 .B q
 108 Quit.
 109 .TP
 110 .B r
 111 Reply to the current message.
 112 .TP
 113 .B y
 114 Synchronize message list with the server.
 115 .TP
 116 .BI | command
 117 Run the
 118 .I command
 119 with the message body as standard input.
 120 .TP
 121 .BI || command
 122 Run the
 123 .I command
 124 with the whole message as standard input.
 125 .TP
 126 \fB"\fP
 127 Print the current message in quoted form, suitable for reply.
 128 .SH FILES
 129 .B $home/lib/newsgroups
 130 list of newsgroups, one per line
 131 .SH SOURCE
 132 .B /rc/bin/newt
 133 .SH "SEE ALSO"
 134 .IR nntpfs (4)
 135 .SH BUGS
 136 The list of available newsgroups offered by a given server
 137 may be quite large. This complicates walking the list over
 138 a slow Internet connection, and renders searching in real-time
 139 all but infeasible. Grepping a pre-generated
 140 .B newsgroups
 141 file is a compromise.
 142 .SH HISTORY
 143 .I Newt
 144 first appeared in 9front (April, 2014).