home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / languages / elisp / packages / gnus-xover / README < prev    next >
Encoding:
Text File  |  1993-06-14  |  2.6 KB  |  75 lines
  1. $Id: README,v 1.6 1993/06/09 20:26:27 flee Exp $
  2.  
  3. * Introduction.
  4.  
  5. This kit contains a drop-in replacement for nntp.el in GNUS 3.14.* and
  6. 3.15.  It may work with other versions, but definitely not with GNUS2.
  7.  
  8. This replacement is marginally faster at parsing nntp output in
  9. general, but the major improvement is it will use the nntp XOVER
  10. extension if available.  With XOVER, entering a newsgroup is
  11. substantially faster: reading and parsing 600 headers takes about 3s
  12. on a Sun-4/20 (but threading is still quite slow).
  13.  
  14. Without XOVER, this kit may not be worth it.  But it should be easy to
  15. try it, and easy to back out from.
  16.  
  17.  
  18. * Installing.
  19.  
  20. 1. Copy chat.el and nntp.el to your elisp directory.  nntp.el is a
  21. direct replacement for the nntp.el that comes with GNUS.  chat.el is
  22. an auxiliary module needed by nntp.el.
  23.  
  24. 2. Byte-compile chat.el and nntp.el, in that order.  It's best if you
  25. use Jamie Zawinski's byte compiler, which is better than the one in
  26. Emacs 18.  This byte compiler is shipped with Emacs 19 and can also be
  27. found at the elisp archive: archive.cis.ohio-state.edu.
  28.  
  29.  
  30. * XOVER support.
  31.  
  32. There are two types of news servers that support XOVER:
  33.  
  34. 1. INN version 1.3 and later supports an overview database and XOVER
  35. directly.
  36.  
  37. Note, there's some bug in INN 1.3 that causes the server to drop the
  38. connection after certain XOVER requests.  If you keep getting "NNTP:
  39. connection closed" messages when talking to INN 1.3 server, then you
  40. probably have this bug.  In this case, you can either upgrade the
  41. server to INN 1.4, or avoid using XOVER.  I don't know of any other
  42. simple workarounds.
  43.  
  44. 2. C News/nntpd.  C News needs to be augmented with Geoff Collyer's
  45. nov.dist.tar.Z (available from world.std.com).  nntpd needs to be
  46. augmented with the XOVER patch (included in this distribution), which
  47. should become "standard" with the next release of nntpd.
  48.  
  49.  
  50. * About Xrefs.
  51.  
  52. GNUS relies on the Xref: header to mark crossposted articles
  53. correctly.  By default, the overview database does not include Xref:
  54. information.
  55.  
  56. If you do not have Xref: data, this nntp.el will try to adapt by
  57. grabbing the Xref: header when you retrieve an article.  This works
  58. much of the time, but isn't perfect.  In particular, kill files and
  59. catch-up will not mark crossposted articles correctly.
  60.  
  61. A better idea is to include Xref: data in the overview database.  For
  62. C news/nov.dist, you need to uncomment the line in mkov.c that says:
  63.     /* putextfld("xref", hdrp->h_xref); */
  64. and then rebuild mkov.
  65.  
  66. For INN, you just need to uncomment the line in /news/lib/overview.fmt
  67. that says:
  68.     #Xref:full
  69.  
  70.  
  71. * Feedback.
  72.  
  73. Send bugs, comments to:
  74.     Felix Lee <flee@cs.psu.edu>
  75.