H From:	CSBVAX::MRGATE!SCS7317%OCVAXB@VB.CC.CMU.EDU@SMTP 26-MAY-1988 19:30 To:	ARISIA::EVERHART6 Subj:	NEWS(DECNET/VMS)  USENET on VMS  manual for NEWS    O Received: from VB.CC.CMU.EDU by KL.SRI.COM with TCP; Tue 24 May 88 16:04:03-PDT  Date: Tue, 24 May 88 19:04 EDT7 From: Christopher Seline <SCS7317%OCVAXB@VB.CC.CMU.EDU> 9 Subject: NEWS(DECNET/VMS)  USENET on VMS  manual for NEWS  To: info-vax@KL.SRI.COM * X-VMS-To: CMCCVB::IN%"info-vax@kl.sri.com"   ..lm 3 ..rm 72  ..sp1  ..ap	 ..p 0,1,3  ..enable bar  ) ..c74;----------------------------------- ) ..c74;|              NEWS               | ) ..c74;|   USENET News reading utility   | ) ..c74;|          User's manual          | ) ..c74;-----------------------------------      ..c74;version 3.00! ..c74;(c) 1988 Christopher Seline    ..sk 4& ^&Conventions used in this document:\&   ..begin bar 8 Sections that describe advanced concepts are denoted by C vertical bars in the left margin.  This information is intended for C the more experienced user, and can be skipped at the first reading. 	 ..end bar    ..sk 4" ..c74;***   ^&Introduction\&   ***     ^&About USENET News\&   H "News" is a utility that enables users on a network site not directly on- USENET (e.g., bitnet users) to read the news  . that is circulated around the world on USENET,F commonly known as netnews.  Netnews is a huge bulletin board of sorts:7 a forum of open discussion and/or announcements on many  topics in which all of  6 the thousands of readers are welcome to participate.    ? Netnews is divided into well over 200 newsgroups, each of which & is devoted to a particular topic.  TheI subject names are split first into general areas, then into more specific & topics.  The root classifications are: ..lit * 		news -  about netnews   	sci  -  science# 		comp -  computers		soc  -  social + 		rec  -  recreation		misc -  miscellaneous  		talk -  discussions  ..el@ There are other initial names of groups that are specific to the5 network site.  For example, 'att' denotes newsgroups  1 specific to AT_&T, and can only be read by users   using an AT_&T node.  C Beyond these classifications, the newsgroup names get progressively  more specific.. Examples:  comp.sys.ibm.pc, rec.arts.startrek,* soc.college, and rec.auto.  Each newsgroup? name should be sufficiently descriptive of the topic discussed.   A When you read netnews for the first time, the first newsgroup you D go into will be "news.announce.newusers".  READ EVERY ARTICLE IN IT.F It contains information and guidelines about netnews that every reader is expected to know.     ^&Getting started with NEWS\&   ; Before running news, it is necessary to define the variable  'news__farsite', like so:  ..sk1 ( ..c74;define news__farsite [local-value]  @ This is a code that tells NEWS how to contact the nearest USENET@ site.  Since this will be a different value on each system, your= system manager will tell you what your local value is.  It is = easiest to put this definition in your login.com file, so you 6 don't have to remember it each time you read the news.  E News is a VAX TPU (Text Processing Utility) program.  This means that < to run the program, you invoke the TPU editor with a special, command file.  This file should be stored in3 a public directory.  Here is how the program is run  at Oberlin:  ..sk1 & ..c74;edit/tpu/sec=softlib:[share]news                   D Your system manager will be able to tell you where the program is onF your system.  Replace 'softlib:[share]news' above with the appropriate directory and file name.  B To make this procedure easier, you can define the above command as/ something else in your login.com file, like so:  ..sk1 3 ..c74;$define news edit/tpu/sec=softlib:[share]news   B Again, replace this filename with the one specific to your system.: After this is done, simply type 'news' to run the program.   ..sk3 - ..c74;***   ^&Your First NEWS Session\&   ***   $ ^&Establishing the link to netnews\&  9 When you run NEWS for the first time it takes a minute to A create a necessary information file in your directory.  NEWS will 8 tell you that it is creating a new subscription for you.  I Every time you invoke NEWS it will take several moments to access netnews F at your USENET site.  It should blink 'Loading active' near the bottom; right corner of the screen until it establishes the link.      If there& is an outright error in accessing the & USENET node, you will know right away,; and will be prompted to hit 'q' to quit.  If this happens,  * either the link is temporarily down or youE are trying to access the USENET node incorrectly (due to an incorrect ! news__farsite value).  If you are G sure you have the correct news__farsite value defined, try again later.   B If it blinks 'Loading active' for more than a few minutes, either 3 the network load is too high or the USENET node is  - having problems of its own.  Try again later.    ^&Screen layout\&   D The screen is split into two sections, separated by a bar of inverseE text.  The top (largest) part of the screen is the main display area; F this is where the news articles are displayed.  The area below the bar@ is where NEWS program messages and error messages are displayed.  & The inverse-video bar acts as a statusH line, and also reminds you of two important commands:  <CTRL>-Z to exit,D and '?' for help.  The status information includes the newsgroup youD are currently reading, the current article number, and the number of% remaining articles in that newsgroup.   C The article number is probably already quite high.  This is because F the numbers have not been reset since the newsgroup began.  You cannotD read the articles before the one that NEWS starts you at;  they have been discarded due to old age.   ^&On-line help\&  B On-line command information is displayed with '?' or 'h'.  Hit '1': to return to reading the news.  On VT-100 type terminals,  keypad information is also@ available with the PF2 key.  '1' exits this help screen as well.   ^&Newsgroup subscriptions\&   H When you run NEWS for the first time, you are automatically 'subscribed'H to all the newsgroups, meaning you have the opportunity to read articles= in every group.  Since you will probably not be interested in = all the topics, you will want to un-subscribe to most groups. B After you un-subscribe to a newsgroup, you will not see any of its2 articles again unless you re-subscribe to it.  SeeD the section titled 'Selecting newsgroups' for a discussion of how to choose your subscriptions.  E Remember to read everything in 'news.announce.newusers' before moving  on to the rest of netnews.   ..page& ..c74;***   ^&Reading Articles\&   ***  + The up and down arrows scroll the screen in @ both directions.  However, there are easier ways to page through
 the articles.   E The space bar scrolls down to next screen.  If you are at the end of  @ an article, this will also move to the next article.  If you areB at the end of the last article in a newsgroup, it will move to theA next available newsgroup and wait for further instructions before  reading any articles.   ? Note that when you advance to the next article there is a delay B as the program blinks 'Retrieving' in the message window.  This is> because it takes time to grab the file from the USENET node.     Other commands:  ..lm 9
 ..p -6,1,3  - >#####Go to the end of the current article.     + <#####Go to the top of the current article.   D n#####Advances to next article, even if you have not seen all of the current article.  E _######Go to a particular article number, which NEWS prompts you for. F If you skip forward, NEWS will count the skipped articles as read whenI you exit.  This means that when you re-enter NEWS, your current position   in that newsgroup will be  beyond those missed articles.   F s#####Save the current article to a file.  NEWS will prompt you for a 5 filename and inform you when the process is complete.   D c#####Catch up in the newsgroup.  This marks all the active articlesD as read, so you can start fresh with all future articles.  This is aG good way to rationalize not sifting through all the remaining articles.	  C C#####Un-catch up.  This returns your current article number to the	3 first active (and unread) article in the newsgroup.M ..sk1a  C The following commands utilize the keypad on VT-100 type terminals:e ..lm 9
 ..p -6,1,3  E <0>###Page down.  This differs from the space bar in that it will notCC advance any further when it reaches the end of the current article.l  ; <_.>###Page up.  As with '0', this will not move beyond theo current article. ..lm 14  ..p -11,1,3p  F <ENTER>###Advance to the next message.  Identical to the 'n' command.    ..page* ..c74;***   ^&Selecting Newsgroups\&   *** ..lm 3	 ..p 0,1,3    ^&Moving between newsgroups\&   B The following commands allow you to choose your current newsgroup: ..lm 9
 ..p -6,1,3  , N#####Go to the next subscribed newsgroup.  ( Note the difference between 'N' and 'n'.  F g#####Go to the next non-specific newsgroup.  NEWS will prompt you forF a newsgroup name, and will advance to the next newsgroup that containsG the requested string.  For example, enter 'ibm' and it will move to the C next newsgroup that has 'ibm' in its name.  If it does not find the K specified keyword in any newsgroups, it will remain in the current group.  t  F G#####Go to the next specific newsgroup.  This time, when NEWS promptsH you for a newsgroup name, you must enter the full name of the newsgroup,H such as 'comp.sys.ibm.pc'.  If it does not find the specified newsgroup,$ it will remain in the current group.   Also, on the VT-100 keypad:a  I <,>###Go to the next subscribed newsgroup.  Identical to the 'N' command.u  K PF1###Go to the next non-specific newsgroup.  Identical to the 'g' command.p   ..lm 3	 ..p 0,1,3l4 With all commands that change the current newsgroup,@ NEWS will wait for you to decide if you want to read articles inD that newsgroup.  Hit the space bar or 'n' to read the first article. ..sk1c  & ^&Subscribing to specific newsgroups\&  C The following commands allow you to choose which newsgroups to readr2 and which ones to skip next time you read netnews. ..lm 9
 ..p -6,1,3  K u#####Unsubscribe to the current newsgroup.  If you are reading an article,oL NEWS will advance to the next available newsgroup and wait for instructions.  K U#####Un-unsubscribe to the current newsgroup.  Returns the current articles# number to the first unread article.t  F 2#####(on the regular keyboard)  Display the list of newsgroups.  ThisI will replace the article area on the screen with a list of all newsgroupsIF available, as well as your current article number in that newsgroup.  : You can scroll around with the same commands as you use toJ read messages - the arrow keys, the space bar, '<', '>', and the keypad.  ' '1' returns you to the current article.e ..lm 3	 ..p 0,1,3[  E The 'u' and 'U' commands are made considerably easier through the '2' G command.  With the newsgroup list on the screen, 'u' and 'U' affect the C newsgroup marked by the cursor at the top of the screen.  Note thatsF when you unsubscribe to an article, the current article number changesK to 99999, and un-unsubscribing changes it back to the first unread article.g   ..begin baraJ What the '2' command is actually doing is making the newsgroup list bufferG the active buffer in TPU.  The '3' command will name the newsgroup file & as the active buffer.  The '1' commandI returns the article buffer to be the active buffer (note that this is why 1 '1' exits help screens and returns to netnews).  t  2 The newsgroup file contains the list of newsgroupsH in your home directory.  One can edit this file outside of NEWS, puttingE the important newsgroups at the top of the list.  Deleting newsgroupseB from this list, even if you think you will never ever want to read$ them, is not recommended.  The extra/ information the file contains is the number of o  the latest posted article in the9 newsgroup, and the subscription status of that newsgroup. 	 ..end bart   ..sk3s, ..c74;***   ^&Miscellaneous commands\&   ***  A To exit news, type Control-Z.  This causes NEWS to remember which E articles you read, so that the next time you read news you are at thelA same point in all your subscribed newsgroups.  'q' also exits they7 program, but does not remember which messages you read.n  3 To refresh the screen, type Control-W or Control-R.t   ..begin baro> The 'P' command pauses NEWS, returning to the operating system: temporarily.  This allows you to read mail, etc. and still= remain in the NEWS program.  On VT-100 terminals, the PF3 key  also executes this command.,  E To use this feature, NEWS must be invoked with SPAWN#NEWS in DCL.  ToU; re-enter NEWS, use the ATTACH#[process-name] command, wherea@ [process-name] was the name given by SPAWN to your command level process when you invoked NEWS.  B '5' assigns the message buffer (normally seen at the bottom of the= screen) to be the current buffer.  See 'Selecting Newsgroups:m@ Subscribing to specific newsgroups' for a discussion of swapping buffers.	 ..end bars   ..page% ..c74;***   ^&Command Summary\&   ***e ..lita     	    ?,h		help- 	<space bar>	page down, even through articles  	     n		next articlei 	     N		next newsgroupt 	     #		go to article numbere# 	     c		catch-up to latest articlee4 	     C		un-catch-up (return to last unread article)% 	     g		go to non-specific newsgroupm! 	     G		go to specific newsgroupo 	     s		save article to file ) 	     u		unsubscribe to current newsgroupe$ 	     U		un-unsubscribe to newsgroup 	     <		top of article  	     >		bottom of article' 	     ^Z		exit (remember read articles)y, 	     q		quit (don't remember read articles) 	   ^R,^W	redraw screenh  	     1		make text buffer active% 	     2		make newsgroup buffer activeS- |	     3		make complete newsgroup file activet$ |	     5		make message buffer active |	     p		pausem   ..el ..c74;VT-100 Keypad commands:t ..lito   	    PF2		keypad helpw 	     0		page down 	     . 		page upi 	  <enter>	next articlea 	     ,		next newsgroup'& 	    PF1		go to non-specific newsgroup |	    PF3		pause ..el   ..page" ..c74;***   Program Messages   ***  4 "Can't find the group you referred to: [group-name]"  B You asked to go to a newsgroup (with either g or G) and NEWS couldA not find a group by that name.  You are returned to the newsgroupl& and article you are currently reading.  D "Nothing left to read in group [group-name] -- Moving to next Group"  D This is what happens when you finish the last article in a newsgroup and hit the space bar or 'n'.  n. Note that although it moves to the next group,F it does not start reading the articles; hit 'n' or the space bar again to continue.  " "Null News Body -- Hope that's OK"  C NEWS tried to read an article that turned out to be empty.  This ish> most likely due to a numbering error in netnews, so you're not missing anything. 