Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP
Posting-Version: version B 2.10.2 9/18/84; site dataio.UUCP
Path: utzoo!watmath!clyde!burl!ulysses!mhuxj!mhuxn!houxm!vax135!cornell!uw-beaver!uw-june!entropy!dataio!bossert
From: boss...@dataio.UUCP (John Bossert)
Newsgroups: net.news.b,net.sources
Subject: New manual page for vnews
Message-ID: <242@dataio.UUCP>
Date: Thu, 6-Dec-84 16:41:21 EST
Article-I.D.: dataio.242
Posted: Thu Dec 6 16:41:21 1984
Date-Received: Fri, 7-Dec-84 06:06:07 EST
Distribution: net
Organization: Data I/O Corporation, Redmond WA
Lines: 375
Submitted for your approval...
Here is a new version of the manual page for vnews. I've fixed the
typo in the flags paragraph and reordered the discussion of the
flags to correspond to their order in the synopsis. Miscellaneous
typos have been fixed.
I wonder though, if vnews' option list should not exactly match the
option list given for readnews since both utilities use the same
code except for the visual portion of vnews. Comments anybody?
It would be a WONDERFUL idea if other individuals would continue this
effort for the other news utilities. Many have changed with the
2.10.2 release, and the manual pages need to be updated.
------------------------- cut here ---------------------------
.TH VNEWS 1 "1 October 1984"
.UC 4
.SH NAME
vnews \- read news articles
.SH SYNOPSIS
.BR vnews " [ " \-a
.IR date " ] [ "
.B \-n
.IR newsgroups " ] [ "
.B \-t
.IR titles " ] [ "
.BR \-rxu " ] "
.PP
.B "vnews \-s"
.SH DESCRIPTION
.I Vnews
is a program for reading USENET news. It is based
on readnews(1) but has a CRT oriented interface.
The list of available commands is quite
similar, although since vnews is a "visual"
interface, most vnews commands do not have to be terminated
by a newline.
.LP
Vnews uses the first 22 lines of the screen to display
the current article. Line 23 is the secondary prompt line,
and is used to input string arguments to commands. Line 24
contains several fields. The first field is the prompt
field. If vnews is at the end of an article, the prompt is
"next?"; otherwise the prompt is "more?". The second field
is the newsgroup field, which displays the current newsgroup,
the number of the current article, and the number of
the last article in the newsgroup. The third field contains
the current time, and the last field contains the word
"mail" if you have mail. When you receive new mail, the bell
on the terminal is rung and the word mail appears in capital
letters for 30 seconds.
.PP
.I Vnews
without any arguments prints unread articles.
.PP
The following flags determine the selection of articles.
.TP 10
.BI "\-a " "\fR[\fP date \fR]\fP"
Select articles posted after the given
.I date
(in
.IR getdate (3)
format).
.TP 10
.BI "\-n " newsgroups
Select articles belonging to
.I newsgroups.
.TP 10
.BI "\-t " titles
Select articles whose titles contain one of the strings specified by
.I titles.
.TP 10
.B \-r
Print the articles in reverse order.
.TP 10
.B \-x
Ignore
.I .newsrc
file. That is, select articles that have already been read as well as new ones.
.TP 10
.B \-u
Update the
.B .newsrc
file every 5 minutes, as in the case of an unreliable system.
(Note that if the .newsrc file is updated, the
.B x
command will not restore it to its original contents.)
.PP
.B vnews \-s
prints the newsgroup subscription list.
.PP
.I vnews
maintains a
.I .newsrc
file in the your home directory that specifies all news articles
already read. It is updated at the end of each reading session
unless the
.BR \-x "
option was specified.
If the environment variable NEWSRC is present, it should be the path
name of a file to be used in place of .newsrc.
.PP
If you wish, an options line may be placed in your
.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 and/or
the
.B \-r
or
.B \-t
flag.
Continuation lines begin with a space or tab character.
.SH ENVIRONMENT
Options can be specified in the
.B NEWSOPTS
environment parameter. Where conflicts exist, options on the command
line take precedence, followed by the
.I .newsrc
.B options
line, and lastly the
.B NEWSOPTS
parameter.
.PP
When the user uses the reply command,
the environment parameter
.B MAILER
will be used to determine which mailer to use. The default is usually /bin/mail.
.PP
If the user so desires, he may specify a specific paging program
for articles. The environment parameter
.B PAGER
should be set to the paging program. The name of the article is referenced with
a `%', as in the
.B \-c
option. If no `%' is present, the article will be piped to the program.
Paging may be disabled by setting
.B PAGER
to a null value.
.PP
If
.B EDITOR
is set, it will be used in place of the default editor on your system to
edit replies and follow-ups.
.PP
If
.B NAME
is set, it will be used as your full name when posting news or
submitting a follow-up. If it is not set, the name will be taken
from the file
.B .name
in your home directory. If this file is not present, the name will
be taken from /etc/passwd.
.PP
If
.B NEWSARCHIVE
is set, a copy of any articles you post or follow-up to, will be saved
in the specified file. If it is the null string, they will be
copied in
.I author_copy
in your home directory.
.PP
If
.B NEWSBOX
is set, the <filename> you specify when you save or write a file
will be prepended with NEWSBOX unless <filename> is an absolute pathname.
.PP
If
.B NEWSRC
is set, it will be used in place of the .newsrc file in your home directory.
.PP
If
.B ORGANIZATION
is set, it will be used as the name of your organization whenever you
post an article. The default is compiled in and is usually correct.
Typically, you would only use this if you were reading news at a
site other than normal. (Or if you are trying to be cute.)
.SH "COMMANDS"
.PP
Each vnews command may be preceded by a count. Some
commands use the count; others ignore it. If count is omitted,
it defaults to one. Some commands prompt for an argument
on the second line from the bottom of the screen. Standard UNIX erase
and kill processing is done on this argument. The argument is
terminated by a return. An interrupt
(delete or break) gets you out of any partially entered command.
.sp
In the following table, ^B is used as a shorthand for Control-B.
.sp
.ta 2.5i
Command Meaning
.IP CR
A carriage return prints more of the current article,
or goes on to the next article if you are at the end of
the current article. A SPACE is equivalent to CR.
.IP ^B
Go backwards count pages.
.IP ^F
Go forward count pages.
.IP ^D
Go forwards half a page.
.IP ^U
Go backwards half a page.
.IP ^Z
Go forwards count lines.
.IP ^E
Go backwards count lines.
.IP ^L
Redraw the screen. ^L may be typed at any time.
.IP b
Back up one article in the current group.
.IP c
Cancel the article. Only the author of the article or the super user
can do this.
.IP d
Read a digest. Breaks up a digest into separate articles
and permits you to read and reply to each piece.
.IP e
Erase. Forget that this article was read.
.IP f
Submit a follow-up article.
You will be placed in your EDITOR to compose the text of the follow-up.
.IP h
Go back to the top of the article and display only the
header.
.IP l
Redisplay the article after you have sent a follow-up or reply.
.IP n
No. Go on to the next article without printing current one.
``.'' is equivalent to ``n''. This is convenient if your terminal
has a keypad.
.IP p
Show the parent article (the article that the
current article is a follow-up to). This doesn't work
if the current article was posted by A-news or notesfiles. To
switch between the current and parent articles, use the -
command. Unfortunately, if you use several p commands
to trace the discussion back further, there is no command to return
to the original level.
.IP q
Quit. The .newsrc
file will be updated unless \-x was on the command line.
.IP r
Reply. Reply to article's author via mail.
You are placed in your EDITOR with a header specifying
To, Subject, and References lines taken from the message.
You may change or add headers, as appropriate.
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 "s [\fIfile\fP]"
Save. The article is appended to the named file.
The default is ``Articles''.
If the first character of the file name is `|',
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 `/', it is
taken as the full pathname of a file.
If $NEWSBOX (in the environment) is set to a full pathname,
and the file contains no `/', the file is saved in $NEWSBOX.
Otherwise, it is saved relative to $HOME.
.IP ug
Unsubscribe to the current group. This is a two character
command to ensure that it is not typed accidentally
and to leave room for other types of unsubscribes (e.
g. unsubscribe to discussion).
.IP v
Print the current version of the news software.
.IP w
Write. Like save
``s'', except that the headers are not written out.
.IP x
Exit. Like quit except that .newsrc is not updated.
.IP y
Yes. Print the current article and go to the next.
.IP [\fIn\fP]A
Go to article number \fIn\fP in the current newsgroup.
.IP D
Decrypts a joke. It only handles rot 13 jokes. The D
command is a toggle; typing another D re- encrypts the
joke.
.IP H
Print a very verbose header, containing all known information
about the article.
.IP K
Kill (mark as read) the rest of the articles in the current group.
This is useful if you can't keep up with the volume in the newsgroup,
but don't want to unsubscribe.
.IP "N [\fInewsgroup\fP]"
Go to the next newsgroup or named newsgroup.
.IP [\fIn\fP]+
Skip n articles.
The articles skipped are recorded as ``unread'' and will be
offered to you again the next time you read news.
.IP \-
Go back to last article.
This is a toggle, typing it twice returns you to the original article.
.IP <
Prompt for an article ID or the rest of a message ID.
It will display the article if it exists.
.IP #
Report the name and size of the newsgroup.
.IP ?
Print an short help message.
.IP !
Passes the rest of the command line to the shell. The
environment variable $A is set to the name of the file
containing the current article. If the last character
of the command is a "&", then the "&" is deleted and
the command is run in the background with stdin, stdout
and stderr redirected to /dev/null. If the command is
missing, the shell is invoked. Use the l command (or
essentially any other command) to turn on the display
after the program terminates.
.SH EXAMPLES
.TP 10
.B vnews
Read all unread articles using the
.IR visual
interface. The
.I .newsrc
file is updated at the end of the session.
.TP 10
.B vnews \-n all !fa.all \-r
Read all unread articles except articles whose newsgroups begin with
"fa." in reverse order. The
.I .newsrc
file is updated at the end of the session.
.TP 10
.B "vnews \-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 "vnews \-p > /dev/null &"
Discard all unread news.
This is useful after returning from a long trip.
.SH FILES
.PD 0
.TP 40
.RI /usr/spool/news/ newsgroup / number
News articles
.TP 40
/usr/lib/news/active
Active newsgroups
.TP 40
/usr/lib/news/vnews.help
Help file for
.IR visual
interface
.TP 40
~/.newsrc
Options and list of previously read articles
.PD
.SH SEE ALSO
checknews(1),
postnews(1),
readnews(1),
recnews(8),
news(5),
newsrc(5)
--
John Bossert
Data I/O Corporation
Redmond, WA
uw-beaver!teltone!dataio!{bossert,usenet}
Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP
Posting-Version: version B 2.10.2 9/18/84; site dataio.UUCP
Path: utzoo!watmath!clyde!burl!ulysses!mhuxr!mhuxn!mhuxj!houxm!vax135!cornell!uw-beaver!uw-june!entropy!dataio!bossert
From: boss...@dataio.UUCP (John Bossert)
Newsgroups: net.news.b,net.sources
Subject: Modification to man page for vnews.1
Message-ID: <247@dataio.UUCP>
Date: Mon, 17-Dec-84 13:45:32 EST
Article-I.D.: dataio.247
Posted: Mon Dec 17 13:45:32 1984
Date-Received: Tue, 18-Dec-84 03:05:29 EST
Distribution: net
Organization: Data I/O Corporation, Redmond WA
Lines: 122
This is a set of diffs for the vnews manual page. Included are
descriptions of the %s option for NEWSBOX and the features that
Bill Sebok fixed....
*** vnews.1.old Mon Dec 17 10:18:36 1984
--- vnews.1 Mon Dec 17 10:38:34 1984
***************
*** 21,27
interface, most vnews commands do not have to be terminated
by a newline.
.LP
! Vnews uses the first 22 lines of the screen to display
the current article. Line 23 is the secondary prompt line,
and is used to input string arguments to commands. Line 24
contains several fields. The first field is the prompt
--- 21,28 -----
interface, most vnews commands do not have to be terminated
by a newline.
.LP
! .I Vnews
! uses the first 22 lines of the screen to display
the current article. Line 23 is the secondary prompt line,
and is used to input string arguments to commands. Line 24
contains several fields. The first field is the prompt
***************
*** 71,78
.B x
command will not restore it to its original contents.)
.PP
! .B vnews \-s
! prints the newsgroup subscription list.
.PP
.I vnews
maintains a
--- 72,79 -----
.B x
command will not restore it to its original contents.)
.PP
! .I Vnews
! \-s prints the newsgroup subscription list.
.PP
.I Vnews
maintains a
***************
*** 74,80
.B vnews \-s
prints the newsgroup subscription list.
.PP
! .I vnews
maintains a
.I .newsrc
file in the your home directory that specifies all news articles
--- 75,81 -----
.I Vnews
\-s prints the newsgroup subscription list.
.PP
! .I Vnews
maintains a
.I .newsrc
file in the your home directory that specifies all news articles
***************
*** 152,159
.PP
If
.B NEWSBOX
! is set, the <filename> you specify when you save or write a file
! will be prepended with NEWSBOX unless <filename> is an absolute pathname.
.PP
If
.B NEWSRC
--- 153,168 -----
.PP
If
.B NEWSBOX
! is present and equal to "directory", a request to save an article as
! "filename" will cause the article to be saved as "directory/filename".
! If
! .B NEWSBOX
! is set to "directory/%s", a request to save an article in newsgroup
! "newsgroup" as "filename" will save it in the pathname
! "directory/newsgroup/filename".
! The portion of the pathname defined as $NEWSBOX must already exist.
! The subdirectories corresponding to news groups
! will be created as necessary.
.PP
If
.B NEWSRC
***************
*** 245,253
which is executed with the text of the article as standard input.
If the first character of the file name is `/', it is
taken as the full pathname of a file.
! If $NEWSBOX (in the environment) is set to a full pathname,
! and the file contains no `/', the file is saved in $NEWSBOX.
! Otherwise, it is saved relative to $HOME.
.IP ug
Unsubscribe to the current group. This is a two character
command to ensure that it is not typed accidentally
--- 254,263 -----
which is executed with the text of the article as standard input.
If the first character of the file name is `/', it is
taken as the full pathname of a file.
! If $NEWSBOX (in the environment) is set and the file name
! is not an absolute pathname,
! the file is saved relative to $NEWSBOX.
! If $NEWSBOX is not set, the file is saved relative to $HOME.
.IP ug
Unsubscribe to the current group. This is a two character
command to ensure that it is not typed accidentally
--
John Bossert
Data I/O Corporation
Redmond, WA
uw-beaver!teltone!dataio!{bossert,usenet}
|