home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / OS2 / YRN2_060.ZIP / YARN.DOC < prev    next >
Text File  |  1994-03-31  |  26KB  |  846 lines
  1.  
  2.  
  3. Yarn User Manual - version 0.60                                                
  4.  
  5.  
  6.  
  7.      Yarn - offline news storage and reading system
  8.  
  9.      Copyright (c) 1994 Chin Huang
  10.  
  11.      Permission to copy and distribute this material for any purpose and
  12.      without fee is hereby granted, provided that the above copyright notice
  13.      and this permission notice appear in all copies.  THE AUTHOR MAKES NO
  14.      REPRESENTATIONS ABOUT THE ACCURACY OR SUITABILITY OF THIS MATERIAL FOR ANY
  15.      PURPOSE.  IT IS PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED
  16.      WARRANTIES.  THE AUTHOR WILL ASSUME NO LIABILITY FOR DAMAGES EITHER FROM
  17.      THE DIRECT USE OF THIS PRODUCT OR AS A CONSEQUENCE OF THE USE OF THIS
  18.      PRODUCT.
  19.  
  20.  
  21.                                  INTRODUCTION
  22.  
  23.      Yarn is a suite of programs for your personal computer, used to store and
  24.      read USENET news downloaded from a USENET host.
  25.  
  26. FEATURES
  27.  
  28.      -  An import program inserts USENET articles into a "news base" from
  29.         Simple Offline USENET Packet (SOUP) format.
  30.  
  31.      -  For each newsgroup, you specify the number of days to keep articles,
  32.         after which, an expire program deletes them.  However, articles
  33.         containing an Expires: header are deleted on the date specified in the
  34.         header.
  35.  
  36.      -  The news base stores only one copy of a cross-posted article.  The news
  37.         base implementation stores multiple articles per file.
  38.  
  39.      -  The Yarn news reader presents articles in threads arranged by Message-
  40.         ID and References.  The reader program generates SOUP reply packets.
  41.  
  42.      -  Multiple users are supported by storing separate configuration files
  43.         for each user.
  44.  
  45. SYSTEM REQUIREMENTS
  46.  
  47.      -  MS-DOS 3.0 or higher
  48.  
  49.      -  80386 compatible CPU or better to run the 32-bit DOS extender version
  50.         of the reader program.  A real mode version of the reader is also
  51.         included for non-386 systems.
  52.  
  53.      -  a lot of hard disk storage, depending on how much news you want to
  54.         keep.  For example, the author subscribes to 120 newsgroups including
  55.         some binaries and sources groups, keeping most articles for 7 days.
  56.         The amount of disk space used is 40 megabytes.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                                                               1
  65.  
  66.  
  67.  
  68. Yarn User Manual - version 0.60                                                
  69.  
  70.  
  71.                                  INSTALLATION
  72.  
  73. INSTALL YARN DIRECTORY
  74.  
  75.      Unpack the files from the Yarn package into a directory.  Run the command
  76.  
  77.           install [drive:]directory
  78.  
  79.      where [drive:]directory specifies where to install the Yarn data
  80.      directory.  This directory is created if it doesn't already exist.  Choose
  81.      a disk drive with a lot of free space because the news base will be stored
  82.      here.  This directory will be called the <yarn> directory.
  83.  
  84. SET UP USER DIRECTORY
  85.  
  86.      To set up a user directory where Yarn will store your user information,
  87.      run the command
  88.  
  89.           adduser
  90.  
  91.      The program displays a form in which you fill in the required user
  92.      information.
  93.  
  94.      Home directory
  95.           Specify the directory where Yarn will store your user information.
  96.           This directory is created if it doesn't already exist.  This
  97.           directory will be called the <home> directory.
  98.  
  99.      User ID
  100.           Set this to your login name on the host from which you download and
  101.           upload USENET news.
  102.  
  103.      Host system
  104.           Set this to the full domain name of your host.
  105.  
  106.      User's full name
  107.           Set this to your full name.  This is the name that appears in
  108.           parentheses on the From: header in messages you send.
  109.  
  110.      Editor program
  111.           Set the name of the editor program to run when you send messages.
  112.           The program must be in your PATH.
  113.  
  114.      Reply packet file
  115.           Specify the full path of the SOUP reply packet file where your
  116.           outgoing messages are stored.  If the reply packet file does not
  117.           exist, it is created when you post an article or send a mail message
  118.           from the reader program.  When you exit the reader program, the reply
  119.           packet is ready to upload to your host.
  120.  
  121.      The program writes the user information to a configuration file named
  122.      <home>\yarn\config.  This document refers to other configuration settings
  123.      also stored in this file.  If you want to change those settings, you have
  124.      to edit the configuration file with a text editor.
  125.  
  126.  
  127.  
  128.  
  129.                                                                               2
  130.  
  131.  
  132.  
  133. Yarn User Manual - version 0.60                                                
  134.  
  135.  
  136. SET TIME ZONE
  137.  
  138.      Set the environment variable TZ to your time zone.  The format of the TZ
  139.      string is
  140.  
  141.           zzz[+/-]h[h][ddd]
  142.  
  143.      zzz is a three character field representing the name of the time zone.
  144.  
  145.      [+/-]h[h] is an optionally signed number representing the local time
  146.      zone's difference from Greenwich Mean Time (GMT) in hours.  Positive
  147.      numbers adjust westward from GMT.  Negative numbers adjust eastward from
  148.      GMT.
  149.  
  150.      ddd is an optional three character field that represents the name of the
  151.      local time zone's daylight saving time.
  152.  
  153.      If no TZ environment variable is set, a default TZ=EST5EDT is assumed.
  154.  
  155. UPDATE SYSTEM FILES
  156.  
  157.      Put these SET commands in your AUTOEXEC.BAT file to ensure the environment
  158.      settings persist after the next time you reboot your system.  (If you are
  159.      installing Yarn for OS/2, put the SET commands in your CONFIG.SYS file
  160.      instead.)  Use the settings determined above for the values appearing to
  161.      the right of the equal signs.
  162.  
  163.           SET YARN=<yarn>
  164.           SET HOME=<home>
  165.           SET TZ=<tz>
  166.  
  167.  
  168. SET UP ADDRESS BOOK
  169.  
  170.      An address book is a file where you can conveniently store and retrieve
  171.      mail addresses.  An address book entry consists of an alias and an
  172.      address.  An alias is a word representing one or more mail addresses.  If
  173.      an alias appears in a To:, Cc:, or Bcc: header, it is replaced with the
  174.      corresponding address(es) when the message is sent.
  175.  
  176.      Create a file named <home>\yarn\addrbook.  An address book entry has the
  177.      format
  178.  
  179.           <alias>=<addresses>
  180.  
  181.      where <alias> is an alias or nickname, and <addresses> is a list of one or
  182.      more addresses.
  183.  
  184.      You can specify an alternate address book file by using the statement
  185.  
  186.           address-book=<file>
  187.  
  188.      in the configuration file, where <file> is the full path of the file.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                               3
  195.  
  196.  
  197.  
  198. Yarn User Manual - version 0.60                                                
  199.  
  200.  
  201. SET UP OTHER USERS
  202.  
  203.      To set up another user, run the adduser command, and specify a different
  204.      home directory.  To run Yarn as that user, set the HOME environment
  205.      variable to the user's home directory.
  206.  
  207. ENVIRONMENT
  208.  
  209.      These enviroment variables modify the behaviour of Yarn if they are set.
  210.  
  211.      EDITOR    Specifies the external editor program, overriding the editor
  212.                specified in the configuration file.
  213.  
  214.      YARNRC    This is the path of an alternate configuration file to read
  215.                instead of the default one.
  216.  
  217. CREATE LIST OF ACTIVE NEWSGROUPS
  218.  
  219.      You must inform Yarn of every newsgroup you will be importing by running
  220.      the command
  221.  
  222.           newgroup <name> <keepDays> [<maxDays>]
  223.  
  224.      where <name> is the newsgroup name and <keepDays> is the number of days
  225.      that articles in the newsgroup will be kept before the expire program
  226.      deletes them.  If you later want to change the number of keep days, run
  227.      this command again, specifying the new keep days value.
  228.  
  229.      The optional parameter <maxDays> is the absolute maximum number of days an
  230.      article will be kept.  Some articles may have an Expires: header which
  231.      contains a date far in the future.  Normally the article will be kept
  232.      until that date, but if you set this parameter to a value greater than
  233.      zero, the article will be kept only for the specified number of days.
  234.  
  235.      Instead of naming a newsgroup on the command line, you can specify a text
  236.      file containing a list of newsgroup names.  Every newsgroup listed in the
  237.      file is assigned the keep days value.
  238.  
  239.           newgroup @<file> <keepDays> [<maxDays>]
  240.  
  241.  
  242. REMOVE NEWSGROUP FROM ACTIVE LIST
  243.  
  244.      To remove a newsgroup from the active newsgroup list, run the command
  245.  
  246.           rmgroup <name>
  247.  
  248.      where <name> is the newsgroup name.
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                                                               4
  260.  
  261.  
  262.  
  263. Yarn User Manual - version 0.60                                                
  264.  
  265.  
  266.                                    OPERATION
  267.  
  268. IMPORT NEWS AND MAIL
  269.  
  270.      To import messages from SOUP format, run
  271.  
  272.           import <file>
  273.  
  274.      where <file> is the path of the SOUP file.  The import program takes these
  275.      options.
  276.  
  277.      -n        Do not delete the packet file.
  278.  
  279.      -q        Operate in quiet mode.  Do not list imported article numbers.
  280.  
  281.      -r        Import rnews batches instead of SOUP files.
  282.  
  283.      If the import program finds a newsgroup in the packet that is not in the
  284.      active newsgroup list, it adds the newsgroup to the active list.  The keep
  285.      days and maximum keep days for the added newsgroup are specified by the
  286.      "keep" and "max-keep" settings respectively in the configuration file.
  287.      For example, if the configuration file contains the settings
  288.  
  289.           keep=7
  290.           max-keep=30
  291.  
  292.      then articles are normally kept in the newsgroup for 7 days and absolutely
  293.      not more than 30 days.
  294.  
  295. EXPIRE NEWS
  296.  
  297.      Periodically run the expire program to delete old articles from the news
  298.      base.  To expire old articles from all newsgroups, run the command
  299.  
  300.           expire
  301.  
  302.      To expire old articles from specific newsgroups, list the newsgroups on
  303.      the command line.  For example:
  304.  
  305.           expire comp.answers news.answers
  306.  
  307.      To delete all read articles in all newsgroups, run
  308.  
  309.           expire -r
  310.  
  311.      To delete read articles from specific newsgroups, run expire with the -r
  312.      option and list the newsgroups on the command line.  For example:
  313.  
  314.           expire -r comp.answers news.answers
  315.  
  316.      The program may expire newsgroups in addition to the newsgroups you
  317.      specified if an expired article was crossposted to multiple newsgroups.
  318.  
  319.      You can specify a text file containing a list of newsgroups to expire.
  320.      Run expire with the argument
  321.  
  322.  
  323.  
  324.                                                                               5
  325.  
  326.  
  327.  
  328. Yarn User Manual - version 0.60                                                
  329.  
  330.  
  331.           @<file>
  332.  
  333.      on the command line, where <file> is the file path.
  334.  
  335.      The expire program accepts these options:
  336.  
  337.      -d<n>     Assume it is <n> days in the future.  Use this option to expire
  338.                articles before they normally would have been expired.
  339.  
  340.      -n        Do not actually delete any articles.  Used for testing.
  341.  
  342.      -r        Delete read articles.
  343.  
  344. READ NEWS
  345.  
  346.      Run the yarn program to read news and mail.  The yarnx program is a
  347.      version of the reader with a 32-bit DOS extender and it can list much more
  348.      articles in a newsgroup.  It requires an 80386 compatible CPU or better.
  349.      It also needs to find the file DOS4GW.EXE in a directory in your PATH.
  350.  
  351.      The reader program operates in several modes -- the newsgroup selection
  352.      level, the article selection level, and the article reading level.
  353.  
  354.      In the newsgroup selection level, yarn displays a window listing the
  355.      newsgroups you are subscribed to along with the number of unread articles
  356.      in each newsgroup.  You can subscribe, unsubscribe or rearrange the order
  357.      of newsgroups in this list.  Press the [Ins] key to subscribe to a
  358.      newsgroup.  This brings up a list of unsubscribed newsgroups.  To make a
  359.      selection, use the arrow keys to move the highlight to the newsgroup, and
  360.      then press the [Enter] key.  The selected newsgroup is inserted into the
  361.      subscribed newsgroup list.  Press the [Del] key to unsubscribe from the
  362.      highlighted newsgroup.  To move a newsgroup in the list, press the [Del]
  363.      key to remove it, position the highlight to the desired location, then
  364.      press the [Ins] key and reinsert the newsgroup.
  365.  
  366.      By selecting a newsgroup, you go to the article selection level, where
  367.      yarn presents a list of the subjects of each article.  You can select an
  368.      article to read from this list, taking you to the article reading level.
  369.  
  370. NEWSGROUP SELECTION LEVEL
  371.  
  372.      These commands are available in the newsgroup selection level.
  373.  
  374.      Down Arrow
  375.           Move to the next newsgroup.
  376.  
  377.      Up Arrow
  378.           Move to the previous newsgroup.
  379.  
  380.      Tab, Alt-N
  381.           Move to the next newsgroup that contains unread articles.
  382.  
  383.      Shift-Tab, Alt-P
  384.           Move to the previous newsgroup that contains unread articles.
  385.  
  386.  
  387.  
  388.  
  389.                                                                               6
  390.  
  391.  
  392.  
  393. Yarn User Manual - version 0.60                                                
  394.  
  395.  
  396.      Home Move to first newsgroup.
  397.  
  398.      End  Move to last newsgroup.
  399.  
  400.      /    Search forward for newsgroup name containing matching text.
  401.  
  402.      ?    Search backward for newsgroup name containing matching text.
  403.  
  404.      ;    Continue forward search.
  405.  
  406.      :    Continue backward search.
  407.  
  408.      Space
  409.           Go to the article selection level, listing only unread articles.
  410.  
  411.      Enter
  412.           Go to the article selection level, listing all articles.
  413.  
  414.      Ins, Alt-S
  415.           Subscribe to a newsgroup and insert the newsgroup at the current
  416.           position.
  417.  
  418.      Del, Alt-U
  419.           Unsubscribe from the highlighted newsgroup.
  420.  
  421.      Alt-A
  422.           Post an article to the highlighted newsgroup.
  423.  
  424.      Alt-C
  425.           Mark all articles in the highlighted newsgroup as read.
  426.  
  427.      !    Run command shell.  Type "exit" to return to Yarn.
  428.  
  429.      F2   List address book.
  430.  
  431.      Esc  Exit program
  432.  
  433. ARTICLE SELECTION LEVEL
  434.  
  435.      These commands are available in the article selection level.
  436.  
  437.      Down Arrow
  438.           Move to the next article.
  439.  
  440.      Up Arrow
  441.           Move to the previous article.
  442.  
  443.      Tab  Move to the first article of the next thread.
  444.  
  445.      Shift-Tab
  446.           Move backwards to the previous article beginning a thread.
  447.  
  448.      Home Move to first article.
  449.  
  450.  
  451.  
  452.  
  453.  
  454.                                                                               7
  455.  
  456.  
  457.  
  458. Yarn User Manual - version 0.60                                                
  459.  
  460.  
  461.      End  Move to last article.
  462.  
  463.      /    Search forward for article containing matching text.
  464.  
  465.      ?    Search backward for article containing matching text.
  466.  
  467.      ;    Continue forward search.
  468.  
  469.      :    Continue backward search.
  470.  
  471.      Space, Enter
  472.           Read the article.
  473.  
  474.      Del  Mark the article as read and go to the next unread article.
  475.  
  476.      Ins  Mark the article as unread.
  477.  
  478.      Alt-O
  479.           Save the current article through to the last article in the thread to
  480.           a folder.
  481.  
  482.      Alt-S
  483.           Save the current article through to the last article in the thread to
  484.           a file.  If the file already exists, the articles are appended to the
  485.           file.  The program prompts for a file name.  If you don't give a full
  486.           path name, the file is stored in the directory <home>/News.
  487.  
  488.      Alt-W
  489.           Same at Alt-S, except omit the article headers.
  490.  
  491.      Alt-K
  492.           Mark the current article through to the last article in the thread as
  493.           read.
  494.  
  495.      Alt-U
  496.           Mark the current article through to the last article in the thread as
  497.           unread.
  498.  
  499.      Alt-C
  500.           Mark all articles in the newsgroup as read.
  501.  
  502.      Alt-A
  503.           Post an article to the newsgroup.
  504.  
  505.      !    Run command shell.  Type "exit" to return to Yarn.
  506.  
  507.      F2   List address book.
  508.  
  509.      F3   Add the author of the current message to the address book.
  510.  
  511.      Esc  Return to the newsgroup selection level.
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.                                                                               8
  520.  
  521.  
  522.  
  523. Yarn User Manual - version 0.60                                                
  524.  
  525.  
  526. ARTICLE READING LEVEL
  527.  
  528.      These commands are available in the article reading level.
  529.  
  530.      Down Arrow, Enter
  531.           Scroll one line down.
  532.  
  533.      Up Arrow
  534.           Scroll one line up.
  535.  
  536.      PgDn, Space
  537.           Show next page.
  538.  
  539.      PgUp, b
  540.           Show previous page.
  541.  
  542.      Home Go to top of article.
  543.  
  544.      g    Search article for matching text.
  545.  
  546.      G    Continue search in article.
  547.  
  548.      /    Search forward for article containing matching text.
  549.  
  550.      ?    Search backward for article containing matching text.
  551.  
  552.      ;    Continue forward search.
  553.  
  554.      :    Continue backward search.
  555.  
  556.      n    Mark the article as read and show the next unread article.
  557.  
  558.      N    Show next article.
  559.  
  560.      p    Show previous unread article.
  561.  
  562.      P    Show previous article.
  563.  
  564.      a, Alt-A
  565.           Post an article to the newsgroup.
  566.  
  567.      f    Post a followup article.
  568.  
  569.      F    Post a followup article, quoting the original article.
  570.  
  571.      r    Mail a reply to the author of the article.
  572.  
  573.      R    Mail a reply, quoting the original article.
  574.  
  575.      m    Mail the article to someone.
  576.  
  577.      o    Save the article to a folder.
  578.  
  579.      s    Save the article to a file.  If the file already exists, the article
  580.           is appended to the file.  The program prompts for a file name.  If
  581.           you don't give a full path name, the file is stored in the directory
  582.  
  583.  
  584.                                                                               9
  585.  
  586.  
  587.  
  588. Yarn User Manual - version 0.60                                                
  589.  
  590.  
  591.           <home>/News.
  592.  
  593.      w    Same as s except omit article headers.
  594.  
  595.      x    ROT13 decrypt the article.
  596.  
  597.      k, Del
  598.           Mark the article as read.
  599.  
  600.      K, Alt-K
  601.           Mark this article and the rest of the articles in the thread as read.
  602.  
  603.      u, Ins
  604.           Mark the article as unread.
  605.  
  606.      U, Alt-U
  607.           Mark this article and the rest of the articles in the thread as
  608.           unread.
  609.  
  610.      Alt-C
  611.           Mark all the articles in the newsgroup as read.
  612.  
  613.      v    Toggle verbose headers.
  614.  
  615.      C    Cancel the article.  You must be the author to be able to cancel the
  616.           article.
  617.  
  618.      S    Supersede the article.  You must be the author to be able to
  619.           supersede the article.
  620.  
  621.      =, q Return to the article selection level.
  622.  
  623.      !    Run command shell.  Type "exit" to return to Yarn.
  624.  
  625.      F2   List address book.
  626.  
  627.      F3   Add the author of the current message to the address book.
  628.  
  629.      Esc  Return to the newsgroup selection level.
  630.  
  631. READ MAIL
  632.  
  633.      To read mail, press [Alt-M] at the newsgroup selection level.  This brings
  634.      up a list of mail messages you received.
  635.  
  636.      If you have no mail, you are given the opportunity to send mail.  A form
  637.      pops up, asking you to enter the destination mail address and subject for
  638.      the message you want to send.  If you press the [F2] key while the cursor
  639.      is in the mail address field, the address book pops up.  You can select an
  640.      entry from the address book by moving the highlight with the arrow keys
  641.      and pressing the [Enter] key.
  642.  
  643.      Press [Alt-F] at the newsgroup selection level to bring up a list of
  644.      folders.  You can select a folder to read from this list.
  645.  
  646.  
  647.  
  648.  
  649.                                                                              10
  650.  
  651.  
  652.  
  653. Yarn User Manual - version 0.60                                                
  654.  
  655.  
  656.      If you start yarn with the -m option, you go directly to reading your
  657.      received mail and skip reading news.  If you start yarn with the -f
  658.      option, you go directly to the folder list and skip reading news.
  659.  
  660. EDIT REPLIES
  661.  
  662.      The Yarn reader allows you to edit the messages in the reply packet.  At
  663.      the newsgroup selection level, press [Alt-R] to display a list of folders
  664.      in the reply packet.  The reply packet may contain up to two folders,
  665.      ``mail'' which holds outgoing mail messages, and ``news'' which holds
  666.      outgoing USENET articles.
  667.  
  668.      By selecting a folder, you go to the message selection level, where the
  669.      program lists the messages in the folder.  Press the [Del] key to delete
  670.      the currently highlighted message.  Press [Alt-E] to edit the message.
  671.  
  672.      To view a message, select it from the message selection level.  While a
  673.      message is displayed, pressing the 'd' key deletes the message.  Press the
  674.      'e' key to edit the message.
  675.  
  676.      If you start yarn with the -r option, you go directly to the replies list
  677.      and skip reading news.
  678.  
  679. YARN OPTION SUMMARY
  680.  
  681.      The yarn program accepts these options:
  682.  
  683.      -b   Output to the display using BIOS calls instead of direct screen
  684.           writes.
  685.  
  686.      -f   List folders.  Do not read news.
  687.  
  688.      -m   List mail.  Do not read news.
  689.  
  690.      -r   List replies.  Do not read news.
  691.  
  692. QUESTIONS AND ANSWERS
  693.  
  694.      ``How do I create SOUP files on my UNIX host?''
  695.  
  696.           The uqwk program creates and processes SOUP files on your UNIX host.
  697.           It is available by anonymous FTP from ftp.gte.com in the /pub/uqwk
  698.           directory.
  699.  
  700.           To create a SOUP download packet, named "down.zip" in this example,
  701.           run these commands on your UNIX host:
  702.  
  703.                uqwk +n +L
  704.                zip down.zip AREAS *.MSG
  705.  
  706.           Download the down.zip file to your PC.  Run this command on your PC
  707.           to insert the messages into the Yarn news base:
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.                                                                              11
  715.  
  716.  
  717.  
  718. Yarn User Manual - version 0.60                                                
  719.  
  720.  
  721.                import down.zip
  722.  
  723.           When you send mail or post articles, the Yarn reader creates a SOUP
  724.           reply packet, named "up.zip" in this example.  Upload the up.zip file
  725.           to your UNIX host.  Run these commands on your UNIX host to send the
  726.           messages in the reply packet:
  727.  
  728.                unzip -U up.zip
  729.                uqwk -m -n +L -RREPLIES
  730.  
  731.  
  732.      ``Sometimes when I select a newsgroup by pressing the space bar from the
  733.      newsgroup selection level, yarn lists less articles than the number of
  734.      unread articles shown.''
  735.  
  736.           This occurs if the newsgroup you selected contains cross-posted
  737.           articles that you already read in another newsgroup.  The program
  738.           marks these articles as read and updates the count of unread articles
  739.           when you select the newsgroup.
  740.  
  741.      ``After running expire, I reduced the keep days for a newsgroup and ran
  742.      expire again, but it didn't delete any more articles.''
  743.  
  744.           Each article is assigned an expiry date after which it is deleted.
  745.           The expire program deletes articles having an expiry date older than
  746.           the current date.  The article storage scheme requires that an
  747.           article's expiry date be set when the article is imported into the
  748.           news base.  Once imported, the article's expiry date cannot be
  749.           changed.  When you change the keep days for a newsgroup, you only
  750.           change how long you keep subsequently imported articles.  You don't
  751.           affect the expiry dates of articles already in the news base.
  752.  
  753.      ``What is the junk newsgroup?''
  754.  
  755.           When the import program finds an article that doesn't belong to any
  756.           of the groups in the active newsgroup list, it tosses the article
  757.           into the junk newsgroup.  This usually shouldn't happen with properly
  758.           configured software.
  759.  
  760.      ``I configured Yarn for OS/2 to run the DOS version of PKZIP and PKUNZIP.
  761.      Now the import program reports unpack failed.''
  762.  
  763.           To use PKZIP and PKUNZIP, put these settings in your configuration
  764.           file, adjusting the drive and path appropriately.
  765.  
  766.                compress=c:\os2\cmd.exe /c c:\path\pkzip -m %f %d\*.*
  767.                uncompress=c:\os2\cmd.exe /c c:\path\pkunzip -o %f %d
  768.  
  769.  
  770.      ``How do I configure Yarn to use InfoZip's zip and unzip programs?''
  771.  
  772.           Put these settings in the configuration file.
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.                                                                              12
  780.  
  781.  
  782.  
  783. Yarn User Manual - version 0.60                                                
  784.  
  785.  
  786.                compress=zip -kjm %f %d/*
  787.                uncompress=unzip -o %f
  788.  
  789.  
  790. FILES
  791.  
  792.      <home>\mail             Folder directory
  793.      <home>\news             Default save directory
  794.      <home>\replies          Reply work directory
  795.      <home>\yarn             User configuration directory
  796.      <home>\yarn\addrbook    Address book file
  797.      <home>\yarn\config      User configuration file
  798.      <home>\yarn\newsrc      Newsgroup subscription file
  799.      <home>\yarn\readart.*   Read cross-posted article lookup table
  800.  
  801.      <yarn>\active           Active newsgroup file
  802.      <yarn>\history.*        Article history lookup table
  803.      <yarn>\overview         Article overview directory
  804.      <yarn>\news             Article file directory
  805.  
  806.  
  807.                                ACKNOWLEDGEMENTS
  808.  
  809.      This product uses the SPAWNO routines by Ralf Brown to minimize memory use
  810.      while shelling to DOS and running other programs.
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.                                                                              13
  845.  
  846.