home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / INTERNET / FEEDER11.ZIP / FEEDER.DOC next >
Text File  |  1992-12-13  |  4KB  |  121 lines
  1. Please keep in mind, as you read this file, that I am a programmer,
  2. not a writer.
  3.  
  4. LEGAL STUFF
  5.   First of all, FEEDER is released as FREEWARE. There is no charge for it
  6.   (although I won't turn down donations) and can be freely distributed
  7.   as long as all files in the archive remain together and unmodified.
  8.  
  9.   This program writes to your disk. Although it works fine on my machines
  10.   it may not work on yours. I will not be responsible for any damage this
  11.   program may cause. Use at your own risk.
  12.  
  13.  
  14. PURPOSE 
  15.  
  16.     To allow a site to add or remove newsgroups from his/her news feed
  17.     without having to bother the sysadmin of his/her feed site.
  18.  
  19. FILES
  20.   
  21.     FEEDER.DOC                You're reading it
  22.     FEEDER.EXE                FEEDER
  23.     FEEDER.HLP                Help file for FEEDER
  24.     FEEDER.TMP                Temporary file created by FEEDER
  25.     FEEDER.LOG                Log of all changes made
  26.     FEEDER.REP                Temporary file created by FEEDER
  27.     FEEDS.EX                  Example FEEDS file
  28.  
  29. INSTALLATION
  30.  
  31.     The first thing you need to do is modify your FEEDS file. To simplify
  32.     programming FEEDER requires that your FEEDS file has only one newsgroup
  33.     listed on each line. See FEEDS.EX for an example of what your FEEDS
  34.     file should look like.
  35.  
  36.     Now add the "/CONTROL={user@site.domain}" parameter to your FEEDS file
  37.     for each site. This parameter controls who is allowed to make changes to
  38.     each site. If this parameter is missing from a site entry no one will be
  39.     able to modify that site. This must be the same address that would be
  40.     shown in the "From:" field of a message from this user.
  41.  
  42.     Now create a directory to hold FEEDER's files and copy the files into
  43.     that directory.
  44.  
  45.     Next add the following line (to your ALIASES file:
  46.  
  47.        newsfeed    |  d:\waffle\bin\feeder.exe d:\waffle\system\feeds
  48.  
  49.     You will need to edit the paths to fit your configuration. In this
  50.     example the site would send a mail message to user "newsfeed" at your
  51.     site.
  52.  
  53.     That's all there is to it!
  54.  
  55. COMMANDS
  56.  
  57.     HELP                         Request this HELP file
  58.  
  59.     ADD {newsgroup} {site}       ADD a newsgroup to your feed
  60.  
  61.     REMOVE {newsgroup} {site}    REMOVE a newsgroup from your feed
  62.  
  63.     LIST {site}                  Request a listing of your feeds newsgroups
  64.  
  65.  
  66.           {newsgroup} = the full newsgroup name
  67.                          (ie. "comp.bbs.waffle";
  68.                {site} = the site name as listed in your feeds file.
  69.                      
  70.  
  71.     You can have as many commands as you want in a single message.
  72.     Only one newsgroup may be specified on each command line.
  73.     You may only modify sites that you have clearance for.
  74.  
  75.  
  76.     For example:
  77.  
  78.         help
  79.         list
  80.         remove alt.bbs.waffle mynode
  81.         add comp.bbs.waffle mynode
  82.  
  83.     can all be in a single message. If everything is settup correctly   
  84.     the sender will recieve a reply detailing the session.
  85.  
  86. SUPPORT
  87.  
  88.     I don't have alot of time to work on this program but I will do my
  89.     best to answer any questions and fix any bugs.
  90.  
  91.     There are several ways you can reach me:
  92.  
  93.                     Duane Davis
  94.  
  95.              Snail Mail:  711 Lincoln Ave.
  96.                           San Jose, CA 95126
  97.  
  98.                Internet:  system@micromed.com
  99.   
  100.                   Phone:  (408) 293-3299
  101.                     Fax:  (408) 293-6398
  102.                     BBS:  (408) 287-2454 - PCBoard
  103.                           (408) 279-5240 - Waffle
  104.  
  105. HISTORY
  106.  
  107.     date      version  changes
  108.     --------  -------  ---------------------------------------------------
  109.     12-13-92  1.1      Fixed bug where Feeder was sending one too many
  110.                        lines in a feed list.
  111.  
  112.                        Added session summary. Feeder will reply to all
  113.                        change requests with a summary of the session.
  114.  
  115.                        Streamlined much of the code for better speed and
  116.                        reliability.
  117.  
  118.     10-11-92  1.0      Initial release
  119.  
  120.  
  121.