home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 25 Icons / 25-Icons.zip / yodomain.zip / souper.doc < prev    next >
Text File  |  1995-08-01  |  9KB  |  326 lines
  1.  
  2.  
  3. Souper User Manual - version 1.4                                               
  4.  
  5.  
  6.                     Souper - transfer mail and news to SOUP
  7.  
  8.      Souper is a program that transfers mail and news from a POP3 mail server
  9.      and NNTP news server respectively to SOUP packets.  It can also send
  10.      messages in SOUP reply packets.  It runs on OS/2 Warp with the IBM
  11.      Internet Connection for OS/2.
  12.  
  13. INSTALLATION
  14.  
  15.      Copy the souper.exe file to a directory in your PATH.  You also need the
  16.      emx run-time DLLs.  You can get these from
  17.  
  18.           ftp-os2.nmsu.edu:/os2/unix/emx09a/emxrt.zip
  19.  
  20.      Make sure the emx run-time DLLs are in a directory in your LIBPATH.
  21.  
  22.      Edit your \tcpip\etc\services file.  Look for a line beginning with the
  23.      word "pop3".  If the file does not contain such a line, add the line
  24.  
  25.           pop3             110/tcp
  26.  
  27.      to the file.
  28.  
  29.      Souper is designed to work with the IBM Internet Connection for OS/2.  In
  30.      your PPP/SLIP settings notebook, you must fill in the entries for
  31.  
  32.           Your Host Name:
  33.           Your Domain Name:
  34.           News Server:
  35.           Mail Gateway:
  36.           POP Mail Server:
  37.           Reply Domain:
  38.           Reply (Mail) ID:
  39.           POP Login ID:
  40.           POP Password:
  41.  
  42.      Ask your Internet service provider for the correct values for these
  43.      settings.
  44.  
  45. ENVIRONMENT VARIABLES
  46.  
  47.      You can set these environment variables to change the default behaviour of
  48.      the program.
  49.  
  50.      HOME      Specifies the user's home directory.  If not set, this defaults
  51.                to the current directory.  The program looks for the newsrc file
  52.                in the home directory.
  53.  
  54.      NNTPSERVER
  55.                Specify the NNTP news server, overriding the news server given
  56.                in the PPP/SLIP settings notebook.
  57.  
  58.      MAILER    Specify the command to execute to send mail.  If this is not
  59.                set, then Souper sends the mail directly to the mail server
  60.                specified in the PPP/SLIP settings notebook.
  61.  
  62.  
  63.  
  64.                                                                               1
  65.  
  66.  
  67.  
  68. Souper User Manual - version 1.4                                               
  69.  
  70.  
  71.      POSTER    Specify the command to execute to post news.  If this is not
  72.                set, then Souper posts the news directly to the news server
  73.                specified in the PPP/SLIP settings notebook.
  74.  
  75. CREATE NEWSRC FILE
  76.  
  77.      Use a text editor to create a file named newsrc in your home directory.
  78.      List the newsgroups you want to transfer, one per line, and end each line
  79.      with a colon.  For example:
  80.  
  81.           comp.answers:
  82.           news.answers:
  83.           rec.humor.funny:
  84.  
  85.      The program records the article numbers it has fetched by updating this
  86.      file.
  87.  
  88. CREATE KILL FILE
  89.  
  90.      A kill file records the criteria used to kill news articles, that is,
  91.      exclude them from the SOUP packet.  You can kill articles that have a
  92.      specific subject, are from a specific poster, or contain a particular
  93.      string anywhere in the header.
  94.  
  95.      By default, the program looks for a file named kill in your home
  96.      directory.  An entry in the kill file has the format:
  97.  
  98.           <newsgroup> {
  99.             <where> <pattern>
  100.             ...
  101.           }
  102.  
  103.      where
  104.  
  105.      <newsgroup>
  106.                is the name of the newsgroup in which the search patterns apply.
  107.                If the name is "all", the search patterns apply in all
  108.                newsgroups.
  109.  
  110.      <where>   specifies where to search in the article.  "from" searches the
  111.                From line.  "subject" searches the Subject line.  "header"
  112.                searches all lines in the article header.
  113.  
  114.      <pattern> is the string to search for.  All searches are case-insensitive.
  115.  
  116.      Here is an example kill file:
  117.  
  118.           all {
  119.             From netkook
  120.           }
  121.           comp.os.os2.advocacy {
  122.             Subject Microsoft
  123.             Subject crash OS/2
  124.           }
  125.  
  126.      In all newsgroups, articles from netkook are killed.  Also in the
  127.  
  128.  
  129.                                                                               2
  130.  
  131.  
  132.  
  133. Souper User Manual - version 1.4                                               
  134.  
  135.  
  136.      comp.os.os2.advocacy newsgroup, articles with a Subject containing the
  137.      string "Microsoft" or "crash OS/2" are killed.
  138.  
  139. OPERATION
  140.  
  141.      To fetch your mail and news, run the command
  142.  
  143.           souper
  144.  
  145.      You can specify a different POP3 mail server than the one specified in the
  146.      PPP/SLIP settings notebook by instead running the command
  147.  
  148.           souper <mailhost> <userid> <password>
  149.  
  150.      where
  151.  
  152.      <mailhost>
  153.                is the name of the host running the POP3 mail server
  154.  
  155.      <userid>  is your POP3 user ID
  156.  
  157.      <password>
  158.                is your POP3 password
  159.  
  160.      If you want to transfer only news, specify the -m option to disable the
  161.      mail transfer.
  162.  
  163.           souper -m
  164.  
  165.      If you want to transfer only mail, specify the -n option to disable the
  166.      news transfer.
  167.  
  168.           souper -n
  169.  
  170.  
  171.      The program creates the AREAS and *.MSG files of the SOUP packet in the
  172.      current directory.  Here's a typical batch file designed to import news
  173.      into Yarn:
  174.  
  175.           cd \temp
  176.           souper
  177.           zip -0m soup.zip areas *.msg
  178.           import soup.zip
  179.  
  180.      And to export messages from Yarn:
  181.  
  182.           cd \temp
  183.           unzip -o \home\reply.zip
  184.           del \home\reply.zip
  185.           souper -s
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                               3
  195.  
  196.  
  197.  
  198. Souper User Manual - version 1.4                                               
  199.  
  200.  
  201. OPTIONS
  202.  
  203.      The program accepts the following command line options.
  204.  
  205.      -a        Check for new newsgroups.  If any newgroups were created since
  206.                the last time souper was run, this option adds the new
  207.                newsgroups to your newsrc file.
  208.  
  209.      -c n      Catch up news.  Mark every article in every newsgroup as read
  210.                except for the last n articles.
  211.  
  212.      -h dir    Set home directory.  This option overrides any HOME environment
  213.                setting.  If the HOME environment variable is not set, the
  214.                default is the current directory.
  215.  
  216.      -i        Do not read the configuration from the IBM Internet Connection
  217.                for OS/2 settings notebook.  If the use this option, you must
  218.                specify the required mail and news host information through the
  219.                command line and environment variables.
  220.  
  221.      -k n      Set maximum news packet size in Kbytes.  The default is 2048
  222.                Kbytes.  If you set this to 0, the packet size is unlimited.
  223.  
  224.      -K file   Specify another kill file.  The default is the kill file in the
  225.                home directory.
  226.  
  227.      -l n      Kill articles that contain more than n lines in the body.
  228.  
  229.      -m        Do not get mail.
  230.  
  231.      -n        Do not get news.
  232.  
  233.      -N file   Specify another newsrc file.  The default is the newsrc file in
  234.                the home directory.
  235.  
  236.      -r        Set read only mode.  Do not empty your POP3 mailbox or update
  237.                the newsrc file.
  238.  
  239.      -s        Send replies.  The program expects the SOUP reply files in the
  240.                current directory.
  241.  
  242.      -u        When fetching news, create SOUP summaries instead of transfering
  243.                entire articles.
  244.  
  245.      -x        Do not process news Xref headers.
  246.  
  247. ACKNOWLEDGEMENTS
  248.  
  249.      This program is derived from popclient by Carl Harris <ceharris@vt.edu>
  250.      and uqwk by Steve Belczyk <seb3@gte.com>.
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                                                               4
  260.  
  261.  
  262.  
  263. Souper User Manual - version 1.4                                               
  264.  
  265.  
  266. STANDARD DISCLAIMER
  267.  
  268.      The author makes no representations about the accuracy or suitability of
  269.      this material for any purpose.  It is provided "as is", without any
  270.      express or implied warranties.  The author will assume no liability for
  271.      damages either from the direct use of this product or as a consequence of
  272.      the use of this product.
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.                                                                               5
  325.  
  326.