.if n .ds La '
.if n .ds Ra '
.if t .ds La `
.if t .ds Ra '
.if n .ds Lq "
.if n .ds Rq "
.if t .ds Lq ``
.if t .ds Rq ''
.de Ch
\\$3\\*(Lq\\$1\\*(Rq\\$2
..
.TH READNEWS 1 "January 17, 1986"
.ds ]W  Version B 2.10.3
.SH NAME
readnews \- read news articles
.SH SYNOPSIS
.BR readnews " ["
.BI \-a " date"
] [
.BI \-n " newsgroups"
] [
.BI \-t " titles"
] [
.BR \-leprxhfuM " ] ["
.BR \-c " ["
.IR mailer " ] ]"
.PP
.B "readnews \-s"
.SH DESCRIPTION
.I Readnews
without argument prints unread articles.
There are several interfaces available other than the default:
.TP 10
Flag
Interface
.TP 10
.B \-M
An interface to
.IR mailx (1).
.TP 10
.B \-c
A
.IR binmail (1)\-like
interface.
.TP 10
.BI "\-c " ``mailer''
All selected articles written to a temporary file.  Then the mailer is
invoked.  The name of the temporary file is referenced with a
.Ch % .
Thus, ``mail \-f %'' will invoke mail on a temporary file consisting of all
selected messages.
.TP 10
.B \-p
All selected articles are sent to the standard output.  No questions asked.
.TP 10
.B \-l
Only the titles output.  The
.I .newsrc
file will not be updated.
.TP 10
.B \-e
Like
.B \-l
but also updates the
.I .newsrc
file.
.LP
The
.B \-r
flag causes the articles to be printed in reverse order.  The
.B \-f
flag prevents any followup articles from being printed.  The
.B \-h
flag causes articles to be printed in a less verbose format,
and is intended for terminals running at 300 baud.
The
.B \-u
flag causes the
.I .newsrc
file to be updated every 5 minutes,
in case of an unreliable system.
(Note that if the
.I .newsrc
file is updated,
the
.B x
command will not restore it to its original contents.)
.PP
The following flags determine the selection of articles.
.TP 10
.BI "\-n " newsgroups
Select all articles that belong to
.I newsgroups.
.TP 10
.BI "\-t " titles
Select all articles whose titles contain one of the strings specified by
.IR titles \&.
.TP 10
.BI "\-a " "\fR[\fP date \fR]\fP"
Select all articles that were posted past the given
.I date
(in
.IR getdate (3)
format).
.TP 10
.B \-x
Ignore
.I .newsrc
file.  That is, select articles that have already been read as well as new ones.
.PP
.I Readnews
maintains a
.I .newsrc
file in the user's home directory that specifies all news articles
already read.  It is updated at the end of each reading session in
which the
.BR \-x " or " \-l
options weren't specified.
If the environment variable
.B NEWSRC
is present, it should be the path
name of a file to be used in place of
.IR .newsrc \&.
.PP
If the user wishes, an options line may be placed in the
.I .newsrc
file.
This line starts with the word
.B options
(left justified) followed by the list of standard options just as
they would be typed on the command line.  Such a list may include:
the
.B \-n
flag along with a newsgroup list; a favorite interface; and/or
the
.B \-r
or
.B \-t
flag.  Continuation lines are specified by following lines
beginning with a space or tab character.
Similarly, options can be specified in the
.B NEWSOPTS
environment parameter.  Where conflicts exist, option on the command
line take precedence, followed by the
.I .newsrc
.B options
line, and lastly the
.B NEWSOPTS
parameter.
.PP
You can use the
.B \-s
flag to print the newsgroup subscription list.
.PP
When the user uses the reply command of the default or
.IR binmail (1)
interfaces, the environment parameter
.B MAILER
will be used to determine
which mailer to use.  The default is
.IR mail (1).
.PP
If the user so desires, he may specify a specific paging progam
for articles.  The environment parameter
.B PAGER
should be set to
the paging program.  The name of the article is referenced with
a
.Ch % ,
as in the
.B \-c
option.  If no
.Ch %
is present, the article will be piped to the program.
Paging may be disabled by setting
.B PAGER
to a null value.  By default, the pager is
.IR cat (1).
.SH "COMMANDS"
.PP
This section lists the commands you can type to the default and
.I binmail
interface prompts.
The default interface will suggest some common commands in brackets.
Just hitting return is the same as typing the first command.
For example, \*(Lq[ynq]\*(Rq means that the commands
.Ch y
(yes),
.Ch n
(no),
and
.Ch q
(quit) are common responses, and that
.Ch y
is the default.
.sp
.ta 2.5i
Command		Meaning
.IP \fB\-\fP
Go back to last article.
This is a toggle, typing it twice returns you to the original article.
.IP \fB#\fP
Report the name and size of the newsgroup.
.IP \fB!\fP
Shell escape.
.IP "\fB<\fP\fImessage ID\fP\fB>\fP"
Look for a particular article.
(See
.I
Standard for Interchange of Usenet Messages
for a description of message ID's).
.IP \fBb\fP
Back.  Back up one article.
.IP \fBc\fP
Cancel the article.  Only the author or the super user can do this.
.IP \fBd\fP
Read a digest.  Breaks up a digest into separate articles
and permits you to read and reply to each piece.
.IP \fBD\fP [\fInumber\fP]
Decrypt.  Invokes a Caesar decoding program on the body of the message.
This is used to decrypt rotated jokes posted to
.BR net.jokes .
Such jokes are usually obscene or otherwise offensive to some
groups of people, and so are rotated to avoid accidental
decryption by people who would be offended.
The title of the joke should indicate the nature of the problem,
enabling people to decide whether to decrypt it or not.
.IP
An explicit
.I number
rotation (usually 13) may be given to force a particular shift.
.IP \fBe\fP
Erase.  Forget that this article was read.
.IP "\fBf\fP [\fItitle\fP]"
Submit a follow up article.
Normally you should leave off the title, since the system will generate
one for you.
You will be placed in your
.B EDITOR
to compose the text of the followup.
.IP "\fBfd\fP"
Followup directly, without edited headers.  This is like
.BR f ,
but the headers of the article are not included in the editor buffer.
.IP \fBh\fP
Header.  Print a more verbose header.
.IP \fBH\fP
Print a very verbose header, containing all known information
about the article.
.IP \fBK\fP
Kill.  Mark all remaining articles in this newsgroup as read
and skip to the next newsgroup.
.IP \fBn\fP
No.  Goes on to next article without printing current one.
In the
.I binmail
interface, this means \*(Lqgo on to the next article\*(Rq,
which will have the same effect as
.B y
or just hitting return.
.IP "\fBN\fP [\fInewsgroup\fP]"
Next Newsgroup.
Go to the next newsgroup or named newsgroup.
.IP \fBp\fP
Print.  Reprint previous article.
.IP \fBP\fP
Previous Newsgroup.  Go back to previous newsgroup.
.IP \fBq\fP
Quit.  The
.I .newsrc
file will be updated if
.B \-l
or
.B \-x
were not on the command line.
.IP r
Reply.  Reply to article's author via
.IR mail \&.
You are placed in your
.B EDITOR
(by default
.IR vi (1))
with a header specifying
\&\*(LqTo\*(Rq, \*(LqSubject\*(Rq, and \*(LqReferences\*(Rq
lines taken from the message.
You may change or add headers, as appropriate.
You add the text of the reply after the blank line, and then exit
the editor.  The resulting message is mailed to the author of the article.
.IP \fBrd\fP
Reply directly.
You are placed in 
.B MAILER
.RI ( mail
by default) in reply to the author.
Type the text of the reply and then control-D.
.IP "\fBs\fP [\fIfile\fP]"
Save.  The article is appended to the named file.
The default is
.IR Articles \&.
If the first character of the file name is
.Ch | ,
the rest of the file name is taken as the name of a program,
which is executed with the text of the article as standard input.
If the first character of the file name is
.Ch / ,
it is
taken as a full path name of a file.
If
.B NEWSBOX
(in the environment) is set to a full path name,
and the file contains no
.Ch / ,
the file is saved in
.BR NEWSBOX .
Otherwise, it is saved relative to
.BR HOME .
.IP \fBU\fP
Unsubscribe from this newsgroup. Also goes on to the next newsgroup.
.IP \fBv\fP
Print the current version of the news software.
.IP \fBw\fP
Same as
.BR s .
.IP \fBx\fP
Exit.  Like quit except that
.I .newsrc
is not updated.
.IP "\fBX\fP \fIsystem\fP"
Transmit article to the named system.
.IP \fBy\fP
Yes.  Prints current article and goes on to next.
.IP \fInumber\fP
Go to \fInumber\fP.
.IP \fB+\fP[\fIn\fP]
Skip
.I n
articles.
The articles skipped are recorded as ``unread'' and will be
offered to you again the next time you read news.
.PP
The commands
.BR c ,
.BR f ,
.BR fd ,
.BR r ,
.BR rd ,
.BR e ,
.BR h ,
.BR H ,
and
.B s
can be followed by
.BR \- 's
to refer to the previous article.
Thus, when replying to an article using the default interface,
you should normally type
.B r\-
(or
.BR re- )
since by the time you enter
a command, you are being offered the next article.
.SH EXAMPLES
.TP 10
.B readnews
Read all unread articles using the default interface.  The
.I .newsrc
file is updated at the end of the session.
.TP 10
.B readnews \-c ``ed %'' \-l
Invoke the
.IR ed (1)
text editor on a file containing the titles of all unread articles.  The
.I .newsrc
file is
.B not
updated at the end of the session.
.TP 10
.B readnews \-n all !fa.all \-M \-r
Read all unread articles except articles whose newsgroups begin with
.B fa.
via
.I mailx
in reverse order.  The
.I .newsrc
file is updated at the end of the session.
.TP 10
.B "readnews \-p \-n all \-a last thursday"
Print every unread article since last Thursday.  The
.I .newsrc
file is
updated at the end of the session.
.TP 10
.B "readnews \-p > /dev/null &"
Discard all unread news.
This is useful after returning from a long trip.
.SH "ENVIRONMENT VARIABLES"
.IP \fBEDITOR\fP
Editor invoked by
.B f
command.  (Default is
.IR /usr/ucb/vi .)
.IP \fBMAILER\fP
Mailing program invoked by the
.B r
command.  (Default is
.IR /bin/mail .)
.IP \fBNAME\fP
Your full name used in header of articles posted by you.  (Default is
the comments field of your id in
.IR /etc/passwd .)
.IP \fBNEWSBOX\fP
File or directory where articles saved with the
.B s
command are stored.
(Default is same as
.BR HOME .)
.IP \fBNEWSOPTS\fP
Options for \fIreadnews\fR.
.IP \fBORGANIZATION\fP
Full name of this site used header of articles posted by you.
.IP \fBPAGER\fP
Paging program invoked by articles with more than 16 lines.  (Default
is
.IR /usr/ucb/more .)
.IP \fBSHELL\fP
The shell invoked by the
.B !
command.  (Default is
.IR /bin/sh .)
.SH FILES
.PD 0
.TP 25
.RI /usr/spool/news/ newsgroup / number
News articles
.TP 25
/usr/lib/news/active
Active newsgroups and numbers of articles
.TP 25
/usr/lib/news/help
Help file for default interface
.TP 25
~/.newsrc
Options and list of previously read articles
.PD
.SH SEE ALSO
binmail(1),
checknews(1),
inews(1),
mail(1),
mailx(1),
news(5),
newsrc(5)
postnews(1),
vnews(1),
getdate(3),
news(5),
newsrc(5),
expire(8),
recnews(8),
sendnews(8),
uurec(8)
.br
.I
How to Read the Network News
by Mark Horton.
.br
.I
Standard for Interchange of Usenet Messages
by Mark Horton.
.SH AUTHORS
Matt Glickman
.br
Mark Horton
.br
Stephen Daniel
.br
Tom R. Truscott