home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / duucp-1.17 / AU-117b-man.lha / man / DNews < prev    next >
Encoding:
Text File  |  1993-11-13  |  7.5 KB  |  183 lines
  1.  
  2.                                  DNEWS
  3.  
  4.     NOTE: libs:arp.library must be present for the 'w' (write to file)
  5.           command to work.  An arp.library is included in the distribution
  6.           but if you already have arp installed you can ignore it.
  7.  
  8.     DNews is the new news reading program, written by yours truely (Matt
  9.     Dillon).  DNews does not modify or delete any news files, but instead
  10.     keeps track of read articles via a <user>.DNewsRC file... A different
  11.     file for each user.
  12.  
  13.     The format of the .DNewsRC file is as follows:
  14.  
  15.     <enabled> <newsgroup> <read-articles> <marked-articles> <killed-articles>
  16.  
  17.     Only the <read-articles> field is currently implemented, other fields
  18.     are left as a single '-'.  The field consists of one or more comma
  19.     delimited sub fields with optional numeric ranges, in sorted order:
  20.  
  21.     y comp.sys.amiga.tech     0-17,22,24-30 - -
  22.  
  23.     Indicates that articles 1-17, 22, and 24-30 have been read.  The DNews
  24.     program parses and rewrites the .DNewsRC file according to what you
  25.     did while in the program.   DNEWS MAINTAINS THIS FILE FOR YOU.  THE
  26.     USER NORMALLY NEVER EVEN READS THE FILE.
  27.  
  28.     ------------------------------------------------------------------------
  29.                                GETTING STARTED
  30.  
  31.     If a <user>.dnewsrc file does not exist in your UULIB:, DNews will create
  32.     one automatically by scanning UUNEWS: for appropriate newsgroups.  If you
  33.     later decide to add or drop a newsgroup you must edit the <user>.dnewsrc
  34.     file.
  35.  
  36.     On startup, DNews comes up with a small window listings available
  37.     newsgroups and the number of unread messages in each.  You may click
  38.     on a given newsgroup at any time to begin reading that group.  DNews
  39.     will bring up a second window containing the current article being read.
  40.  
  41.     NOTE:  Any window may be moved or resized at any time.  DNews will remember
  42.     the size and placement of all windows and bring them up in the same
  43.     configuration the next time you use DNews.
  44.  
  45.     In the article window keys are defined to move around and do various
  46.     operations on the article (such as paging up and down, right and left,
  47.     moving on to the next article, killing it, following its references,
  48.     etc...).  See The command list at the bottom of the manual page for more
  49.     information.
  50.  
  51.     The 'h' command brings up a help window listing the various commands.
  52.     The most used commands are:
  53.  
  54.      <space>    -page down
  55.         n       -next
  56.         m       -follow references stopping at the end
  57.         M       -follow references going back to the first unread article at the
  58.                  end
  59.         f       -followup to the newsgroup
  60.         r       -reply to the poster
  61.         p       -post new news
  62.  
  63.  
  64.     ------------------------------------------------------------------------
  65.                                 MAJOR FEATURES
  66.  
  67.     Below lists the major features of DNews.  These commands are also indicated
  68.     in the command table at the bottom of this file.
  69.  
  70.     (1) [k/K]illing a train of articles
  71.  
  72.         DNews allows you to kill future articles that reference the current
  73.         article.  The [k]ill command does so for the current session, while
  74.         the [K]ill command does so for 30 days.
  75.  
  76.         The kill command uses the References: field to determine which
  77.         articles to kill.  Any article whos References: field contains the
  78.         Message-ID of the article you killed or the Message-ID of any
  79.         article in the killed article's References: line will be skipped
  80.         automatically (note that explicitly following a reference list with
  81.         the 'm' command does not skip killed articles)
  82.  
  83.         Long-term killed article Message-ID's are stored in the file
  84.         <user>.dnewskl in your UULIB:
  85.  
  86.     (2) [m/M]essage following a train of articles
  87.  
  88.         DNews allows you to follow a particular train of articles related
  89.         to each other.  The [m]essage command searches for an article whos
  90.         References: field contains the Message-ID of the current article or
  91.         a Message-ID matching a Message-ID in the References: line of the
  92.         current article.  [m]essage will find ALL references.
  93.  
  94.         NOTE:   DNews will scan the remaining articles for their Message-ID:
  95.                 and References: lines.  These lines are cached within DNews
  96.                 for efficiency so only the first [m]essage command will be
  97.                 slow.
  98.  
  99.         [M]essage is the same as [m]essage except that [m]essage stops when
  100.         it can no longer find any references while [M]essage rewinds to the
  101.         first UNREAD article (i.e. you continue on to the next topic)
  102.  
  103.     (3) References: support
  104.  
  105.         DNews automatically adds a References: header to any followups you
  106.         make, supporting the referencing system.
  107.  
  108.     (4) MULTI-USER SUPPORT
  109.  
  110.         By setting the USERNAME and REALNAME environment variables multiple
  111.         users on your amiga may independantly read and post news.  Each has
  112.         his own .dnewsrc and .dnewskl file.
  113.  
  114.                                  COMMAND LIST
  115.  
  116.         h   -help
  117.  
  118.         v   -go to first unread article.  That is, continue on with the next
  119.              topic after reaching the end of a [m]essage sequence.  Note that
  120.              [M]essage is equivalent to [v] when there are no more references.
  121.  
  122.         m   -mark article as read and follow references, stopping when no more
  123.              references to the article are found.  Normally you hit this key
  124.              repeatedly to follow articles with a common subject.
  125.  
  126.              The [m]essage command has the ability to pick up a train of
  127.              articles in the middle of a sequence.
  128.  
  129.              NOTE: the 'm' command currently skips articles marked as read.
  130.              Thus, after sequencing through with 'm' trying to do so again
  131.              will not work (because you have read all the articles!).  This
  132.              is a bug.
  133.  
  134.         M   -[m], but instead of stopping at the end of the train it does the
  135.              equivalent of a [v] command.
  136.  
  137.         g   -goto a specific article and mark as unread
  138.  
  139.         n   -mark article as read and go to the next article number
  140.  
  141.         s   -do not mark article as read, go to the next article number
  142.  
  143.         b   -go to previous article and unmark (mark as unread)
  144.  
  145.         k   -kill refs to article for this session
  146.  
  147.         K   -kill refs to article for 30 days
  148.  
  149.         U   -unkill refs to article (removes Message-IDs from kill list)
  150.  
  151.         w   -write article to file
  152.  
  153.         r   -reply to sender of article
  154.  
  155.         R   -reply to sender of article including original article contents
  156.              NOTE:  YOU SHOULD TRIM THE INCLUDED TEXT DOWN TO SIZE JUST SO
  157.              THE SENDER GETS THE JIST OF IT.  HE KNOWS WHAT HE SENT.
  158.  
  159.         f   -followup article to newsgroup (your article references the
  160.              current article)
  161.  
  162.         F   -followup article to newsgroup including the original article's
  163.              contents.
  164.  
  165.              NOTE:  YOU *MUST* TRIM THE INCLUDED TEXT DOWN TO SIZE JUST SO
  166.              PEOPLE GET THE JIST OF WHAT YOU ARE COMMENTING ON.  NET USERS
  167.              HAVE ACCESS TO THE FULL CONTENTS OF THE ARTICLE YOU ARE
  168.              REFERENCING AND DO NOT NEED IT TOLD TO THEM OVER AND OVER.
  169.  
  170.         p   -Post a new article.  You may modify the NewsGroups: line however
  171.              you like, it need not be restricted to the current news group.
  172.  
  173.  
  174.         DISPLAY CURSOR CONTROLS:
  175.  
  176.               8 9           *       page-up     top
  177.             4 o 6       left-half       *       right-half
  178.               2 3           *       page-down   bottom
  179.  
  180.         <space> also pages down for ease of use.
  181.  
  182.  
  183.