home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / n / newshound / Docs / General < prev    next >
Encoding:
Text File  |  1997-06-20  |  5.2 KB  |  143 lines
  1. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2. +                                        +
  3. +     !NewsHound  -  A NNTP Newsfetcher      (c) J.Heenan 1996-7    +
  4. +                                    +
  5. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  6.  
  7. Description
  8. ~~~~~~~~~~~
  9.  
  10. This program, when used in conjunction with Newbase and Messenger,
  11. provides a means for downloading usenet news, and reading it off-line.
  12.  
  13. Features
  14. ~~~~~~~~
  15.  
  16. * Does not use the NEWNEWS commands, so will work with more news servers
  17.   that software that does.
  18.  
  19. * Fully supports NewsBase 0.59 and Messenger 0.31.
  20.  
  21. * Can fetch a list of all available news groups from the news server
  22.  
  23. * Supports multiple news servers
  24.  
  25. * Kill file, 'header-only' file
  26.  
  27. * Fetches lists of new news groups
  28.  
  29. * Works with ANT, Acornet, Voyager (when they're used with newsbase)
  30.   Does not work with Termite.
  31.  
  32. * All hostname lookups are done without freezing the computer
  33.  
  34. Requirements
  35. ~~~~~~~~~~~~
  36.  
  37. !Messenger, version 0.28 or later.    http://www.locutus.demon.co.uk/
  38.  
  39.     This is a news/mail reader (a replacement for TTFN), and is required
  40.     because TTFN does not have support for header only news articles in
  41.     it.
  42.     Having said that, TTFN may be used, but you will not be able to
  43.     use the header only facilities with the current version. (0.39)
  44.  
  45.  
  46. !Newsbase, version 0.58 or later    ftp://mnhepw.hep.umn.edu/pub/allan/
  47.     (0.59b or later recommended)
  48.  
  49.     This is the software that actually holds the news articles, and
  50.     also provides communication between Messenger and NewsHound.
  51.  
  52.  
  53. !Syslog, version 0.15 or greater
  54.                 ftp://ftp.oaktree.co.uk/pub/acorn/syslog/
  55.     This provides a configurable mechanism for NewsHound to keep a record
  56.     of what happened during a newsfetch.
  57.     NB. There are two application called !Syslog. If in doubt, check
  58.     !Syslog.!Help. The author for the version required is Jon Ribbens.
  59.  
  60.  
  61. A setup TCP/IP stack (FreeNet or the Acorn stack)
  62.         ftp://ftp.dsse.ecs.soton.ac.uk/pub/Acorn/freenet/t.hughes
  63.         ftp://ftp.acorn.co.uk/pub/riscos/releases/networking/dci-4
  64.         (or the acorn stack in rom on Risc OS 3.6 or later)
  65.  
  66. Also, for correct operation of the message id history and the newgroups
  67. mechanism, the time on your computer should be set correctly.
  68.  
  69. NB. NewsHound will probably work with other versions of the software -
  70. but they may have bugs, or be missing features that prevents you using
  71. newshound to its full potential.
  72.  
  73. NewsHound is designed to work with the versions of software given above.
  74. No other combinations of software are currently supported.
  75.  
  76. Credits
  77. ~~~~~~~
  78.  
  79. Carol Carpenter (carol@barnet.ac.uk) for providing help, critism,
  80. enthusiasm, moral support, beta testing and the initial idea / kick to get
  81. me started. This software is devoted to her, for being generally wonderful to
  82. me during its development - and helping me find a few potentially serious
  83. bugs in the code (and giggling lots at my icon! humph!). Thanks doormouse!
  84.  
  85. Tom Hughes (tom@compton.demon.co.uk) for freenet, general help with using
  86. freenet from C, and for pointing out when I was being totally stupid. :-)
  87.  
  88. Stewart Brodie, for the multitasking DNS code that NewsHound is linked to
  89. (also betatesting and making helpful suggestions).
  90. (and Jonathan Coxhead, for OSLib that this code needs)
  91.  
  92. Graham Allan and Mark Sawle for providing Newsbase and Messenger 
  93. respectively, without which this software would be entirely useless!
  94. Thanks also go to them for implementing features (and fixing bugs)
  95. specifically for NewsHound.
  96.  
  97. Mark Wooding for giving me the basics of a string wildcard matching
  98. routine.
  99.  
  100. James Ponder, Jonathan Hunt and John Wright for not moaning too much about
  101. the state the phone bill ended up after I spent a few weekends debugging....
  102.  
  103. Matthew Bloch, for beta testing, and continually pestering me to get it
  104. finished - and for thinking up the name 'NewsHound'.
  105.  
  106. Ralph Corderoy and Tony Houghton for bug reports and a collection of
  107. useful suggestions.
  108.  
  109. And everyone else who's sent me bug reports or useful suggestions!
  110.  
  111. Licence
  112. ~~~~~~~
  113.  
  114. NewsHound is Copyright 1996-7 Joseph Heenan. All rights are reserved.
  115.  
  116. Permission is granted to use NewsHound on the understanding that this use is
  117. entirely at your own risk. I accept no liability whatsoever for any loss or
  118. damage arising from the use of NewsHound nor do I make any guarantee that it
  119. is fit for any purpose. NewsHound may be freely distributed, provided all
  120. files are included and unchanged. No charges may be made for distribution,
  121. and NewsHound may not be distributed on CD's or as part of a package without
  122. the author's express permission.
  123.  
  124.  
  125. Bugs/Comments
  126. ~~~~~~~~~~~~~
  127.  
  128. Please note - the overall speed timings given in this program relate to the
  129. total number of bytes processed so far over the total amount of time since
  130. the start of the fetch. In my view, this is a fair and representive way of
  131. showing the speed of the news download. KA9Q does not calculate speeds in
  132. the same way, and hence the speeds reported by NewsHound *may* well be 
  133. *lower*, even though it *might* be transferring news faster.
  134. [ I'm not sure how FreeNews calculates it's figures. I suspect it may use
  135.   a similar way to ka9q, but I'm not certain]
  136.  
  137. Please send bugs reports and/or suggestions for improvements or constructive
  138. critism to:
  139.  
  140.     joseph@odie.barnet.ac.uk
  141.  
  142. I also read comp.sys.acorn.networking regularly.
  143.