home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / languages / elisp / misc / gnus-xover-1.2 / README < prev    next >
Encoding:
Text File  |  1993-04-16  |  2.3 KB  |  68 lines
  1. $Id: README,v 1.5 1993/04/15 21:36:31 flee Exp $
  2.  
  3. * Introduction.
  4.  
  5. This kit contains a drop-in replacement for nntp.el in GNUS 3.14.1.
  6. It will probably work with other versions, but not 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 (available from the elisp archive
  26. at archive.cis.ohio-state.edu), which is better than the one
  27. distributed with Emacs 18.  If you don't have Zawinski's byte
  28. compiler, you can uudecode chat.elc.uu and nntp.elc.uu instead.
  29.  
  30.  
  31. * XOVER support.
  32.  
  33. There are two types of news server that support XOVER:
  34.  
  35. 1. INN version 1.3 supports an overview database and XOVER directly.
  36.  
  37. 2. C News/nntpd.  C News needs to be augmented with Geoff Collyer's
  38. nov.dist.tar.Z (available from world.std.com).  nntpd needs to be
  39. augmented with the XOVER patch (included in this distribution), which
  40. should become "standard" with the next release of nntpd.
  41.  
  42.  
  43. * About Xrefs.
  44.  
  45. GNUS relies on the Xref: header to mark crossposted articles
  46. correctly.  By default, the overview database does not include Xref:
  47. information.
  48.  
  49. If you do not have Xref: data, this nntp.el will try to adapt by
  50. grabbing the Xref: header when you retrieve an article.  This works
  51. much of the time, but isn't perfect.  In particular, kill files and
  52. catch-up will not mark crossposted articles correctly.
  53.  
  54. A better idea is to include Xref: data in the overview database.  For
  55. C news/nov.dist, you need to uncomment the line in mkov.c that says:
  56.     /* putextfld("xref", hdrp->h_xref); */
  57. and then rebuild mkov.
  58.  
  59. For INN, you just need to uncomment the line in /news/lib/overview.fmt
  60. that says:
  61.     #Xref:full
  62.  
  63.  
  64. * Feedback.
  65.  
  66. Send bugs, comments to:
  67.     Felix Lee <flee@cs.psu.edu>
  68.