home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / usenet / software / nn / getting-started
Encoding:
Internet Message Format  |  2004-04-20  |  97.0 KB

  1. Path: senator-bedfellow.mit.edu!dreaderd!not-for-mail
  2. Message-ID: <usenet/software/nn/getting-started_1082376800@rtfm.mit.edu>
  3. Supersedes: <usenet/software/nn/getting-started_1079688903@rtfm.mit.edu>
  4. Expires: 3 Jun 2004 12:13:20 GMT
  5. X-Last-Updated: 1995/05/05
  6. From: FAQ Editor <faq-editor@ii.com>
  7. Reply-To: FAQ Editor <faq-editor@ii.com>
  8. Organization: Infinite Ink, Seattle, Washington, USA
  9. Approved: news-answers-request@mit.edu
  10. Newsgroups: news.newusers.questions,news.software.nn,news.software.readers,news.answers
  11. Followup-To: news.software.nn
  12. Subject: Getting Started with News and the NN News Reader
  13. Keywords: FAQ, periodic posting, news, newsreader, nn, trn, tin, pine, post, mail, folder, Internet, Net, netiquette, editor, newsgroup, search, flag, header, body, thread, macro, digest, newsrc, Usenet
  14. Originator: faqserv@penguin-lust.MIT.EDU
  15. Date: 19 Apr 2004 12:14:22 GMT
  16. Lines: 2709
  17. NNTP-Posting-Host: penguin-lust.mit.edu
  18. X-Trace: 1082376862 senator-bedfellow.mit.edu 567 18.181.0.29
  19. Xref: senator-bedfellow.mit.edu news.newusers.questions:725978 news.software.nn:12433 news.software.readers:172791 news.answers:270261
  20.  
  21. Archive-name: usenet/software/nn/getting-started
  22. Posting-frequency: approximately monthly
  23. Last-modified: 5 May 1995
  24.  
  25. Current Hypertext Version:
  26.  http://www.cis.ohio-state.edu/hypertext/faq/usenet/usenet/software/nn/getting-started/faq.html
  27.  
  28.  
  29.  
  30.             ____________________________________________________
  31.     _______|                                                    |_______
  32.     \      |  GETTING STARTED WITH NEWS AND THE NN NEWS READER  |      /
  33.      \     |                                                    |     /
  34.      /     |         Copyright (c) 1995 Nancy McGough           |     \
  35.     /      |____________________________________________________|      \
  36.    /___________)                                            (___________\
  37.  
  38.  
  39.   TABLE OF CONTENTS
  40.  
  41.   0.0 Preliminaries
  42.       0.1 Getting the Latest Version of this FAQ
  43.           0.1.1 Hypertext
  44.           0.1.2 Plain Text
  45.       0.2 Notation
  46.   1.0 Introduction to nn
  47.       1.1 Why Use nn? A Comparison of Unix News Readers
  48.       1.2 Essential nn Commands
  49.       1.3 Getting nn Help
  50.   2.0 Your First Time
  51.       2.1 Starting nn
  52.       2.2 Going to a Newsgroup and Subscribing
  53.       2.3 Menu Mode: Selecting Articles to Read
  54.       2.4 Show Mode: Reading Selected Articles
  55.       2.5 Leaving a Newsgroup
  56.       2.6 Quitting
  57.   3.0 Your Second Time
  58.   4.0 Customizing nn
  59.       4.1 Strategy: Plug and Play
  60.       4.2 Setting Your Editor
  61.           4.2.1 C-Compatible Shells
  62.           4.2.2 Bourne-Compatible Shells
  63.       4.3 Your Subscription List
  64.           4.3.1 Your seq File
  65.           4.3.2 Your .newsrc File
  66.                 4.3.2.1 Strategy: Subscribe to All Newsgroups
  67.           4.3.3 Finding Newsgroups You're Interested In
  68.       4.4 Your init File
  69.           4.4.1 Variable Settings
  70.           4.4.2 Key Mappings
  71.           4.4.3 Host-Specific Settings
  72.   5.0 Efficiently Reading Lots of News
  73.       5.1 Killing and Auto-Selecting Subjects and Authors
  74.       5.2 Quick Selecting Subjects
  75.       5.3 Select, Read, Flag, Kill, Next Newsgroup
  76.       5.4 Moving Between Newsgroups
  77.           5.4.1 Going to a Newsgroup *Temporarily*
  78.           5.4.2 Jumping to a Newsgroup
  79.                 5.4.2.1 Jump Macro
  80.       5.5 Reading an Article That's in Digest Format
  81.   6.0 Virtual Newsgroups: Creating a Custom Menu of Articles
  82.       6.1 Presenting All Articles in a Newsgroup
  83.       6.2 Searching For Subjects or Authors
  84.           6.2.1 Within a Newsgroup
  85.                 6.2.1.1 Macro to Show All Articles with Current Subject
  86.           6.2.2 Across Newsgroups
  87.       6.3 Full Text Searching
  88.           6.3.1 Across Articles in a Newsgroup
  89.           6.3.2 Within One Article
  90.   7.0 Saving Articles
  91.       7.1 Strategy: Mail & News Folders Are Essentially the Same
  92.       7.2 Saving an Individual Article
  93.           7.2.1 Saving an Article That's in Digest Format
  94.       7.3 Saving a Group of Articles
  95.       7.4 Folder Management
  96.           7.4.1 Reading a Folder
  97.           7.4.2 Moving and Deleting Messages in a Folder
  98.           7.4.3 Linking Your Mail and News Directories
  99.   8.0 Posting
  100.       8.1 Netiquette
  101.           8.1.1 First Read the FAQs
  102.           8.1.2 Some DOs and DON'Ts
  103.       8.2 Your First Posts Should Be Test Posts
  104.           8.2.1 Newsgroups for Testing
  105.           8.2.2 Test 1: Following Up to an Article
  106.           8.2.3 Test 2: Starting a Thread
  107.           8.2.4 Test 3: Replying to an Article in Mail
  108.           8.2.5 Test 4: Canceling an Article
  109.       8.3 Responding to a Message
  110.           8.3.1 Strategy: Flag it, Continue Reading, Then Respond
  111.           8.3.2 To Mail or Post Your Response?
  112.           8.3.3 Included Text
  113.           8.3.4 Headers
  114.                 8.3.4.1 Newsgroups and Followup-To Headers
  115.                 8.3.4.2 Subject and References Headers
  116.       8.4 Starting a Thread
  117.       8.5 Your Signature
  118.       8.6 Canceling an Article You Posted
  119.   9.0 Glossary
  120.  10.0 Contributors
  121.       10.1 Acknowledgements
  122.       10.2 If You'd Like to Contribute
  123.  11.0 Copyright Notice
  124.  
  125. ----------------------------------------------------------------------
  126.  
  127. Date: 05 May 1995 00:00:00 GMT
  128. Subject: 0.0 Preliminaries
  129.  
  130. This article is a fairly comprehensive introduction to news and the
  131. nn newsreader.  There are a lot of general news concepts and
  132. strategies in the article that you may find useful, even if you have
  133. no plans to use nn (or Unix).  For example, section 8.1.1 "First Read
  134. the FAQs" discusses a number of strategies for finding the FAQ(s) of
  135. a newsgroup.
  136.  
  137. ------------------------------
  138.  
  139. Date: 05 May 1995 00:10:00 GMT
  140. Subject: ... 0.1 Getting the Latest Version of this FAQ
  141.  
  142. If this FAQ is over a couple months old, there may be an updated
  143. version.  Please get the latest hypertext or plain text version from
  144. one of the places listed below.
  145.  
  146. ------------------------------
  147.  
  148. Date: 05 May 1995 00:11:00 GMT
  149. Subject: ... ... 0.1.1 Hypertext
  150.  
  151. The best way to read this FAQ (and most other FAQs) is to view the
  152. hypertext version using a Web browser such as Lynx, Mosaic, or
  153. Netscape.  This will allow you to easily jump:
  154.    * between subjects in the FAQ
  155.    * to any Uniform Resource Locator (URL) in the FAQ
  156.    * to an Internet Request For Comments document (RFC)
  157.    * to some manual pages
  158.  
  159. This, and all FAQs that are crossposted to news.answers, are available at:
  160.  http://www.cis.ohio-state.edu/hypertext/faq/usenet/top.html
  161.  
  162. This particular FAQ is at:
  163.  http://www.cis.ohio-state.edu/hypertext/faq/usenet/usenet/software/nn/getting-s
  164. tarted/faq.html
  165.  
  166. If you don't want to type that long URL, you can go to Infinite Ink's
  167. Sample Writings Page and jump to it from there:
  168.  
  169.   http://www.jazzie.com/ii/writings.html
  170.  
  171. ------------------------------
  172.  
  173. Date: 05 May 1995 00:12:00 GMT
  174. Subject: ... ... 0.1.2 Plain Text
  175.  
  176. The plain text version of this FAQ is regularly posted to these
  177. newsgroups:
  178.   news.newusers.questions     news.software.nn
  179.   news.software.readers       news.answers
  180.  
  181. It's in digest format which means that you may be able to use your
  182. newsreader to easily move between digest items (e.g., nn uses G% to
  183. burst a digest and trn uses ^G to jump to the next digest item).
  184.  
  185.  
  186. The plain text version is also available through...
  187.  
  188. A Link on Infinite Ink's Sample Writings Page:
  189.  http://www.jazzie.com/ii/writings.html
  190.  
  191. Anonymous FTP:
  192.  ftp://ftp.halcyon.com/pub/ii/internet/nn/getting_started.txt
  193.  ftp://rtfm.mit.edu/pub/usenet/news.answers/usenet/software/nn/getting-started
  194.  
  195. Email:
  196.  Send mail to mail-server@rtfm.mit.edu containing the following:
  197.     send usenet/news.answers/usenet/software/nn/getting-started
  198.  
  199. UUCP:
  200.  uunet!/archive/usenet/news.answers/usenet/software/nn/getting-started
  201.  
  202. ------------------------------
  203.  
  204. Date: 05 May 1995 00:20:00 GMT
  205. Subject: ... 0.2 Notation
  206.  
  207.  Notation            Means
  208.  ========            =====
  209.  BS                  Backspace key
  210.  CTL or C- or ^      Control key
  211.  DEL                 Delete key
  212.  ESC                 Escape key
  213.  LFD                 Linefeed
  214.  META or M-          Meta key
  215.  RET                 Return or Enter key
  216.  SFT                 Shift key
  217.  SPC                 Space key
  218.  TAB                 Tab key
  219.  ^X                  Press CTL and then, while holding down CTL, press
  220.                      the X key.  Often the the lower case letter will
  221.                      also work so you can use either ^x and ^X.
  222.  TextDescription     appropriate text
  223.  <Text Description>  appropriate text (without the angle brackets)
  224.  <Mode Description>  mode you should be in
  225.  `text' or ``text''  text (without the smart quotes)
  226.  "text"              "text" (including the double quotes)
  227.  'text'              'text' (including the single quotes)
  228.  `text`              `text` (including the back quotes)
  229.  #                   What follows is a comment
  230.  ###                 What follows is commented out code you might want
  231.                      to use by removing the three pound signs
  232.  ~ or $HOME          Your home directory
  233.  
  234.  
  235. SEE ALSO: Section 9.0 "Glossary"
  236.  
  237. ------------------------------
  238.  
  239. Date: 05 May 1995 01:00:00 GMT
  240. Subject: 1.0 Introduction to nn
  241.  
  242. The underlying philosophy of nn is "no news is good news" and "nn"
  243. actually stands for "no news"!  This is because hundreds of thousands
  244. of messages arrive in the over ten thousand newsgroups each day and
  245. nn makes it easy to efficiently read only articles and newsgroups
  246. you're interested in.
  247.  
  248. If you are concerned that nn might be too brutal about killing
  249. articles, don't fear.  You can always view all articles, including
  250. killed articles, using the "Go to all" (`G a') command described in
  251. section 6.1 below.  You can also change nn's default kill behavior by
  252. using some of nn's nearly 200 variables.
  253.  
  254. As of May 1995 the latest released version of nn is 6.4.18.  The
  255. latest beta version is 6.5.0.b3.  The beta is very stable so you
  256. might want to upgrade.  For information about getting and installing
  257. nn see the nn FAQ -- details about finding the FAQ are given in
  258. section 1.3.
  259.  
  260. Historical Note:  nn is based on the tass newsreader.
  261.  
  262. ------------------------------
  263.  
  264. Date: 05 May 1995 01:10:00 GMT
  265. Subject: ... 1.1 Why Use nn? A Comparison of Unix News Readers
  266.  
  267. The most commonly used Unix newsreaders are pine, nn, tin, and trn.
  268. Each of these has many ardent fans and the choice between them
  269. depends on your news reading needs.
  270.  
  271.   News reading Power    Newsreader
  272.   ==================    ==========
  273.   low                   pine
  274.   medium                tin
  275.   high                  nn and trn
  276.  
  277.  
  278. If you are just getting started with news, and you already use pine
  279. for mail, then pine is the easiest way to start reading and
  280. participating in news.  With pine, you'll be able to use your
  281. familiar mail commands to go to a newsgroup and find, select, read,
  282. flag, save, and respond to news articles.
  283.  
  284. If you want something more powerful than pine, and you don't think
  285. you are going to want to evolve into a power news user, then tin is a
  286. good choice because its interface is pretty easy to learn.
  287.  
  288. But, if you want to be a power news user then either trn or nn is the
  289. way to go.  Both nn and trn are powerful, customizable newsreaders
  290. that have evolved over many years.  Neither one is clearly better
  291. than the other.  Here are some of the differences:
  292.  
  293.  
  294. Notation
  295. ========
  296. + is an advantage
  297. o is neutral
  298. - is a disadvantage
  299. ? is something I don't know about
  300.  
  301. TRN
  302. ===
  303. + Contains a superset of RN commands so it's an easy migration for RN
  304.   users.
  305. + newsgroup selection level is friendlier than nn's A/B (advance/back) and
  306.   N/P (next/previous) commands (I like being able to see the list of
  307.   newsgroups that I say no to)
  308. + true threading (uses References line)
  309. + graphic view of thread ("article tree")
  310. + can search the full headers of articles in a newsgroup
  311. + can reorder subscription list from within TRN (using m)
  312. + can have macro names longer than 2 characters
  313. + active participation by trn developer in newsgroup
  314.   (news.software.readers)
  315. + can reverse the sort order (e.g., most recent at the top)
  316. + intrinsic commands for going to root/leaf of a thread (in nn you
  317.   need to do this with macros or a sequence of commands)
  318. + intrinsic command for auto-selecting your articles
  319. + easy to change attribution line to whatever you want (using ATTRIBUTION
  320.   environment variable)
  321. + when you post you get lots of blank headers (e.g., Followup-To) put
  322.   into your editor
  323. o newsgroup (news.software.readers) for discussion but also contains lots
  324.   of non-TRN discussion.
  325. - harder macro language
  326.  
  327.  
  328. NN
  329. ==
  330. + virtual newsgroups - result of subject, author, or full text search
  331. + easier macro language
  332. + more powerful kill/select abilities (ANDing, ORing)
  333. + faster auto killing/selecting
  334. + can split/unsplit a digest
  335. + dedicated newsgroup (news.software.nn) for discussion
  336. + Commands for flagging (l and L) and leaving an article to deal with it later
  337.   (this is better than trn's M command which just returns an article as unread
  338.   next time)
  339. + built-in command for mailing a copy of a followup article to the author you're
  340.   responding to (in trn you need to type the person's email address)
  341. + can easily mail articles you read/post to other addresses
  342. + incredibly customizable
  343. + can easily view and organize your folders (both mail and news) with nn
  344. + can merge newsgroups
  345. + can search all (or some) newsgroups for subject and/or author
  346. + can set default save directory for each newsgroup that is not necessarily
  347.   one of the interpreted strings (e.g., my default save dir for comp.editors
  348.   is +vi)
  349. - not very active participation by developer(s) in newsgroup
  350.   (news.software.nn)
  351. - can only search on subject, author, or full text; also author is the
  352.   "real name" rather than full From line
  353. - macro names limited to 2 characters (as far as I can tell)
  354. ? more powerful macro language than trn
  355.  
  356.  
  357. [Please send more comparisons.]
  358.  
  359. NN Testimonials
  360. ===============
  361. *  Ron Dippold, who handles most newsgroup voting, says that nn is the
  362.    "best Usenet group reader on the planet."
  363.  
  364. *  Despite years of power rn experience and some trn experience,
  365.    and many finely crafted [t]rn macros, I (nancym@ii.com) switched
  366.    to nn because of many of the features listed above.
  367.  
  368. *  [Please send me your NN Testimonial!]
  369.  
  370.  
  371. Fortunately, all these newsreaders (and many others) use the .newsrc
  372. file to track which articles you've read (or marked read), so you can
  373. try out all these newsreaders and not have to reread any articles
  374. you've already read.
  375.  
  376. ------------------------------
  377.  
  378. Date: 05 May 1995 01:20:00 GMT
  379. Subject: ... 1.2 Essential nn Commands
  380.  
  381. Before we go into the step by step process of using nn, here is a
  382. list of essential nn commands.  Be aware that *NN IS CASE SENSITIVE*
  383. -- many commands use upper case letters because lower case letters
  384. are reserved for selecting articles.
  385.  
  386. Type...      In order to...
  387. =======      ==============
  388. SPC          Do the next reasonable thing, usually keep moving through
  389.              articles and newsgroups -- next page, next article, next 
  390.              newsgroup, etc.
  391. RET          Default response to a prompt
  392. ^G           Cancel the current prompt
  393. ?            Quick help on commands available in current mode
  394. :?           Present help on colon commands
  395. :help        Present help subjects
  396. :help subj   Present help on subj, where `subj' is in the `:help' list
  397. :man         Present sections of the nn manual on a menu.  You can then 
  398.              use nn's commands to choose and read sections of the manual.
  399. Q            Quit
  400. :q!          Quit & don't record what you read (or marked read) this 
  401.              session
  402.  
  403. ------------------------------
  404.  
  405. Date: 05 May 1995 01:30:00 GMT
  406. Subject: ... 1.3 Getting nn Help
  407.  
  408. Newsgroup: 
  409.  news.software.nn
  410.  
  411. FAQs: 
  412.  The FAQs are posted regularly to news.software.nn and news.answers,
  413.  and archived in all the usual FAQ archives, including:
  414.  
  415.   http://www.cis.ohio-state.edu/hypertext/faq/usenet/nn-faq/top.html
  416.   ftp://rtfm.mit.edu/pub/usenet/news.answers/usenet/software/nn
  417.  
  418. Web Pages:
  419.   http://www.best.com/~ii/internet/nn/
  420.   http://www.inf.fu-berlin.de/~guckes/nn/
  421.  
  422. Man pages: 
  423.  Read the nn (1) man pages with either the `:man' command from within
  424.  nn or using a pager like less or more (`man nn |less'), so you can
  425.  use the search capabilities of the pager.
  426.  
  427. ------------------------------
  428.  
  429. Date: 05 May 1995 02:00:00 GMT
  430. Subject: 2.0 Your First Time
  431.  
  432. Before you customize nn you need to run it at least once.  This will
  433. create the default files and directories that nn uses.  It will also
  434. familiarize you with the basics of nn and give you ideas for what you
  435. want to customize.
  436.  
  437. ------------------------------
  438.  
  439. Date: 05 May 1995 02:10:00 GMT
  440. Subject: ... 2.1 Starting nn
  441.  
  442. To start nn simply type `nn' at your Unix prompt.  The first time
  443. (and only the first time) you run nn you will get a welcome message.
  444. If you want to see this message again you can access it by ???.
  445.  
  446. [If you know how to view the welcome message after your first time,
  447. please let me know.]
  448.  
  449. You are presented with a menu of articles ("menu mode") in the first
  450. newsgroup in your subscription list.  If you have not set up a
  451. subscription list, then nn uses whatever your system administrator
  452. has set up as the default subscription list.  Your default first
  453. newsgroup might be:
  454.  
  455.  * Whatever is alphabetically first in the list of all newsgroup 
  456.    that your host receives (sometimes this is alt.2600)
  457.  
  458.  * host.announce (where `host' is replaced with the name of your 
  459.    provider, e.g., `halcyon.announce', `best.announce', etc.)
  460.  
  461. ------------------------------
  462.  
  463. Date: 05 May 1995 02:20:00 GMT
  464. Subject: ... 2.2 Going to a Newsgroup and Subscribing
  465.  
  466. To go to a different newsgroup use nn's Go command (G).  For example,
  467. here's how to go to one of the newuser newsgroups (which is a good
  468. idea):
  469.  
  470.  Prompt                          Type         In order to...
  471.  ======                          ====         ==============
  472.  <menu mode>                     G            Go to...
  473.  Group of Folder (+./~%=sneNbB)  newuser RET  ...next newsgroup with
  474.                                              `newuser' in its name
  475.  foo.newuser                     n RET        no, go to next
  476.  news.announce.newusers          y RET        yes, go to this newsgroup
  477.  Number of articles (juasne) (j) RET          jump to the newsgroup
  478.  
  479.  
  480. For now, don't worry about what the cryptic-looking prompts mean.  At
  481. the final prompt you should press RET which means do the default --
  482. `j' for jump (or `a' for all if jumping is not possible).
  483.  
  484. Once you get to the newsgroup look in the upper right corner of the
  485. screen to see if you are subscribed to the newsgroup.  If you are not
  486. subscribed, it will say:
  487.  
  488.  UNSUB
  489.  
  490. In order for nn to keep track of the articles you read, you need to
  491. subscribe.  To subscribe to news.announce.newusers, do this:
  492.  
  493.  Prompt                                                         Type
  494.  ======                                                         ====
  495.  <menu or show mode>                                            U
  496.  Already unsubscribed. Resubscribe to news.announce.newusers?   y
  497.  
  498. U is a toggle that unsubscribes you from a subscribed group or subscribes
  499. you to an unsubscribed group.
  500.  
  501. TIPS
  502. * When searching for a newsgroup with the G command it's a good strategy to
  503.   use a short search string so that you will hit all variations, e.g., use
  504.   sport rather than sports so you will be presented with the alt.sports
  505.   hierarchy as well as rec.sport hierarchy.
  506. * You can always break out of a prompt with ^G.
  507.  
  508. ------------------------------
  509.  
  510. Date: 05 May 1995 02:30:00 GMT
  511. Subject: ... 2.3 Menu Mode: Selecting Articles to Read
  512.  
  513. After you go to a newsgroup you are presented with a menu of articles in
  514. the newsgroup.  Each line contains this information about an article:
  515.  
  516.  ID  Flag  Author  Lines  Subject
  517.  
  518. Here's more details about these:
  519.  
  520.  Field    Details
  521.  ====     ======
  522.  ID       Lower case letter (a-z) or number (0-9); the range depends on 
  523.           screen height
  524.  Flag     read (.), seen on menu but not read (,), left in previous 
  525.           session (=), left this session (+), selected (* or highlighted 
  526.           line)
  527.  Author   Author's full name (or email address if no full name)
  528.  Lines    Number of lines in article (if article has a Lines header)
  529.  Subject  Either the Subject header or if the subject contains only 
  530.           greater than signs (>) or a dash (-), then it has the same 
  531.           subject as the line above. > is a reply, >> is a reply to a 
  532.           reply, etc.; - means same subject as above but not a reply.
  533.  
  534.  
  535. Here are some ways to select articles you'd like to read.
  536.  
  537.  To select (or unselect)...             Type
  538.  ==========================             ====
  539.  single article                         ID
  540.  all articles with current subject      *
  541.  all articles with ID's subject         ID*
  542.  range of articles                      ID1-ID2
  543.  all articles                           =^
  544.  
  545. The = command means "select any subject that contains" and the caret
  546. (^) means a "beginning of line."  Since every subject contains a
  547. "beginning of line," this selects all subjects.
  548.  
  549. To unselect all articles that are selected type two tildes: ~~
  550.  
  551. To move through the pages of the menu use these commands:
  552.  
  553.  Type         In order to move in the menu...
  554.  ====         ===============================
  555.  SPC or >     Forward page
  556.  <            Back page
  557.  ^            First page
  558.  $            Last page
  559.  
  560. ------------------------------
  561.  
  562. Date: 05 May 1995 02:40:00 GMT
  563. Subject: ... 2.4 Show Mode: Reading Selected Articles
  564.  
  565. After you've selected some articles, you can start reading them (go
  566. into "show mode") by typing either SPC on the last page of the menu,
  567. or Z.  These work as follows.
  568.  
  569.  Menu Page  Type  In order to read selected articles and then...
  570.  =========  ====  ==============================================
  571.  any        Z     return to current menu in the current newsgroup
  572.  last       SPC   move to next newsgroup's menu
  573.  
  574.  
  575. I usually use Z because I like returning to the current newsgroup
  576. after reading the articles I selected.  Sometimes something I read
  577. will inspire me to want to read more in the current newsgroup.  The
  578. description below assumes that you typed `Z'.
  579.  
  580. Here are some commands for moving within an article:
  581.  
  582.  Type...    In order to move in current article...
  583.  =======    ======================================
  584.  SPC        Forward page
  585.  u          Up half page
  586.  DEL        Back page
  587.  ^          First page
  588.  h          First page and show all headers
  589.  $          Last page
  590.  
  591.  
  592. And here are some commands for moving between the articles you've selected.
  593.  
  594.  Type     In order to...
  595.  ====     ==============
  596.  SPC      Go to next selected article if you're at end of current article
  597.  n        Go to next selected article
  598.  k        Kill the rest of this subject and go to next subject (this only
  599.           kills the subject for this session; future articles with this 
  600.           subject will be presented)
  601.  p        Go to article previously viewed
  602.  
  603.  
  604. When there are no more selected articles, pressing SPC, n, or k, will
  605. move you back to the menu of the current newsgroup.  At any time you
  606. can use the Z command to go from reading mode to menu mode, or vice
  607. versa.  (Z toggles between these modes.)
  608.  
  609. When you return to the menu after reading some articles you will see
  610. flags next to article IDs.  Articles that you read are marked with a
  611. period (.).  Other flags are described in section 2.3 above.
  612.  
  613. ------------------------------
  614.  
  615. Date: 05 May 1995 02:50:00 GMT
  616. Subject: ... 2.5 Leaving a Newsgroup
  617.  
  618. After you've read the articles you're interested in you can move to
  619. another newsgroup by using one of these commands.
  620.  
  621.  Type     In order to...
  622.  ====     ==============
  623.  SPC      Go to the next newsgroup if you have no more articles selected
  624.           in the current newsgroup.
  625.  A        Advance newsgroup in your sequence
  626.  B        Back newsgroup in your sequence
  627.  G        Go to a newsgroup you specify
  628.  
  629. If you use the A or B command, NN presents the newsgroup name with a prompt
  630. like this:
  631.  
  632.  Enter news.group (STATUS) ?  (ABGNPy)
  633.  
  634. Where STATUS is either READ, UNSUB, or nothing (which means there are
  635. unread articles).  You can then:
  636.  
  637.  Type        In order to...
  638.  ====        ==============
  639.  A           Advance newsgroup in your sequence
  640.  B           Back newsgroup in your sequence
  641.  G           Use the G command and any of its many variations
  642.  N           Advance to newsgroup in your sequence with unread articles
  643.  P           Back to newsgroup in your sequence with unread articles
  644.  RET or y    Go to the newsgroup named in the prompt
  645.  
  646.  
  647. Since nn's philosophy is "no news is good news" its default is to
  648. mark "read" any article that you saw on the menu.  If an article has
  649. been marked read it will not be presented on the menu the next time
  650. you start nn.  (But you can always go to all articles in a newsgroup,
  651. including those marked read, by using the Ga command, which is
  652. described in section 6.1 below.)
  653.  
  654. ------------------------------
  655.  
  656. Date: 05 May 1995 02:60:00 GMT
  657. Subject: ... 2.6 Quitting
  658.  
  659.  Type  In order to...
  660.  ====  ==============
  661.  Q     Quit
  662.  :q!   Quit and don't record what you read (or marked read) this session
  663.  
  664. ------------------------------
  665.  
  666. Date: 05 May 1995 03:00:00 GMT
  667. Subject: 3.0 Your Second Time
  668.  
  669. Between sessions, nn remembers:
  670.  * Articles you read or marked read.
  671.  * Articles you left with the `l' command.
  672.  * Articles you selected but didn't read (and didn't unselect).
  673.  * The newsgroup you were in when you quit.
  674.  
  675. When you start nn (after your first time), you're asked if you want
  676. to go to the newsgroup you were in when you last quit nn with a
  677. prompt like this:
  678.  
  679.   Enter news.group (N unread)?
  680.  
  681. If you answer yes (y or RET) you'll jump to that newsgroup.  If you
  682. answer no (n) you'll jump to the first newsgroup in your subscription
  683. list that has unread articles.  If you always want to start at the
  684. beginning of your subscription list then you can set the
  685. enter-last-read-mode variable to 0.  This is one of the settings
  686. suggested in section 4.4.1 below.
  687.  
  688. ------------------------------
  689.  
  690. Date: 05 May 1995 04:00:00 GMT
  691. Subject: 4.0 Customizing nn
  692.  
  693. One of the greatest things about nn is its customizability.  It has
  694. over 180 variables which you can use to change the way information is
  695. presented and the way commands work.  You can also remap your
  696. keyboard, create macros to do just about anything, and create
  697. customizations that are specific to only some newsgroups.
  698.  
  699. This section describes suggestions for customizing the following files.
  700.  
  701.  File                Purpose
  702.  ====                =======
  703.  .login or .profile  Set your EDITOR environment variable
  704.  .newsrc             Track newsgroup subscriptions & articles read
  705.  seq                 Specify newsgroup sequence, default save files, and
  706.                      more
  707.  init                Variable settings, key mappings, macros, command 
  708.                      groups, and more
  709.  init.*              Files loaded by init (these can actually be named
  710.                      anything)
  711.  kill                Auto kill & select commands
  712.  
  713. The .login, .profile, and .newsrc files are in your home directory (~), and
  714. all the rest reside in your ~/.nn directory.
  715.  
  716. ------------------------------
  717.  
  718. Date: 05 May 1995 04:10:00 GMT
  719. Subject: ... 4.1 Strategy: Plug and Play
  720.  
  721. It's a good strategy to compartmentalize your customizations as much as
  722. possible.  This allows you to easily:
  723.  * Turn on or off a customization.
  724.  * Share some of your customizations with others (and keep some
  725.    customizations private).
  726.  * Move your customizations to another host and, if your host-specific
  727.    customizations are in a separate file, easily change those.
  728.  * Debug customizations (e.g., you can turn everything off but what 
  729.    you are trying to debug).
  730.  * Manage your customizations - small files are much easier to edit 
  731.    than one big unwieldy file.
  732.  
  733. ------------------------------
  734.  
  735. Date: 05 May 1995 04:20:00 GMT
  736. Subject: ... 4.2 Setting Your Editor
  737.  
  738. When you compose a message within nn or nnpost, nn decides which
  739. editor to use as follows:
  740.  
  741. 1. If nn's `editor' variable is set in one of your init files, then
  742.    that is what is used.
  743.  
  744. 2. If nn's `editor' variable is not set, then the EDITOR environment
  745.    variable is used.  If you don't explicitly set your EDITOR
  746.    environment variable, then it is set to the system default, which
  747.    is often vi (which does not stand for "very intuitive"!).
  748.  
  749. Since the EDITOR environment variable is used by many other programs,
  750. it's useful to set nn's editor with it rather than the nn-specific
  751. editor variable.  This way the setting will propagate to other
  752. programs such as your mailer.  Since some programs use the VISUAL
  753. environment variable to determine the editor, it's useful to set this
  754. too.
  755.  
  756. If you don't know what editor to use, the PIne COmposer, pico, is a
  757. good choice.  It's easy to learn and always has a help menu at the
  758. bottom of the screen.  To see if pico is on your system type any of
  759. the following:
  760.  
  761.   which pico
  762.   type pico
  763.   where pico
  764.   whereis pico
  765.  
  766. If it's on your system one of these should tell you what directory
  767. it's in.  If it's not on your system then you will need to use a
  768. different editor (or you could ask your system administrator to
  769. install pico).
  770.  
  771. If you use pico, then you might want to use it with either or both of
  772. these flags.
  773.  
  774.  Flag Meaning
  775.  ==== =======
  776.  -t   tool mode, which prevents some unnecessary save prompts
  777.  -z   allows you to suspend with ^Z and go out to Unix; you return with fg
  778.  
  779. ------------------------------
  780.  
  781. Date: 05 May 1995 04:21:00 GMT
  782. Subject: ... ... 4.2.1 C-Compatible Shells
  783.  
  784. If you are using csh, tcsh, or another C-compatible shell, put the
  785. following in your ~/.login file:
  786.  
  787.   setenv EDITOR "pico -t -z"
  788.   setenv VISUAL "$EDITOR"
  789.  
  790. To "run" your .login either log out and log back in again or type:
  791.  
  792.   source .login
  793.  
  794. To check your new settings are in place, type:
  795.  
  796.   printenv
  797.  
  798. ------------------------------
  799.  
  800. Date: 05 May 1995 04:22:00 GMT
  801. Subject: ... ... 4.2.2 Bourne-Compatible Shells
  802.  
  803. If you are using sh, bash, ksh, or another Bourne-compatible shell,
  804. put the following in your ~/.profile:
  805.  
  806.   EDITOR="pico -t -z"  export EDITOR
  807.   VISUAL="$EDITOR"  export VISUAL
  808.  
  809. To "run" your .profile either log out and log back in again or type:
  810.  
  811.   . .profile
  812.  
  813. To check your settings type:
  814.  
  815.   printenv
  816.  
  817. ------------------------------
  818.  
  819. Date: 05 May 1995 04:30:00 GMT
  820. Subject: ... 4.3 Your Subscription List
  821.  
  822. Your subscription list is determined by both your .newsrc file and
  823. your seq file (*).  Your .newsrc keeps track of what newsgroups
  824. you're subscribed to and what articles you've read in those
  825. newsgroups.  Your seq file tells nn:
  826.  * which collections of newsgroups to merge into a virtual newsgroup
  827.  * the order in which you want to be presented newsgroups
  828.  * the default save folder for each newsgroup
  829.  
  830.  
  831. (*) You can specify your sequence in either a separate seq file or as
  832.     the last part of your init file, in a section starting with the
  833.     word `sequence'.  Using the seq file is more in keeping with the
  834.     plug and play strategy, so that's what I describe below.
  835.     NOTE: The seq file is currently not documented in the nn man pages.
  836.  
  837. ------------------------------
  838.  
  839. Date: 05 May 1995 04:31:00 GMT
  840. Subject: ... ... 4.3.1 Your seq File
  841.  
  842. If you have used other Unix newsreaders and your .newsrc is already
  843. ordered the way you like it, then, to begin with, you can use it as
  844. your sequence.  To set this up simply put `RC' in your ~/.nn/seq
  845. file.  Here are instructions using pico as your editor.
  846.  
  847.  Type        In order to...
  848.  ====        ==============
  849.  cd          go to your home directory
  850.  cd .nn      go to your .nn directory
  851.  pico seq    create your seq file using the pico editor
  852.  RC          put `RC' in the file
  853.  ^X          exit pico
  854.  y           answer yes to the question about saving the file
  855.  
  856. Now you can start nn and newsgroups will be presented in your .newsrc
  857. order.
  858.  
  859. If you do not have your .newsrc ordered the way you'd like it, or if
  860. you want to take advantage of nn's sequence features, including being
  861. able to:  
  862.  * Specify a default save folder for each newsgroup 
  863.  * Use wild cards like `all' to specify a hierarchy, e.g.,
  864.   `rec.arts.movies.all' 
  865.  * Merge newsgroups into a virtual newsgroup
  866.  
  867. Then you should specify your sequence in your seq file.  The format
  868. looks like this:
  869.  
  870.  
  871. # Newsgroup(s)         Default Save Folder
  872. # ============         ===================
  873.   favorite.group       +folder1
  874.   next.favorite.group
  875.   hierarchy.all                  #all groups in this hierarchy, 1 at a time
  876.   group.a,group.b      +folder2  #merge group.a & group.b into 1 virtual group
  877.  
  878. NOTES
  879. * Anything after a pound sign (#) is a comment.
  880. * In order for a newsgroup in your sequence to show up when using SPC
  881.   to move through newsgroups you must be subscribed to it.
  882. * If you don't specify a save file, the default-save-file variable 
  883.   setting is used.  (See section 4.4.1 for a suggested default-save-file 
  884.   setting.)
  885.  
  886. Here's an example seq file.
  887.  
  888.  halcyon.announce                 +halcyon
  889.  halcyon.all                      +halcyon
  890.  seattle.all                      +seattle
  891.  news.newusers.questions          +newusers
  892.  news.software.nn
  893.  news.software.readers            +newsreaders
  894.  comp.mail.pine
  895.  comp.mail.misc                   +mail
  896.  comp.unix.questions              +unix
  897.  rec.arts.movies.all
  898.  clari.news.urgent
  899.  clari.news.top
  900.  clari.world.top
  901.  clari.biz.urgent
  902.  clari.biz.top
  903.  seattle.forsale,halcyon.forsale
  904.  
  905. With this seq file, if you save (s) an article in the
  906. news.software.readers group, for example, it will be saved in a
  907. folder named "newsreaders" in your folder directory.
  908.  
  909. ------------------------------
  910.  
  911. Date: 05 May 1995 04:32:00 GMT
  912. Subject: ... ... 4.3.2 Your .newsrc File
  913.  
  914. Your .newsrc file, which resides in your home directory (~), is used
  915. by most Unix newsreaders, including nn, to keep track of what
  916. newsgroups you are subscribed to and what articles you've read.
  917. Lines in the .newsrc file look like this:
  918.  
  919.  group1.name: m-n,p-q
  920.  group2.name!
  921.  
  922. A colon (:) after the newsgroup name means you are subscribed and a
  923. exclamation point (!) means you are unsubscribed.  The numbers are
  924. articles, or ranges of articles, that you've read.
  925.  
  926. ------------------------------
  927.  
  928. Date: 05 May 1995 04:32:10 GMT
  929. Subject: ... ... ..... 4.3.2.1 Strategy: Subscribe to All Newsgroups
  930.  
  931. There are two main strategies that people use for subscribing to
  932. newsgroups:
  933.  1. Subscribe to only the newsgroups you read.
  934.  2. Subscribe to all newsgroups your host receives (sometimes 
  935.     10,000+ newsgroups!).
  936.  
  937. I prefer the second strategy because then:
  938.  * You can add anything to your seq file and it will be presented
  939.    when you move through news using SPC.
  940.  
  941.  * You never need to type U to subscribe to a newsgroup.  (Remember
  942.    that if you read a newsgroup that you aren't subscribed to nn
  943.    won't keep track of what you've read and so then the next time you
  944.    go to it you'll be presented all the articles again.)
  945.  
  946.  * You never (or very rarely) type `nn' and get this response:  
  947.      No News (is good news)
  948.  
  949.  
  950. To see the newsgroups you are not subscribed to, type:
  951.  
  952.   nngrep -u |less
  953.  
  954. To append these unsubscribed groups to your .newsrc:
  955.  
  956.  Type
  957.  ====
  958.  cd
  959.  cp .newsrc .newsrc.old
  960.  nngrep -u | sed -e 's/$/:/' -e '/^C/d' >> .newsrc
  961.  
  962. The cryptic looking last command takes the output of the `nngrep -u'
  963. command and uses sed, a stream editor, to add colon (:) to the end of
  964. each line and then remove any line that starts with a `C' (specifically 
  965. lines that say ``Connecting to NNTP server...'').  It then appends 
  966. these lines to your .newsrc file.
  967.  
  968. Now start nn and make sure that your .newsrc file wasn't corrupted by
  969. a typo you may have made in the above command.  If it's been
  970. corrupted you will get an error message and you can revert to your
  971. old .newsrc file by typing:
  972.  
  973.  cp .newsrc.old .newsrc
  974.  
  975.  
  976. WARNING: If you directly edit your .newsrc file make sure that you
  977. use an editor that can handle any long lines in your .newsrc.  For
  978. example, if you use pico you should turn autowrap off, i.e., use
  979. `pico -w .newsrc'.  `pico -w' can handle lines up to 128 characters
  980. long.  [Please send me info about other editors that can handle long
  981. lines.]
  982.  
  983. ------------------------------
  984.  
  985. Date: 05 May 1995 04:33:00 GMT
  986. Subject: ... ... 4.3.3 Finding Newsgroups You're Interested In
  987.  
  988. Here are some ways to find interesting newsgroups:
  989.  
  990. * Read these articles that are regularly posted to news.groups and
  991.   news.lists:
  992.     List of Active Newsgroups, Part I and II
  993.     Alternative Newsgroup Hierarchies, Part I, II, and III
  994.  
  995.   These articles are archived at all the usual FAQ archives
  996.   including:
  997.  
  998.   http://www.cis.ohio-state.edu/hypertext/faq/bngusenet/news/groups/top.html
  999.  
  1000. * Search through the news hierarchies at:
  1001.     http://www11.w3.org/hypertext/DataSources/News/Groups/Overview.html
  1002.  
  1003. * Read and ask questions in news.groups.questions.
  1004.  
  1005. * Regularly read news.announce.newgroups, which is where new 
  1006.   newsgroups are announced.
  1007.  
  1008. * Look at the Newsgroups header to see what group(s) an interesting 
  1009.   article is crossposted to.
  1010.  
  1011. * Look at the master list of newsgroups with short descriptions:
  1012.  
  1013.     ftp://ftp.uu.net/networking/news/config/newsgroups.gz
  1014.     ftp://ftp.uu.net/networking/news/config/newsgroups.Z
  1015.  
  1016.   After you use ftp to retrieve one of these you will need to
  1017.   uncompress it.
  1018.  
  1019. * Look at Infinite Ink's Web page, which has links to lists of 
  1020.   newsgroups:
  1021.  
  1022.     http://www.best.com/~ii/internet/
  1023.  
  1024. * Look at the `newsgroups' file on your system.  This file contains a
  1025.   list of all newsgroups that your host receives, with a short
  1026.   description.  Sometimes this file is in /usr/lib/news/newsgroups --
  1027.   you can ask your system administrator where it's located on your
  1028.   system.
  1029.  
  1030. * Use nngrep to get a list of newsgroups your host receives (but without
  1031.   descriptions) by doing one of the following:
  1032.  
  1033.   Type                  In order to...
  1034.   ====                  ==============
  1035.   nngrep -a |less       View all newsgroups at your host in the less pager
  1036.   nngrep -a text |less  View all newsgroups with `text' in their name
  1037.  
  1038. * From within nn you can use the G command to be prompted for all
  1039.   newsgroups that contain some text you specify, and to go to one you
  1040.   are interested in.  See section 2.2 and/or 5.4.2 for instructions.
  1041.  
  1042. ------------------------------
  1043.  
  1044. Date: 05 May 1995 04:40:00 GMT
  1045. Subject: ... 4.4 Your init File
  1046.  
  1047. It's possible to establish most of your customizations in your init
  1048. file but to use the plug and play strategy, use your init file to
  1049. specify only other files to load.  For example, you could put these
  1050. lines in your ~/.nn/init file:
  1051.  
  1052.  
  1053. --- begin init ---
  1054. # Archived in ftp://ftp.halcyon.com/pub/ii/internet/nn/init
  1055.  
  1056. load init.variables
  1057. load init.keymaps
  1058. load init.macros.jump
  1059. load init.macros.all-subject
  1060. load init.host      #put init.host last so it overrides other settings
  1061. --- end init ---
  1062.  
  1063. In all the init files, any text following a pound sign (#) is a
  1064. comment and is ignored by nn.  To "unplug" one of these just put a #
  1065. at the beginning of a line.  To "plug" it in remove the #.
  1066.  
  1067. Descriptions of these files are below.
  1068.  
  1069.  File                      Describe in section...
  1070.  ====                      ======================
  1071.  init.variables            4.4.1
  1072.  init.keymaps              4.4.2
  1073.  init.host                 4.4.3
  1074.  init.macros.jump          5.4.2.1
  1075.  init.macros.all-subject   6.2.1.1
  1076.  
  1077. All these init files are archived at:
  1078.   ftp://ftp.halcyon.com/pub/ii/internet/nn
  1079.  
  1080. ------------------------------
  1081.  
  1082. Date: 05 May 1995 04:41:00 GMT
  1083. Subject: ... ... 4.4.1 Variable Settings
  1084.  
  1085. You can use nn's over 180 variables to customize nn's behaviour.
  1086. Below are some especially useful settings.
  1087.  
  1088.  
  1089. --- begin init.variables ---
  1090. # Archived in ftp://ftp.halcyon.com/pub/ii/internet/nn/init.variables
  1091.  
  1092. # In nn, list variables settings with `:set' or `:set all'
  1093.  
  1094. # When nn starts, always begin with the first group set in the seq file
  1095. set enter-last-read-mode 0
  1096.  
  1097. # Always show purpose of group
  1098. set show-purpose-mode 2
  1099.  
  1100. # Show each subject only once on menu
  1101. # Bug: Doesn't work with merged groups
  1102. set consolidated-menu on
  1103.  
  1104. # On the menu show only: ID, number of articles, subject
  1105. # Default is 1: ID, author, number of lines, subject
  1106. set layout 3
  1107.  
  1108. # When reading a message show these header lines
  1109. # For info, see CUSTOMIZED ARTICLE HEADER PRESENTATION section of man pages
  1110. set header-lines FOnW*Y
  1111.  
  1112. # Don't split a digest until user says to with G%
  1113. set split off
  1114.  
  1115. # Make default save folder name last component of newsgroup name
  1116. # E.g.: rec.arts.movies default save folder will be +movies
  1117. set default-save-file +$L
  1118.  
  1119. # Save articles so I can view them with mailers (pine, elm, etc.)
  1120. set mail-format on
  1121.  
  1122. # Silently append new groups to .newsrc; stay subscribed to all groups
  1123. set new-group-action 3
  1124. set keep-unsubscribed on
  1125. set tidy-newsrc on
  1126.  
  1127. # Interpret a complete newsgroup name in the seq exactly as it is, i.e.,
  1128. # don't interpret it as meaning the newsgroups *and* all its subgroups.
  1129. set also-subgroups off
  1130. --- end init.variables ---
  1131.  
  1132. ------------------------------
  1133.  
  1134. Date: 05 May 1995 04:42:00 GMT
  1135. Subject: ... ... 4.4.2 Key Mappings
  1136.  
  1137. It gets confusing when different programs use different keys for the
  1138. same command.  For example, pine and lynx use the minus key, `-', to
  1139. move back a page, but nn uses `<' to move back a page in a menu mode
  1140. and the BS key to move back a page in show mode.  You can map a key
  1141. to an nn command by using nn's map command.  The format of the
  1142. command is:
  1143.  
  1144.  map <mode> <key> <command>
  1145.  
  1146. Where <mode> is either `menu', `show', or `both'.
  1147.  
  1148. Below are a few key mappings that I like to use.
  1149.  
  1150.  
  1151. --- begin init.keymaps ---
  1152. # Archived in ftp://ftp.halcyon.com/pub/ii/internet/nn/init.keymaps
  1153.  
  1154. # In nn you can see mappings with `:show map'
  1155.  
  1156. # For a list of all command names see STANDARD KEY BINDINGS section of the
  1157. # nn manual (pages 78-83 in nn 6.4.18 man pages)
  1158.  
  1159.  
  1160. # Shouldn't have to do this mapping, but by default they aren't working
  1161. map show A advance-group
  1162. map show B back-group
  1163.  
  1164. # For compatibility with pine and lynx
  1165. map both - page-1
  1166.  
  1167. # Since - is now being used for page-1, need something for select-range
  1168. map menu _ select-range
  1169.  
  1170. # For compatibility with elm and pine have i go to menu (index).
  1171. map show i goto-menu
  1172.  
  1173. # My screen isn't long enough to show article IDs x and z; so why not use
  1174. # x and z to also do what X and Z do...
  1175. ### map both x read-skip
  1176. ### map menu z read-return
  1177. ### map show z goto-menu
  1178. --- end init.keymaps ---
  1179.  
  1180. ------------------------------
  1181.  
  1182. Date: 05 May 1995 04:43:00 GMT
  1183. Subject: ... ... 4.4.3 Host-Specific Settings
  1184.  
  1185. It's useful to put information that is specific to your host in a
  1186. separate file.  This way if you get an account on another machine you
  1187. can transfer all your init files and easily edit the host-specific
  1188. information.  Here are some of the things I put in my init.host:
  1189.  
  1190.  
  1191. --- begin init.host ---
  1192. # Archived in ftp://ftp.halcyon.com/pub/ii/internet/nn/init.host
  1193.  
  1194. # This is what + is replaced by when you save an article or go to a folder.
  1195. # Default: ~/News
  1196. set folder ~/Folders
  1197.  
  1198. # Save copy of articles I post or mail.
  1199. # Default: Not set (i.e., they aren't saved)
  1200. set news-record ~/Folders/Posted
  1201. set mail-record ~/Folders/Mailed
  1202.  
  1203. # Replace with your organization's name, and remove the leading #'s
  1204. ### set news-header Organization: Infinite Ink, Seattle, WA, USA
  1205. ### set mail-header Organization: Infinite Ink, Seattle, WA, USA
  1206. --- end init.host ---
  1207.  
  1208. ------------------------------
  1209.  
  1210. Date: 05 May 1995 05:00:00 GMT
  1211. Subject: 5.0 Efficiently Reading Lots of News
  1212.  
  1213. With nn it's easy to filter through lots of articles in lots of
  1214. newsgroups and only read articles you're interested in.  These three
  1215. variables, which were set in init.variables above, especially help
  1216. because they minimize the amount of information you need to scan.
  1217.  
  1218.   set consolidated-menu on
  1219.   set layout 3
  1220.   set split off
  1221.  
  1222. ------------------------------
  1223.  
  1224. Date: 05 May 1995 05:10:00 GMT
  1225. Subject: ... 5.1 Killing and Auto-Selecting Subjects and Authors
  1226.  
  1227. One of the keys to moving through lots of news articles is "killing"
  1228. subjects and authors that you don't want to read, and auto-selecting
  1229. subjects and authors that you do want to read.
  1230.  
  1231. The `k' command kills the current subject for the current session
  1232. only.  Use this when you're tired of a subject but you may want to
  1233. look in on it again in a future session.
  1234.  
  1235. The `K' command kills or auto-selects a subject or author for the
  1236. number of days you specify, anything from one day to permanently.
  1237. Here's an example of using the `K' command to set up auto selection
  1238. of any article with *you* as the author.
  1239.  
  1240.  Prompt                                                       Type
  1241.  ======                                                       ====
  1242.  <reading an article you posted>                              K
  1243.  AUTO (k)ill or (s)elect (CR => Kill subject 30 days)         s
  1244.  AUTO SELECT on (s)ubject or (n)ame  (s)                      n
  1245.  SELECT Name: (=/)                                            RET
  1246.  SELECT in (g)roup 'newsgroup.name' or in (a)ll groups  (g)   a
  1247.  Lifetime of entry in days (p)ermanent  (30)                  p
  1248.  CONFIRM SELECT Name perm exact: YourFullName                 RET
  1249.  
  1250.  
  1251. At the `SELECT Name' (or `SELECT Subject') prompt, pressing RET means
  1252. to use the current name (or subject).
  1253.  
  1254. One of the most common ways to use `K' is to kill the current subject
  1255. in the current newsgroup for 30 days.  Doing this takes only two
  1256. keystrokes:
  1257.  
  1258.  Prompt                                                       Type
  1259.  ======                                                       ====
  1260.  <reading an article you posted>                              K
  1261.  AUTO (k)ill or (s)elect (CR => Kill subject 30 days)         RET
  1262.  
  1263. After 30 days the kill command will automatically be commented out in
  1264. your "kill file."  Your "kill file" is ~/.nn/kill and it is where all
  1265. the kill and select commands that you create with the `K' command are
  1266. stored.  In addition to using the `K' command, you can also use your
  1267. editor to directly edit your kill file and create, edit, or delete
  1268. kill commands.
  1269.  
  1270. ------------------------------
  1271.  
  1272. Date: 05 May 1995 05:20:00 GMT
  1273. Subject: ... 5.2 Quick Selecting Subjects
  1274.  
  1275. While you are in menu mode you can quickly select each article that
  1276. contains some particular text in its subject.  To do this:
  1277.  
  1278.  Prompt                 Type
  1279.  ======                 ====
  1280.  <menu mode>            =
  1281.  Select regexp          text RET
  1282.  Selected N articles
  1283.  
  1284. The text that you specify can be plain text or an egrep(1) regular
  1285. expression.  For example, the regular expression ^ matches the
  1286. beginning of a line, so to select all subjects in the current
  1287. newsgroup, type:
  1288.  
  1289.     =^
  1290.  
  1291. ------------------------------
  1292.  
  1293. Date: 05 May 1995 05:30:00 GMT
  1294. Subject: ... 5.3 Select, Read, Flag, Kill, Next Newsgroup
  1295.  
  1296. When you want to power your way through a newsgroup, one strategy is
  1297. to rely on nn's default behaviour that you get by typing SPC.  The
  1298. following is pretty much the strategy I use.
  1299.  
  1300. MENU MODE STRATEGY
  1301. Use SPC to page through all pages of the menu, selecting all subjects
  1302. you're interested in.
  1303.  
  1304. MOVING FROM MENU TO SHOW MODE
  1305. On the last menu page press SPC to go into reading mode.
  1306.  
  1307. SHOW MODE STRATEGY
  1308. Use SPC to page through the pages of an article.
  1309.  
  1310. MOVING FROM ONE ARTICLE TO ANOTHER ARTICLE
  1311. On the last page of an article press SPC to go to the next selected
  1312. article.  Or you can use one of the following:
  1313.  
  1314.  Type    In Order To...
  1315.  ====    ==============
  1316.  n       Move to the next selected article.
  1317.  k       Move to the next selected subject.
  1318.  l       Flag this article and leave it so you can deal with it later.
  1319.  K       Kill or auto-select the current subject or author for this
  1320.          and future sessions.
  1321.  
  1322.  
  1323. LEAVING A NEWSGROUP STRATEGY
  1324. After you've read (or marked read) the last selected article in the
  1325. newsgroup, press SPC to move to the next newsgroup in your sequence
  1326. with unread articles.
  1327.  
  1328. ------------------------------
  1329.  
  1330. Date: 05 May 1995 05:40:00 GMT
  1331. Subject: ... 5.4 Moving Between Newsgroups
  1332.  
  1333. The easiest way to move through newsgroups is to arrange your
  1334. sequence so that they are presented in the order you want to view
  1335. them.  Even if you have your sequence perfectly arranged you will
  1336. often want to go to a newsgroup that isn't next in your sequence.  If
  1337. you want to go to a newsgroup that's close to where you currently are
  1338. in your sequence, use the A or B command to step forward or backward
  1339. through your sequence (see section 2.5 above for details on the A and
  1340. B commands).  If you want to go to a newsgroup that's not close by,
  1341. use the G command.  With the G command you can either:
  1342.  
  1343. * Temporarily go to a newsgroup, which means that nn will
  1344.   automatically return to the group you came from when you finish
  1345.   with the group.  nn will not keep track of articles that you read
  1346.   or flag -- it's as if you were never there.
  1347.  
  1348. * Jump to a newsgroup, which means that nn will not remember the
  1349.   group you came from and when you are finished with the group you
  1350.   will move on to the next group in your sequence (i.e., the group
  1351.   after the one you just jumped to).  nn will keep track of the
  1352.   articles you read and flag.
  1353.  
  1354. ------------------------------
  1355.  
  1356. Date: 05 May 1995 05:41:00 GMT
  1357. Subject: ... ... 5.4.1 Going to a Newsgroup *Temporarily*
  1358.  
  1359. To temporarily go to a newsgroup named group.bar:
  1360.  
  1361.  Prompt                          Type             In order to...
  1362.  ======                          ====             ==============
  1363.  <menu or show mode>             G                Go to...
  1364.  Group of Folder (+./~%=sneNbB)  bar RET          ...next newsgroup with
  1365.                                                   `bar' in its name
  1366.  foo.bar                         n RET            no, go to next
  1367.  group.bar                       y RET            yes, go to this newsgroup
  1368.  Number of articles (juasne) (j) <anything but j> temporarily go to group.bar
  1369.  
  1370. Here's the meaning of the choices in the last prompt:
  1371.  
  1372.  Type  In order to *temporarily* go to...
  1373.  ====  ==================================
  1374.  u     unread articles
  1375.  a     all articles
  1376.  s     articles with subject matching what you specify
  1377.  n     articles with author matching what you specify
  1378.  e     articles with either subject or author matching what you specify
  1379.  
  1380. When you temporarily go to a newsgroup:
  1381. * The upper right corner will say *NO*UPDATE*
  1382. * The lower right corner will say <Level N>.  N is a number that
  1383.   tells how far you are from the top level (i.e., the "current"
  1384.   underlying group).  E.g., <Level 2> is one away from the top and
  1385.   <Level 3> is two away from the top.
  1386.  
  1387. ------------------------------
  1388.  
  1389. Date: 05 May 1995 05:42:00 GMT
  1390. Subject: ... ... 5.4.2 Jumping to a Newsgroup
  1391.  
  1392. When you "jump" to a newsgroup, articles you read and flag are
  1393. tracked in your ~/.newsrc and ~/.nn/select, respectively.  To jump to
  1394. a newsgroup named group.bar:
  1395.  
  1396.  Prompt                          Type       In order to...
  1397.  ======                          ====       ==============
  1398.  <menu mode>                     G          Go to...
  1399.  Group of Folder (+./~%=sneNbB)  bar RET    ...next newsgroup with `bar'
  1400.                                             in its name
  1401.  foo.bar                         n RET      no, go to next
  1402.  group.bar                       y RET      yes, go to this newsgroup
  1403.  Number of articles (juasne) (j) j          jump to group.bar
  1404.  
  1405.  
  1406. NOTES
  1407.  * You must be in menu mode in order to jump.
  1408.  * If all articles in a newsgroup are marked read, you cannot jump
  1409.    to the newsgroup.
  1410.  
  1411. ------------------------------
  1412.  
  1413. Date: 05 May 1995 05:42:10 GMT
  1414. Subject: ... ... ..... 5.4.2.1 Jump Macro
  1415.  
  1416. Since jumping to a newsgroup is one of the most common things to do,
  1417. it's useful to have a macro for this.  The following macro is invoked
  1418. by typing ^j (CTL+j).  It prompts you for part or all of a newsgroup
  1419. name, and then it jumps to the newsgroup if it can (i.e., if there
  1420. are unread articles).  If it can't jump, it does the default, which
  1421. is to go to all articles in the group.
  1422.  
  1423. --- begin init.macros.jump ---
  1424. # Archived at ftp://ftp.halcyon.com/pub/ii/internet/nn/init.macros.jump
  1425.  
  1426. map both ^j (
  1427.         ?show goto-menu :!clear  #So you really can jump
  1428.         goto-group
  1429.         prompt "Type part or all of newsgroup name:"
  1430.         input " "
  1431.         prompt ""                #Clear prompt
  1432. )
  1433. --- end init.macros.jump ---
  1434.  
  1435. To install this macro, put init.macros.jump in your ~/.nn directory
  1436. and put this line in your init file:
  1437.  
  1438.  load init.macros.jump
  1439.  
  1440. ------------------------------
  1441.  
  1442. Date: 05 May 1995 05:50:00 GMT
  1443. Subject: ... 5.5 Reading an Article That's in Digest Format
  1444.  
  1445. Some articles (like this one) are in digest format.  An article is in
  1446. digest format if it contains a sequence of messages, each with their
  1447. own headers.  Often, nn can split a digest and present each subject
  1448. as a separate item on a menu.  In order for nn to be able to split a
  1449. digest, each sub-message must have a Subject header and either a Date
  1450. or From header, i.e., each message must contain at least...
  1451.  
  1452.  Date:
  1453.  Subject:
  1454.  
  1455. or...
  1456.  
  1457.  From:
  1458.  Subject:
  1459.  
  1460.  
  1461. Any other headers are fine but it must contain at least either of the
  1462. above pairs of headers.  So, for example, the following will work:
  1463.  
  1464.  Date:
  1465.  From:
  1466.  Subject:
  1467.  
  1468. Usually nn's default is to automatically split a digest (but your
  1469. system administrator may have configured it differently on your
  1470. system).  You can control the default behavior by setting the split
  1471. variable in one of your init files such as init.variables.
  1472.  
  1473. set split off  #On the menu, present a digest as a single article
  1474. set split on   #On the menu, present each digest sub-message as a menu item
  1475.  
  1476. I prefer `set split off' because then the article only takes up one
  1477. line on the menu.  If you are interested in it, you can select it and
  1478. then, when you are reading it, you can split it by typing G%.  Once a
  1479. digest is split, you can read, respond to, print, and save individual
  1480. digest items.
  1481.  
  1482. SEE ALSO: Digest format is specified in RFC1153.
  1483.  
  1484. ------------------------------
  1485.  
  1486. Date: 05 May 1995 06:00:00 GMT
  1487. Subject: 6.0 Virtual Newsgroups: Creating a Custom Menu of Articles
  1488.  
  1489. You can use the G command or the `nn -mxX' command to create a
  1490. virtual newsgroup, i.e., a menu of articles that are the results of
  1491. searching subjects, authors, or full text of articles.
  1492.  
  1493. ------------------------------
  1494.  
  1495. Date: 05 May 1995 06:10:00 GMT
  1496. Subject: ... 6.1 Presenting All Articles in a Newsgroup
  1497.  
  1498. To go to all articles, both read and unread, in the current group do
  1499. the follwoing.
  1500.  
  1501.  Prompt                          Type   In order to...
  1502.  ======                          ====   ==============
  1503.  <menu or reading mode>          G      Go to...
  1504.  Group of Folder (+./~%=sneNbB)  a      ...all articles in current group
  1505.  
  1506. NOTE: Even though a is not one of the optiongs listed in the prompt,
  1507.       it does work.  This is another undocumented feature.
  1508.  
  1509. To go to all articles in a group that you're not currently in, use
  1510. the G command to specify the group and then type `a' at this prompt:
  1511.  
  1512.  Number of articles (juasne) (j)
  1513.  
  1514. ------------------------------
  1515.  
  1516. Date: 05 May 1995 06:20:00 GMT
  1517. Subject: ... 6.2 Searching For Subjects or Authors
  1518.  
  1519. Subjects and authors' full names are indexed so that nn can very
  1520. quickly search these.  Note that only the author's full name is
  1521. indexed so you cannot do a fast search on an email address or
  1522. fragment of an email address.  The default is for searches to be
  1523. case insensitive.
  1524.  
  1525. ------------------------------
  1526.  
  1527. Date: 05 May 1995 06:21:00 GMT
  1528. Subject: ... ... 6.2.1 Within a Newsgroup
  1529.  
  1530. If you are already in the newsgroup that you want to search, type `G'
  1531. to get this prompt:
  1532.  
  1533.   Group of Folder (+./~%=sneNbB)
  1534.  
  1535. If you're not in the newsgroup that you want to search, use the `G'
  1536. command to specify the group, and get to this prompt:
  1537.  
  1538.   Number of articles (juasne) (j)
  1539.  
  1540. At either of these prompts:
  1541.  
  1542.  Type  To search...                Resulting prompt
  1543.  ====  ============                ================
  1544.  s     subjects                    s=
  1545.  n     authors' full names         n=
  1546.  e     both subjects and authors   e=
  1547.  
  1548. At the resulting prompt:
  1549.  
  1550.  Type        In order to...
  1551.  ====        ==============
  1552.  RET         use the current subject or author as the search text
  1553.  text RET    specify the search text
  1554.  
  1555. ------------------------------
  1556.  
  1557. Date: 05 May 1995 06:21:10 GMT
  1558. Subject: ... ... ..... 6.2.1.1 Macro to Show All Articles with Current Subject
  1559.  
  1560. Often you will read an article and want to go back and read all the
  1561. articles that have been posted with its subject.  Here's a macro that
  1562. does this.  To run it type ^a (CTL+a) while reading an article with
  1563. the subject you're interested in.
  1564.  
  1565.  
  1566. --- begin init.macros.all-subject ---
  1567. # Archived at ftp://ftp.halcyon.com/pub/ii/internet/nn/init.macros.all-subject
  1568.  
  1569. # Select all (even read) articles with this subject; display base article
  1570. # Assumes you have case-fold-search set, and want to do a case-sensitive
  1571. # search.
  1572. # BUG: Also finds articles with current subject as substring of subject.
  1573. #      (Anyone know how to do an exact match?)
  1574. map show ^a (
  1575.         :unset case-fold-search    # Make case sensitive
  1576.         goto-group "s" find "^" 'Z'
  1577.         :set case-fold-search      # Make case insensitive (default)
  1578. )
  1579. --- end init.macros.all-subject ---
  1580.  
  1581. To install this macro, put init.macros.all-subject in your ~/.nn directory
  1582. and put this line in your init file:
  1583.  
  1584.  load init.macros.all-subject
  1585.  
  1586. ------------------------------
  1587.  
  1588. Date: 05 May 1995 06:22:00 GMT
  1589. Subject: ... ... 6.2.2 Across Newsgroups
  1590.  
  1591. You can search for subjects or authors in many newsgroups, using some
  1592. of nn's command line flags.  These are the ones I use the most:
  1593.  
  1594. Type at Unix prompt  To search all groups, all articles, & merge results
  1595. ===================  ===================================================
  1596. nn -mxXs"text"       search subjects for `text'
  1597. nn -mxXs/"regexp"    search subjects for regular expression `regexp'
  1598. nn -mxXn"text"       search authors' full names for `text'
  1599. nn -mxXn/"regexp"    search authors' full names for regular expression `regexp'
  1600.  
  1601.  
  1602. For each of these, if you don't specify anything else, all articles
  1603. in all newsgroups will be searched.  THIS CAN TAKE A REALLY LONG
  1604. TIME, so usually what I do is specify a hierarchy to search.  For
  1605. example to search all subjects in the sci hierarchy for "realism", I'd
  1606. use this:
  1607.  
  1608.  nn -mxXs"realism" sci.all
  1609.  
  1610. ------------------------------
  1611.  
  1612. Date: 05 May 1995 06:30:00 GMT
  1613. Subject: ... 6.3 Full Text Searching
  1614.  
  1615. Full text searching can be very time consuming because (currently)
  1616. there aren't full text indexes like there are subject and author
  1617. indexes.
  1618.  
  1619. ------------------------------
  1620.  
  1621. Date: 05 May 1995 06:31:00 GMT
  1622. Subject: ... ... 6.3.1 Across Articles in a Newsgroup
  1623.  
  1624. Full text searching across articles in a newsgroup is only available
  1625. in nn 6.5 (and higher versions), and then only if your sys admin
  1626. turned this feature on at compile time.  If your version of nn
  1627. doesn't have this feature, you can use either trn or pine 3.90 (or
  1628. higher) to do a full text search across articles (*).
  1629.  
  1630. To do a full text search of articles in the current newsgroup, type
  1631. `G' to get this prompt:
  1632.  
  1633.   Group of Folder (+./~%=sneNbB)
  1634.  
  1635. And then:
  1636.  
  1637.  Type   To search the full text of...
  1638.  ====   =============================
  1639.  b      all articles on the menu
  1640.  B      all articles (both read and unread) in the newsgroup
  1641.  
  1642. You will then get this prompt:
  1643.  
  1644.   Article body search pattern=
  1645.  
  1646. Now specify the search text.
  1647.  
  1648. To speed up full text searching you may want to use the Gs or Gn
  1649. command to first create a menu, and then use the Gb command to search
  1650. only that menu.
  1651.  
  1652.  
  1653. (*) Instructions for full text searching across articles in pine
  1654.     and trn are accessible from Infinite Ink's Internet Web Page:
  1655.  
  1656.        http://www.best.com/~ii/internet/
  1657.  
  1658. ------------------------------
  1659.  
  1660. Date: 05 May 1995 06:32:00 GMT
  1661. Subject: ... ... 6.3.2 Within One Article
  1662.  
  1663. To search through the article you are currently reading:
  1664.  
  1665.   Type     In order to...
  1666.   ====     ==============
  1667.   ^        Go to the top of the article
  1668.   /text    Search for `text'
  1669.   .        Repeat the search
  1670.  
  1671. ------------------------------
  1672.  
  1673. Date: 05 May 1995 07:00:00 GMT
  1674. Subject: 7.0 Saving Articles
  1675.  
  1676. Since news articles expire, sometimes very quickly, you will probably
  1677. want to save some articles.
  1678.  
  1679. RELEVANT VARIABLES: folder, mail-format, suggest-default-save
  1680.  
  1681. ------------------------------
  1682.  
  1683. Date: 05 May 1995 07:10:00 GMT
  1684. Subject: ... 7.1 Strategy: Mail & News Folders Are Essentially the Same
  1685.  
  1686. If you save messages in folders that are in mailbox format (which you
  1687. specify with the mail-format variable), you will be able to access
  1688. them with mailers like pine, elm, and Berkeley mail, as well as with
  1689. nn.  You can go one step further and save both mail and news messages
  1690. in the same folders.  For example, everything I want to save about
  1691. nn, whether it was a news or mail message, I save in a folder named
  1692. `nn'.  To make this really easy I use the same directory, called
  1693. `Folders' for both my news and mail folders.  To do this, you need to
  1694. tell your mailer(s) and newsreader(s) that this is the folder
  1695. directory.  In nn specify this by putting the following line in your
  1696. init.host file.
  1697.  
  1698.  set news-folder ~/Folders
  1699.  set mail-folder ~/Folders
  1700.  
  1701. I put this into init.host because this is host-specific information,
  1702. i.e., on another system I may use a different directory structure.
  1703.  
  1704. ------------------------------
  1705.  
  1706. Date: 05 May 1995 07:20:00 GMT
  1707. Subject: ... 7.2 Saving an Individual Article
  1708.  
  1709. To save a single message, type `s' while reading it.  nn will suggest
  1710. the default save folder for the newsgroup you're in.  A plus sign (+)
  1711. at the beginning means your news folder directory (~/News or whatever
  1712. you set with the folder variable).  At the folder prompt you can:
  1713.  
  1714.  Type      In Order To...
  1715.  ======    ==============
  1716.  RET       Save in the suggested folder
  1717.  <text>    Edit the suggested folder name
  1718.  ^U        Delete suggested folder and be prompted with last-used 
  1719.            save folder
  1720.  ^U ^U     Delete suggested folders so you can type a folder name
  1721.  
  1722.  
  1723. NOTE: ^U is not an nn command; it is the usual Unix command to "kill"
  1724. a line.  To find out your Unix "kill" command type `stty -a' at your
  1725. Unix prompt.
  1726.  
  1727. After you save the article, the status bar at the bottom of the
  1728. message will say `(Filed)' so you'll know that it's been saved.
  1729.  
  1730. ------------------------------
  1731.  
  1732. Date: 05 May 1995 07:21:00 GMT
  1733. Subject: ... ... 7.2.1 Saving an Article That's in Digest Format
  1734.  
  1735. If you save an entire article that's in digest format by using the
  1736. `s' command, you won't be able to split it after it's in its save
  1737. folder.  This is because the internal message headers are escaped
  1738. (usually with a tilde (~)).  The trick for saving a digest so that it
  1739. is split in the save folder is to do the following while reading the
  1740. unsplit digest.
  1741.  
  1742.   Type
  1743.   ====
  1744.   s
  1745.   ^U ^U
  1746.   |cat > +FolderName
  1747.  
  1748. With this command, the internal headers won't be escaped, and each
  1749. sub-message will be presented as an individual message when you view
  1750. it with a folder reader like nn, pine, or elm.
  1751.  
  1752. ------------------------------
  1753.  
  1754. Date: 05 May 1995 07:30:00 GMT
  1755. Subject: ... 7.3 Saving a Group of Articles
  1756.  
  1757. To save a collection of messages, select them on the menu and then,
  1758. while in menu mode, type capital `S'.  You will be prompted for which
  1759. articles you want to save:
  1760.  
  1761.   Type   In order to save...
  1762.   ====   ===================
  1763.   +      All selected articles on the current page
  1764.   *      All selected articles
  1765.  
  1766. The save folder is specified the same way as it is for saving a
  1767. single article.
  1768.  
  1769. ------------------------------
  1770.  
  1771. Date: 05 May 1995 07:40:00 GMT
  1772. Subject: ... 7.4 Folder Management
  1773.  
  1774. You can use nn to read and organize both your mail and news folders.
  1775.  
  1776. ------------------------------
  1777.  
  1778. Date: 05 May 1995 07:41:00 GMT
  1779. Subject: ... ... 7.4.1 Reading a Folder
  1780.  
  1781. You can open a folder either from within nn or from the Unix prompt.
  1782. To begin, type one of the following:
  1783.  
  1784.   Prompt          Type
  1785.   ======          ====
  1786.   <Unix prompt>   nn SPC (but *not* RET)
  1787.   <within NN>     G
  1788.  
  1789. Followed by:
  1790.  
  1791.   Type                       To open folder in...
  1792.   ====                       ====================
  1793.   +FolderName                your folder directory
  1794.   +relative/path/FolderName  directory under your folder directory
  1795.   ~/FolderName               your home directory
  1796.   ~/relative/path/FolderName directory under your home directory
  1797.   FolderName                 current directory
  1798.   relative/path/FolderName   directory under current directory
  1799.   /full/path/FolderName      specified full path
  1800.  
  1801.  
  1802. For example, I use the following to read the inet-marketing mailing
  1803. list:
  1804.  
  1805.   nn +inet-marketing
  1806.  
  1807. You can also use your mailer to read your news folders (as long as
  1808. nn's mail-format variable is set).  Here are some mailer commands for
  1809. opening up a folder.
  1810.  
  1811.   pine -if FolderName
  1812.   elm -f =FolderName
  1813.   mail -f FolderName
  1814.  
  1815. NOTE: These mailer commands work if `FolderName' is in the default
  1816. folder directory for the mailer.
  1817.  
  1818. ------------------------------
  1819.  
  1820. Date: 05 May 1995 07:42:00 GMT
  1821. Subject: ... ... 7.4.2 Moving and Deleting Messages in a Folder
  1822.  
  1823. While you are reading a folder, most nn commands work the same as
  1824. when you are reading a newsgroup.  The following commands work a
  1825. little differently.
  1826.  
  1827.   Type     In order to...
  1828.   ====     ==============
  1829.   C        Delete a message from the folder
  1830.   s or S   Save message(s) to a different folder; you will be asked where
  1831.  
  1832. When you leave a folder you will be asked if you really want to
  1833. delete any messages that you deleted with C, or saved with S or s.
  1834.  
  1835. WARNING: Since nn does not use lock files you should not use nn to
  1836. delete messages in a folder which is receiving messages (e.g., via a
  1837. mail processor like procmail, mailagent, deliver, or filter).
  1838.  
  1839. ------------------------------
  1840.  
  1841. Date: 05 May 1995 07:43:00 GMT
  1842. Subject: ... ... 7.4.3 Linking Your Mail and News Directories
  1843.  
  1844. If you use lots of mailers and newsreaders, rather than set each of
  1845. them up to use ~/Folders as the default folder directory, it's much
  1846. easier to link (with the Unix `ln' command) your Folders directory to
  1847. directories named News, Mail, and mail, which are the most commonly
  1848. used folder directory names.  This way almost all your mailers or
  1849. newsreaders will use the same directory for saves.  A link is
  1850. basically just a way to create an alias for a directory or file.
  1851.  
  1852. Before you can set up the directory links you need to put all your
  1853. folders into one directory.  Here are instructions for merging the
  1854. folders in directories named `mail' and `News' into a new directory
  1855. named `Folders'.  If your mail folders are in a different directory,
  1856. e.g., `Mail', replace `mail' with `Mail' below.
  1857.  
  1858. Type                              In order to...
  1859. ====                              ==============
  1860. cd                                go to your home directory
  1861. mkdir Folders                     create Folders directory
  1862. cp mail/* Folders                 copy folders in mail dir to Folders dir
  1863. cp -i News/* Folders              copy folders in News dir to Folders dir;
  1864.                                   answer no about overwriting, note dupe names
  1865. cp News/DupeName Folders/NewName  copy and rename dupe names
  1866. ls -l Folders                     list folders in Folders dir
  1867. ls -l mail                        list folders in mail dir
  1868. ls -l News                        list folders in News dir
  1869.                                   check that all mail and News folders are
  1870.                                   now in Folders dir
  1871. rm mail/*                         delete folders in mail dir
  1872. rmdir mail                        delete mail dir
  1873. rm News/*                         delete folders in News dir
  1874. rmdir News                        delete News dir
  1875.  
  1876. If you have folders in other directories, such as `Mail', move those
  1877. folders to your Folders directory and delete your `Mail' directory.
  1878. Once you've got all your folders in your Folders directory you can
  1879. create links (aliases) for the Folders directory named mail, Mail,
  1880. and News.
  1881.  
  1882. Type                              In order to...
  1883. ====                              ==============
  1884. ln -s Folders mail                link Folders dir to mail
  1885. ln -s Folders Mail                link Folders dir to Mail
  1886. ln -s Folders News                link Folders dir to News
  1887.  
  1888. ------------------------------
  1889.  
  1890. Date: 05 May 1995 08:00:00 GMT
  1891. Subject: 8.0 Posting
  1892.  
  1893. Once you've spent some time reading news, and possibly responding to
  1894. articles through mail, you're ready to enter the wild and wonderful
  1895. (and sometimes cruel) world of publicly participating in news
  1896. discussions.
  1897.  
  1898. ------------------------------
  1899.  
  1900. Date: 05 May 1995 08:10:00 GMT
  1901. Subject: ... 8.1 Netiquette
  1902.  
  1903. There are many good sources of information about Net etiquette,
  1904. including these articles, which are regularly posted to
  1905. news.announce.newusers and news.answers:
  1906.  
  1907.  * Emily Postnews Answers Your Questions on Netiquette
  1908.  * Hints on writing style for Usenet
  1909.  * How to find the right place to post (FAQ)
  1910.  * A Primer on How to Work With the Usenet Community
  1911.  * Rules for posting to Usenet
  1912.  
  1913. These and other news.announce.newusers articles are archived in all
  1914. the usual FAQ archives including:
  1915.  
  1916. http://www.cis.ohio-state.edu/hypertext/faq/bngusenet/news/announce/newusers/top.html
  1917.  
  1918. ftp://rtfm.mit.edu/pub/usenet-by-group/news.announce.newusers
  1919.  
  1920. ------------------------------
  1921.  
  1922. Date: 05 May 1995 08:11:00 GMT
  1923. Subject: ... ... 8.1.1 First Read the FAQs
  1924.  
  1925. Before you post an article to a newsgroup you should read the
  1926. newsgroup to get a sense of the type of discussion that is
  1927. appropriate for that group.  And, most importantly, you should read
  1928. the periodic postings and frequently asked questions (FAQs) of the
  1929. group.  There are lots of different ways to find these, including:
  1930.  
  1931. *  While in the newsgroup use nn's Gs command to search subjects for
  1932.    one of these words: faq, frequent, period, regular, weekly, part
  1933.    <the newsgroup name>, <topic of the newsgroup>
  1934.  
  1935. *  If that doesn't work, and if you are using nn 6.5 or higher, use
  1936.    the GB command to search the full text of articles in the
  1937.    newsgroup for:
  1938.  
  1939.      Archive-name:
  1940.  
  1941.    This should find any FAQ that is archived on the rtfm.mit.edu FAQ
  1942.    server, because the first line of an "official" FAQ must contain 
  1943.    a line that starts with this.
  1944.  
  1945.  
  1946. Since news articles expire, the FAQ may not currently be on your
  1947. host.  If neither of the above turn up the FAQ you can look at these
  1948. places:
  1949.  
  1950. Web:
  1951.   http://www.cis.ohio-state.edu/hypertext/faq/usenet/top.html
  1952.  
  1953. Anonymous FTP:
  1954.   ftp://rtfm.mit.edu/pub/usenet-by-group
  1955.   ftp://rtfm.mit.edu/pub/usenet/news.answers
  1956.  
  1957. Email:
  1958.   Send mail to mail-server@rtfm.mit.edu containing the following:
  1959.       send usenet/newsgroup.name/index
  1960.  
  1961.   Where "newsgroup.name" is replaced with the newsgroup you're
  1962.   interested in.  You will get an automated reply that includes a
  1963.   list of the FAQs for that newsgroup.  Once you know the name of the
  1964.   FAQ, send another message and replace "index" with the name of the
  1965.   relevant file.
  1966.  
  1967. ------------------------------
  1968.  
  1969. Date: 05 May 1995 08:12:00 GMT
  1970. Subject: ... ... 8.1.2 Some DOs and DON'Ts
  1971.  
  1972. In addition to suggestions given in the articles, such as "Emily
  1973. Postnews," mentioned in section 8.1 above, here are a few things I'd
  1974. like to emphasize.
  1975.  
  1976. DOs
  1977. ===
  1978. :>  Say what you've done to try to find the answer to your question.
  1979.     For example, say you've read the FAQ (if you have) or if (and
  1980.     only if) you tried to find it but couldn't, ask for a pointer to
  1981.     it.
  1982.  
  1983. :>  If you set the Followup-To header to be something other than the
  1984.     newsgroups you are posting to, say you've done this in your
  1985.     article so people will know where to go to follow the discussion.
  1986.  
  1987. :>  If you notice somthing is getting asked frequently, package the  
  1988.     question and answer, if you can, and send it to the FAQ
  1989.     maintainer.  [Thanks to Bill Wohler for this DO.]
  1990.  
  1991.  
  1992. DON'Ts
  1993. ======
  1994. :<  Do not post a response before you have read the entire thread.  This 
  1995.     way you won't post the same thing that someone else already posted.
  1996.  
  1997. :<  Do not ask people to only mail you a response.  There *will* be
  1998.     other people who are interested in the responses.  Also, if
  1999.     responses are posted, people can see that your question has been
  2000.     answered and know that they don't need to take the time to write
  2001.     you a response.
  2002.  
  2003. :<  Do not include a signature longer than four lines.
  2004.  
  2005. :<  Do not use a meaningless subject like "Help".
  2006.  
  2007. :<  Do not include the whole article you are responding to.  Rather,
  2008.     you should include only the bare minimum.
  2009.  
  2010. :<  Do not overuse smileys (like I've just done).
  2011.  
  2012. ------------------------------
  2013.  
  2014. Date: 05 May 1995 08:20:00 GMT
  2015. Subject: ... 8.2 Your First Posts Should Be Test Posts
  2016.  
  2017. To make sure that posting is working on your system, it's a good idea
  2018. to post a couple test articles.  Even if you have experience posting
  2019. with another newsreader or on another system, it's still a good idea
  2020. to post a couple test messages.  This way, if posting isn't working,
  2021. you won't have wasted much time on an unsuccessful post.
  2022.  
  2023. With a test posting you can test whether:
  2024. 1. Your editor is set correctly.
  2025. 2. Your news-record variable is set. This is the folder where a copy of
  2026.    each article you post is saved.
  2027. 3. Your signature is appended to your posts.
  2028. 4. Your headers are the way you want them to be. These can be modified
  2029.    with the news-header variable.
  2030. 5. Your article is posted on your system.
  2031. 6. Your article is distributed outside your system.
  2032.  
  2033. For the first five types of tests, a local test newsgroup and `local'
  2034. distribution is sufficient for testing.  For testing that your
  2035. article is distributed outside your system you'll want to use a
  2036. world-wide newsgroup with world distribution (i.e., use *no*
  2037. Distribution header).
  2038.  
  2039. ------------------------------
  2040.  
  2041. Date: 05 May 1995 08:21:00 GMT
  2042. Subject: ... ... 8.2.1 Newsgroups for Testing
  2043.  
  2044. There are lots of newsgroups that are specifically for posting test
  2045. articles.  If you need to test world-wide distribution then you can
  2046. use misc.test or alt.test.  A lot of sites have set up these
  2047. newsgroups so that they will send automated reply that tells you they
  2048. received your message.  If you don't want to receive those automated
  2049. replies, then you can put the word `ignore' in the article's
  2050. Subject.
  2051.  
  2052. If you only need local distribution for your test then it's best to
  2053. use a test newsgroup that is specific to your host.  This way you
  2054. will (hopefully) save the Net from distributing some bytes.  Usually
  2055. this type of newsgroup is named host.test.  For example, hosts that I
  2056. used have these test groups: halcyon.test, best.test, texasnet.test,
  2057. and realtime.test.
  2058.  
  2059. ------------------------------
  2060.  
  2061. Date: 05 May 1995 08:22:00 GMT
  2062. Subject: ... ... 8.2.2 Test 1: Following Up to an Article
  2063.  
  2064. If you want to publicly respond to a news article, then you post
  2065. what's called a "followup" article.  Here's how to do a test followup
  2066. post in the misc.test newsgroup.  If you don't need to do a world-wide
  2067. test, replace misc.test with your host's test newsgroup, usually named
  2068. `host.test'.
  2069.  
  2070. Prompt                           Type      In Order To...
  2071. ======                           ====      ==============
  2072. <within nn>                      G         Use the Go command
  2073. Group or Folder (+./~ %=sneNbB)  misc.test Specify the misc.test group
  2074. Number of articles (juasne) (j)  RET       Jump to the group
  2075. <menu mode>                      a         Select article a
  2076. <menu mode>                      Z         Go into reading mode
  2077. <reading article a>              f         Followup
  2078. Include original article?        y (or n)  Include (or don't include) the 
  2079.                                            article
  2080. <your editor>                    <text>    (There must be a completely
  2081.                                            blank line between the headers 
  2082.                                            and body.)
  2083.                                  <exit ed>
  2084.  
  2085.  
  2086. You'll then see this prompt:
  2087.   a)bort c)c e)dit h)old m)ail r)eedit p)ost v)iew w)rite
  2088.   Action: (post article)
  2089.  
  2090. If this were a real followup rather than a test, you might want to
  2091. send a "carbon copy" or "courtesy copy" to the person you are
  2092. responding to by using the `c' command.  To just post the article
  2093. press the RET key.
  2094.  
  2095. If everything is working, you'll see these two lines:
  2096.  
  2097.   Be patient! Your new article will not show up immediately.
  2098.   Article posted
  2099.  
  2100. ------------------------------
  2101.  
  2102. Date: 05 May 1995 08:23:00 GMT
  2103. Subject: ... ... 8.2.3 Test 2: Starting a Thread
  2104.  
  2105. You can start a thread by using either `nnpost' at your Unix prompt
  2106. or by using `:post' from within nn.  With `:post' you can avoid
  2107. typing the name of the newsgroup your posting to by first going to
  2108. the group.  Here are instructions for starting a test thread in
  2109. misc.test.  As before, you should replace misc.test with host.test,
  2110. if you don't need to test world-wide distribution.
  2111.  
  2112.  Prompt                           Type      In Order To...
  2113.  ======                           ====      ==============
  2114.  <within nn>                      G         Use the Go command
  2115.  Group or Folder (+./~ %=sneNbB)  misc.test Specify the misc.test group
  2116.  Number of articles (juasne) (j)  RET       Jump to the group
  2117.  <misc.test menu or reading mode> :post     Start a thread
  2118.  POST to group                    RET       Specify current group
  2119.  Subject:                         <text>    Specify subject (*)
  2120.  Keywords:                        RET       Give no keywords
  2121.  Summary:                         RET       Give no summary
  2122.  Distribution: (default 'world')  RET       Use world distribution (**)
  2123.  <in your editor>                 <text>    (There must be a blank line
  2124.                                             between the headers and body.)
  2125.                                   <exit ed>
  2126.  Action: (post article)           RET       Post your article
  2127.  
  2128. If everything is working, you'll see these two lines:
  2129.  
  2130. Be patient! Your new article will not show up immediately.
  2131. Article posted
  2132.  
  2133.  
  2134. (*)  The subject can't be left blank so you can *not* just press
  2135.      RET at this prompt.  If you include the word `ignore' in
  2136.      the subject you won't get as many auto-responses.
  2137.  
  2138. (**) Or you can type `local' to specify a local distribution but be
  2139.      aware that the Distribution header is often ignored so articles
  2140.      often get world-wide distribution no matter what you put in the
  2141.      Distribution header.
  2142.  
  2143. ------------------------------
  2144.  
  2145. Date: 05 May 1995 08:24:00 GMT
  2146. Subject: ... ... 8.2.4 Test 3: Replying to an Article in Mail
  2147.  
  2148. Often you will want to reply to an article with only a private mail
  2149. message, rather than a public news article.  To test doing a reply
  2150. through mail choose an article that *you* posted and then your test
  2151. reply will go to you.
  2152.  
  2153. Prompt                           Type      In Order To...
  2154. ======                           ====      ==============
  2155. <reading article you posted>     r         Reply in mail
  2156. Include original article?        y (or n)  Include (or don't include) the 
  2157.                                            article
  2158. <your editor>                    <text>    (There must be a completely
  2159.                                            blank line between the headers 
  2160.                                            and body.)
  2161.                                  <exit ed>
  2162.  
  2163.  
  2164. You'll then see this prompt:
  2165.   a)bort e)dit h)old m)ail r)eedit s)end v)iew w)rite
  2166.   Action: (send letter)
  2167.  
  2168. To send the message press RET.
  2169.  
  2170. ------------------------------
  2171.  
  2172. Date: 05 May 1995 08:25:00 GMT
  2173. Subject: ... ... 8.2.5 Test 4: Canceling an Article
  2174.  
  2175. It's a good idea to test out canceling right now, before you really
  2176. want to be able to cancel (and possibly find out you can't cancel!).
  2177.  
  2178. To cancel one of your test messages just type `C' while reading it.
  2179. After about 30 minutes, go back to the newsgroup and list all
  2180. messages that were posted by you by using `G n YourFullName'.  The
  2181. message you canceled should be gone.
  2182.  
  2183. ------------------------------
  2184.  
  2185. Date: 05 May 1995 08:30:00 GMT
  2186. Subject: ... 8.3 Responding to a Message
  2187.  
  2188. A good way to get your feet wet is to join in a discussion that is
  2189. already going on.  That way it's more likely that people will respond
  2190. to your article and then, when they do, you'll feel like you're
  2191. really participating in Net news.
  2192.  
  2193. ------------------------------
  2194.  
  2195. Date: 05 May 1995 08:31:00 GMT
  2196. Subject: ... ... 8.3.1 Strategy: Flag it, Continue Reading, Then Respond
  2197.  
  2198. If there's an article you want to respond to, here's a strategy
  2199. you can use to read other articles on the subject before you post your
  2200. response.
  2201.  
  2202. 1. Leave the article by typing `l' (the letter el).
  2203.  
  2204. 2. Read all articles with that subject.
  2205.  
  2206. 3. Read other articles in the newsgroup with related subjects.
  2207.  
  2208. 4. When you are finished with that newsgroup you will be asked
  2209.    whether you want to view the "left over articles."  If you want to
  2210.    respond now, type `y'.  If you answer `n' the article will be
  2211.    flagged with plus (+) or equals (=) and kept for the next
  2212.    session.
  2213.  
  2214. 5. When you are ready to respond, type `f' to followup in news or
  2215.    type `r' to reply in mail.  
  2216.  
  2217. ------------------------------
  2218.  
  2219. Date: 05 May 1995 08:32:00 GMT
  2220. Subject: ... ... 8.3.2 To Mail or Post Your Response?
  2221.  
  2222. MAIL
  2223. ====
  2224. If your response is personal and/or only appropriate for the person
  2225. you are responding to, then mail your response.
  2226.  
  2227. POST
  2228. ====
  2229. If your response will be interesting to others or includes a question
  2230. that others might be able to answer, post it.  
  2231.  
  2232. POST AND MAIL
  2233. =============
  2234. In addition to posting your response, you may want to also mail a
  2235. copy to the person you are responding to.  You can do this by using
  2236. the c)c or m)ail command at the final posting prompt.
  2237.  
  2238.  
  2239. WARNING
  2240. =======
  2241. Be aware that people who read your private mailed response will not
  2242. be able to tell whether you both posted and mailed your response or
  2243. just mailed it.  If you only mailed your response and you do not want
  2244. them to respond publicly then you should include a note that says
  2245. something like:
  2246.  
  2247.    This message has only been mailed; it has not been posted.
  2248.    Please do not post this private message, or an excerpt of
  2249.    it, to a newsgroup.
  2250.  
  2251. This is especially a problem if the person who receives your mailed
  2252. response uses pine.  If the person wants to respond to your response,
  2253. pine will ask whether their response to your response should also be
  2254. posted to the newsgroup.  [A future version of pine will make it more
  2255. clear to users that they might be posting a private mail message.]
  2256.  
  2257. ------------------------------
  2258.  
  2259. Date: 05 May 1995 08:33:00 GMT
  2260. Subject: ... ... 8.3.3 Included Text
  2261.  
  2262. When you post a followup it is often useful to include *some* of the
  2263. article you are following up to.  To include the article, answer `y'
  2264. to the `Include original article?' prompt.  After you are in your
  2265. editor, delete all the lines that are not specifically relevant to
  2266. your response.  For example, you should always delete any signatures
  2267. (unless of course you're discussing a sig!).  Here are commands for
  2268. deleting a line in some editors.
  2269.  
  2270.   Editor     To Delete a Line
  2271.   ======     ================
  2272.   vi         ESC dd
  2273.   pico       ^K
  2274.   emacs      ^K
  2275.  
  2276. With all these editors there are more efficient ways to delete lots
  2277. of text, but these commands should get you started.
  2278.  
  2279. ------------------------------
  2280.  
  2281. Date: 05 May 1995 08:34:00 GMT
  2282. Subject: ... ... 8.3.4 Headers
  2283.  
  2284. News and mail messages consist of headers, a completely blank line,
  2285. and the body.  For a followup message you usually won't need to edit
  2286. the headers at all.  When you start a thread, usually the only
  2287. headers you'll need to think about are the Newsgroups and Subject
  2288. headers.  Sometimes you may want to edit other headers.  The next
  2289. sections describe the Newsgroups, Followup-To, Subject, and
  2290. References headers.
  2291.  
  2292. For some general information about headers, see the "Customized
  2293. Headers" section of the "Signature, Finger, and Customized Headers
  2294. FAQ" which is regularly posted to news.software.nn and archived in
  2295. all the usual FAQ archives including:
  2296.  
  2297. http://www.cis.ohio-state.edu/hypertext/faq/usenet/signature_finger_faq/faq.html
  2298. ftp://rtfm.mit.edu/pub/usenet/news.answers/signature_finger_faq
  2299.  
  2300. ------------------------------
  2301.  
  2302. Date: 05 May 1995 08:34:10 GMT
  2303. Subject: ... ... ..... 8.3.4.1 Newsgroups and Followup-To Headers
  2304.  
  2305. When you are composing an article, always look at the Newsgroups
  2306. header to see what newsgroups your response will go to.  Sometimes a
  2307. poster will direct followup articles to newsgroups other than the one
  2308. you are reading.  You can edit the header lines with your editor.  If
  2309. you list more than one newsgroup then they must be comma separated
  2310. without any spaces.  For example, this article includes these
  2311. headers:
  2312.  
  2313.  Newsgroups: news.software.nn,news.software.readers,news.newusers.questions
  2314.  Followup-To: news.software.nn
  2315.  
  2316. If you followup to this article by using the `f' command your
  2317. followup article will include this header:
  2318.  
  2319.  Newsgroups: news.software.nn
  2320.  
  2321. ------------------------------
  2322.  
  2323. Date: 05 May 1995 08:34:20 GMT
  2324. Subject: ... ... ..... 8.3.4.2 Subject and References Headers
  2325.  
  2326. When you respond to a message do not change the headers unless you
  2327. know what you're doing.  Threaded newsreaders, like trn, tin, and
  2328. netscape, use the References header to track threads.  Unthreaded
  2329. newsreaders, like rn, nn, and pine use the Subject header to simulate
  2330. thread tracking.  If you change either of these headers you will mess
  2331. up the tracking abilities of some newsreaders.
  2332.  
  2333. ------------------------------
  2334.  
  2335. Date: 05 May 1995 08:40:00 GMT
  2336. Subject: ... 8.4 Starting a Thread
  2337.  
  2338. After you've had some experience reading news and participating in
  2339. conversations that someone else started you're ready to start you're
  2340. own thread.  For instructions on starting a thread, see section 8.2.3
  2341. on "Test 2: Starting a Thread."
  2342.  
  2343. BE FOREWARNED
  2344. Sometimes you think you've got a great topic that will lead to
  2345. fascinating discussion, but then you get absolutely no response.  Be
  2346. aware that this happens to everyone and it's really impossible to
  2347. tell what will turn into a great thread and what will fizzle into
  2348. nothingness.
  2349.  
  2350. TRICK
  2351. To really get a thread going, post some wrong information in a
  2352. seemingly innocent way.  (I'm not really advocating this, but it's a
  2353. good trick to know about!)
  2354.  
  2355. ------------------------------
  2356.  
  2357. Date: 05 May 1995 08:50:00 GMT
  2358. Subject: ... 8.5 Your Signature
  2359.  
  2360. Detailed instructions for creating and automatically appending a
  2361. signature file to your news articles and mail messages are given in
  2362. the "Signature, Finger, and Customized Headers" FAQ which is regularly
  2363. posted to news.software.nn and is archived in all the usual FAQ
  2364. archives including:
  2365.  
  2366. http://www.cis.ohio-state.edu/hypertext/faq/usenet/signature_finger_faq/faq.html
  2367. ftp://rtfm.mit.edu/pub/usenet/news.answers/signature_finger_faq
  2368.  
  2369. ------------------------------
  2370.  
  2371. Date: 05 May 1995 08:60:00 GMT
  2372. Subject: ... 8.6 Canceling an Article You Posted
  2373.  
  2374. To cancel an article you posted, go to it and then, while reading it,
  2375. type `C'.  Here are some reasons that you might want to cancel an
  2376. article:
  2377.  
  2378. * Something you advertised in a forsale newsgroup has sold and you're
  2379.   still receiving inquiries about it.  
  2380.  
  2381. * You posted incorrect information and you want to prevent people
  2382.   from problems this information would cause.
  2383.  
  2384. * You posted incomplete information and rather than posting an
  2385.   addendum to your first article, you'd like to repost the entire 
  2386.   article, including the additional information.
  2387.  
  2388.  
  2389. Unfortunately, canceling an article doesn't obliterate all traces of
  2390. it from the Net.  After you post your article and before you cancel
  2391. it, people will read it, save it, and possibly respond to it and
  2392. include your article.  Also, even after you cancel it, there will be
  2393. sites that don't get, or don't honor, your cancel message.
  2394.  
  2395. ------------------------------
  2396.  
  2397. Date: 05 May 1995 09:00:00 GMT
  2398. Subject: 9.0 Glossary
  2399.  
  2400. ~ or $HOME or home directory
  2401.  The Unix directory that you are in when you first log on to your
  2402.  account.  You can always get home by typing `cd'.
  2403.  
  2404. .newsrc            
  2405.  A file in your home directory that keeps track of which newsgroups
  2406.  you're subscribed to and what articles you've read.
  2407.  
  2408. article or message
  2409.  One item that is posted to a newsgroup or mailed to an email
  2410.  address.  Often the word "article" is used for news postings and
  2411.  "message" is used for email.
  2412.  
  2413. bang
  2414.  "Exclamation mark" or `!'.  In Unix an exclamation mark can be used
  2415.  to go out to your shell and run a program while you are in the midst
  2416.  of running another program.  For more info, see "shell out."
  2417.  
  2418. BBS
  2419.  A bulletin board system (or service) is similar to news in that
  2420.  a group of people publicly discuss things.  A difference between
  2421.  a BBS and Net news is that a BBS is usually centralized and all
  2422.  the articles are stored on one machine.  Net news is decentralized
  2423.  and news articles are replicated on thousands of news machines around
  2424.  the world.
  2425.  
  2426. browser
  2427.  A Web browser.
  2428.  
  2429. Clarinet news
  2430.  UPI and Reuters news that is distributed and stored in the same way
  2431.  that Usenet news is.  Clarinet news costs money so not all Internet
  2432.  providers receive it.
  2433.  
  2434. desktop computer
  2435.  The machine you are physically working on.  If this machine is not
  2436.  "on the Internet" (see definition) then it needs to use communication
  2437.  software to connect to a machine on the Internet.
  2438.  
  2439. expire
  2440.  Since there is such a high volume of news on the Net, each
  2441.  article can only be made available for a short amount of time.
  2442.  Different Internet hosts have different rates of expiration --
  2443.  usually from 2 to 15 days.
  2444.  
  2445. flame
  2446.  To verbally attack a person, rather than a person's ideas.  
  2447.  
  2448. flame war
  2449.  A group of people verbally attacking each other. 
  2450.  
  2451. followup
  2452.  To "followup" to a news article means to respond by posting an
  2453.  article to the newsgroup.
  2454.  
  2455. FQDN 
  2456.  Fully qualified domain name.
  2457.  
  2458. GUI
  2459.  Graphical User Interface such as Macintosh, Microsoft Windows, or X
  2460.  Windows, and OS/2.  Pronounced like the word "gooey."
  2461.  
  2462. HTML
  2463.  HyperText Markup Language is the markup language used to create Web
  2464.  pages.
  2465.  
  2466. HTTP
  2467.  HyperText Transfer Protocol is the protocol used to transfer the bits
  2468.  (0's and 1's) that comprise Web pages.
  2469.  
  2470. IMAP
  2471.  Internet Message Access Protocol is a protocol for accessing messages
  2472.  on your Internet host.  With IMAP, you can choose whether to leave 
  2473.  messages on your host or transfer them to your desktop computer.
  2474.  
  2475. init file
  2476.  A file in your .nn directory that's used to establish variable
  2477.  settings, macros, and other things.
  2478.  
  2479. kill
  2480.  To "kill" a subject (or author) means to mark all articles with that
  2481.  subject (or by that author) read.
  2482.  
  2483. kill/select file
  2484.  A file (~/.nn/kill) that keeps track of what subjects and authors
  2485.  you want to automatically kill or select.
  2486.  
  2487. local and remote host 
  2488.  These two terms are relative.  When you connect from one Internet
  2489.  machine to another, the one you start at is the "local host" and the
  2490.  one you connect to from the local host is the "remote host."
  2491.  
  2492. mailer or mail user agent or MUA
  2493.  Software that allows you to read and respond to mail.  Examples are
  2494.  pine, elm, Berkeley mail, Pegasus Mail, and Eudora.
  2495.  
  2496. mail transport agent or MTA 
  2497.  Software that transports mail messages.  Examples are sendmail or
  2498.  smail.
  2499.  
  2500. menu mode or selection mode
  2501.  In nn, this is when the list of authors and subjects of articles in
  2502.  a newsgroup are displayed.  You choose the articles you're
  2503.  interested in by typing their IDs.
  2504.  
  2505. moderated newsgroup
  2506.  A newsgroup that has a moderator, i.e., someone who looks at each
  2507.  article before it gets posted and decides whether it is appropriate.  
  2508.  Examples are comp.viruses and bit.listserv.nettrain.
  2509.  
  2510. The Net
  2511.  The Internet. 
  2512.  
  2513. Net news or Internet news
  2514.  All the thousands of newsgroups and articles that are distributed
  2515.  through the Internet.  This includes Usenet and Clarinet news.
  2516.  
  2517. news reader
  2518.  Software that can be used to read Net news.  Examples are nn, tin,
  2519.  trn, pine, Netscape, Free Agent, and News Express.
  2520.  
  2521. newsgroup or group
  2522.  A discussion area in Net news.  For example, rec.arts.movies is
  2523.  a newsgroup for discussion of movies.
  2524.  
  2525. nn
  2526.  A news reader that displays articles in a menu and lets you choose
  2527.  which ones you want to read.  After you have read the articles you
  2528.  want to read, it marks all the articles in that newsgroup as read,
  2529.  so you won't see them the next time you read that newsgroup.  nn
  2530.  stands for "no news" because the default is to not see any old
  2531.  news.  FYI, you can view old news by typing `G a'.
  2532.  
  2533. on the Internet
  2534.  A machine that is "on the Internet" has an IP (Internet Protocol)
  2535.  address, and can directly participate in the Internet.  For example,
  2536.  it may be able to receive mail and news, and connect to other
  2537.  Internet machines using ftp and telnet.  If you have a personal
  2538.  interactive account, then your machine is not "on the Internet" --
  2539.  it uses your local host to access the Net.
  2540.  
  2541. PGP
  2542.  Pretty Good Protection is used to authenticate messages that are
  2543.  mailed or posted.
  2544.  
  2545. pico
  2546.  A user-friendly editor that is the default PIne COmposer.  It can also
  2547.  be used from the Unix prompt, with nn, and in other Unix
  2548.  applications.
  2549.  
  2550. pine
  2551.  A user-friendly mailer and news reader that displays messages in a
  2552.  menu and lets you use the arrow keys to move around the menu.
  2553.  
  2554. pipe
  2555.  The `|' (which is often above the backslash (\) on keyboards).  In
  2556.  Unix, and some other operating systems, the pipe is used when you
  2557.  want the output of one command to be the input of another command.
  2558.  For example `ls -CF |less' means use the ouptut of the `ls -CF'
  2559.  command as the input of the `less' command.
  2560.  
  2561. POP
  2562.  Post Office Protocol is a protocol for transferring mail messages
  2563.  from your host computer to your desktop computer.
  2564.  
  2565. protocol
  2566.  A set of rules for how data bits (0's and 1's) are packaged and
  2567.  transferred.
  2568.  
  2569. read article
  2570.  In nn, an article is "read" if you viewed its contents or it was
  2571.  marked read by nn when you left the newsgroup the last time you were
  2572.  in it.
  2573.  
  2574. regular expression
  2575.  Text that can include "wild cards" (such as .to match any single
  2576.  character); used for searching.
  2577.  
  2578. reply
  2579.  To "reply" to a news article means to respond to the author in mail.
  2580.  
  2581. seen article
  2582.  In nn, an article is "seen" if you saw its author's name and subject
  2583.  displayed on the menu.
  2584.  
  2585. sequence
  2586.  The order in which newsgroups are presented by nn.  This is
  2587.  established in your ~/.nn/seq file or in the sequence section of
  2588.  your init file.
  2589.  
  2590. shell
  2591.  A layer that sits on top of the Unix operating system and allows a
  2592.  human being to communicate with Unix.  A friendly shell presents the
  2593.  user with a menu.  Two common (less friendly) shells are the Bourne
  2594.  shell (which usually has a $ prompt) and the C shell (which usually
  2595.  has a % prompt).
  2596.  
  2597. shell out
  2598.  To "shell out" of a program means to temporarily leave the program by
  2599.  typing `!'.  You return to the program that you shelled out of by
  2600.  typing `exit.'  For example, you might shell out of nn so you can use
  2601.  lynx to look at a Web page someone mentioned in a news article.
  2602.  
  2603. show mode or reading mode
  2604.  In nn, this is when you are reading an article. 
  2605.  
  2606. SLIP/PPP
  2607.  Serial Line Internet Protocol/Point-to-Point Protocol are protocols
  2608.  used to communicate with the Internet over a telephone line.
  2609.  
  2610. text file
  2611.  Unformatted file such as most news articles. 
  2612.  
  2613. thread
  2614.  A collection of articles in a newsgroup that make up a conversation.
  2615.  
  2616. Unix prompt
  2617.  The command line prompt that you get while working on a Unix host.
  2618.  Different shells have different prompts, for example the Bourne shell
  2619.  usually has a $ prompt and the C shell usually has a % prompt.
  2620.  
  2621. URL
  2622.  A Uniform Resource Locator (URL) is an address that can be used by a
  2623.  Web browser.  URLs usually look like this:
  2624.  
  2625.    protocol://host.address/directory/filename.extension
  2626.  
  2627.  Where "protocol" can be http, gopher, ftp, mailto, news, etc.
  2628.  
  2629. Usenet news
  2630.  Most (but not all) of the thousands of newsgroups and articles that
  2631.  are distributed through the Internet.
  2632.  
  2633. UUCP
  2634.  Unix-to-Unix copy. 
  2635.  
  2636. WAIS
  2637.  Wide Area Information Service. 
  2638.  
  2639. ------------------------------
  2640.  
  2641. Date: 05 May 1995 10:00:00 GMT
  2642. Subject: 10.0 Contributors
  2643.  
  2644. This periodic posting, like most others, is a collaborative effort.
  2645. I learned a lot of the news and nn information from all the helpful
  2646. people in news.newusers.questions, news.software.readers, and
  2647. news.software.nn.  Also, I got a lot of great help from people in
  2648. comp.unix.shell and comp.editors while I was writing the shell
  2649. scripts and vi macros that I use to organize and update this file
  2650. (which is actually many little files!).
  2651.  
  2652. ------------------------------
  2653.  
  2654. Date: 05 May 1995 10:10:00 GMT
  2655. Subject: .... 10.1 Acknowledgements
  2656.  
  2657. Many thanks to Bill Wohler <wohler@newt.com> who meticulously read,
  2658. commented, and constructively criticized an early draft of this.
  2659. Also, thanks to Bill for being a role model for me both as an FAQ
  2660. maintainer and as a supporter of free information on and off the
  2661. Internet.
  2662.  
  2663. Thanks to all the nn enthusiasts in news.software.nn, especially Milt
  2664. Epstein <epstein@napcc-hp.cvm.uiuc.edu> and Sven Guckes
  2665. <guckes@inf.fu-berlin.de> who have posted and/or mailed me lots of
  2666. good tips over the years.  And thanks to my brother, Tom McGough, who
  2667. performed the tedious task of counting the nn variables!
  2668.  
  2669. I wrote most of this article while I was visiting the great Lone Star
  2670. State of Texas.  Thanks to my friends Matt Kaufmann
  2671. <kaufmann@cli.com>, Holly Bell <hbell@mail.utexas.edu>, and their cat
  2672. Baby Kitty for putting me up in their home and letting me tie up
  2673. their phone line while I was working on this.  Thanks also to
  2674. TexasNet <info@texas.net>, Real/Time Systems <info@bga.com>, and
  2675. Computational Logic, Inc., who all helped me connect to the Net in
  2676. Texas.
  2677.  
  2678. Thanks also to all my regular providers, Best Communications
  2679. <info@best.com>, Northwest Nexus <info@halcyon.com>, Jazzie Systems
  2680. <info@jazzie.com>, who let me use lots of their space to make
  2681. information available on the Net.
  2682.  
  2683. And, as always, I want to give special thanks to Thomas A. Fine
  2684. <fine@cis.ohio-state.edu> for setting up and maintaining the
  2685. hypertext archive of FAQs, which, to me, is one of the greatest
  2686. things on the whole Internet!
  2687.  
  2688. Please let me know if I've left you, or anyone else, out of these
  2689. acknowledgements.
  2690.  
  2691. ------------------------------
  2692.  
  2693. Date: 05 May 1995 10:20:00 GMT
  2694. Subject: .... 10.2 If You'd Like to Contribute
  2695.  
  2696. If you have any corrections, suggestions, or new digest items to
  2697. contribute to this FAQ please send them to faq-editor@ii.com.  If your
  2698. reader understands the following URL, you can use it to send me mail:
  2699.  
  2700.   mailto:faq-editor@ii.com.  
  2701.  
  2702. I'm especially interested in:
  2703.   * History of nn, e.g., it's relationship to TASS
  2704.   * Comparison of newsreaders (any newsreader, including newsreaders
  2705.     for Unix, DOS, MS Windows, X Windows, Macintosh, OS/2, etc.)
  2706.  
  2707. ------------------------------
  2708.  
  2709. Date: 05 May 1995 11:00:00 GMT
  2710. Subject: 11.0 Copyright Notice
  2711.  
  2712. Copyright (c) 1995 by Nancy McGough.
  2713.  
  2714. No portion of this work may be sold or put to commercial use without
  2715. express written consent of the author.  This restriction covers
  2716. publication in any form, or distribution by any method, which permits
  2717. this work to be visually perceived, either directly or with the aid
  2718. of any machine or device.  Permission is granted to republish or
  2719. redistribute this article in its entirety for noncommercial use as
  2720. long as a best effort is made to distribute the most up to date
  2721. version, and this copyright notice is not removed or altered.
  2722.  
  2723. End of Getting Started with News and the NN News Reader
  2724. *******************************************************
  2725.  
  2726. -- 
  2727.  /\_/\                  @..@    Please make sure your host gets the  /\_/\
  2728. ( o.o ) Nancy McGough  (----)   new humanities.* newsgroups. Info   ( o.o )
  2729.  > ^ <  Infinite Ink  ( >__< )  is at http://www.jazzie.com/ii/      > ~ <
  2730.