home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Tools / usenet / NewsIndex.0.93.README < prev    next >
Encoding:
Text File  |  1994-01-31  |  4.6 KB  |  115 lines
  1. NewsIndex (NewsFilter) [V0.93 by Izumi Ohzawa, izumi@pinoko.berkeley.edu]
  2.  
  3. News filtering and description services for DL indexing of usenet
  4. news articles.  The following two services are implemented.
  5.  
  6. [1] NewsDescribe Service:
  7. Describes news articles based currently on Subject:, From:, and Date: lines.
  8. Some effort has been made to extract full name of the poster from
  9. the From: line.  With this service, when you search in DigitalLibrarian,
  10. titles are listed in the format:
  11.  
  12. Re: DigitalLibrarian indexing service -- (Joe R. Poster), Sun Jan 23 1994 12:39
  13.  
  14. Without this filter, all you see as titles are filenames of news articles and
  15. the beginning of the first line, which aren't informative at all, e.g.,
  16.  
  17. NeXT-Announce.nfold/comp.sys.next.announce.9823 Path: agate!howland.reston.ans.ne
  18.  
  19.  
  20. [2] NewsFilter Service:
  21. Starting with Version 0.93, another service -NewsFilter:... has been added.
  22. The purpose of this filter is to remove junk, such as uuencoded
  23. stuff, Path: ..., and Nntp-posting-host: ... lines  before the
  24. article text is handed over to indexing scanner.  This should reduce
  25. the size of .index.store somewhat (upto 20% compared with Version 0.91).
  26.  
  27. Code is a quick hack, but it should serve a purpose as a starting point
  28. for writing other description filter daemons for DL.
  29.  
  30. Advantage of this Listener daemon scheme over the Unix stdio filter
  31. (invoked via NXUNIXSTDIO port) is that the daemon based filter is
  32. invoked only once per DL indexing session, while stdio filter is
  33. invoked for every article indexed.
  34. Daemons can keep running indefinitely, but this one quits after some
  35. duration of inactivity.
  36.  
  37.  
  38. No Copyright is claimed.
  39. This program is hereby released into the public domain.
  40.  
  41. Benoît Grangé [ben@fizz.fdn.org] distributed a similar daemon
  42. free of charge, but no source code was included in the distribution.
  43. This version has been developed from scratch by myself, and comes with
  44. sources.
  45.  
  46. (Precompiled binary has been tested only under 3.2 Motorola.  With
  47. recompile, it should work for Releases 3.x.  You can also compile FAT
  48. as explained below.)
  49.  
  50. BTW, this thing works with news articles saved by other news readers,
  51. but it assumes that articles are saved in separate files like NewsGrazer does.
  52.  
  53.     Izumi Ohzawa, izumi@pinoko.berkeley.edu.
  54.  
  55. --- To Build FAT binary: --------------------------------------------------------
  56. Launch ProjectBuilder.app, do Project->Open Makefile, and open the Makefile
  57. in this directory.  Select target <Default>, and build!
  58. If there is an error, first select target "clean", build, and then select
  59. target <Default> and build.
  60.  
  61. --- Installation Procedure ------------------------------------------------------
  62. [1] Copy "NewsIndexing.service" folder into
  63. /LocalLibrary/Services or ~/Library/Services.
  64.  
  65. [2] Copy .index.ftype, and .index.swords into
  66. ~/Library/NewsGrazer/NewsFolders directory.
  67. (Enable Unix Expert mode in Preferences, if you don't see these files.)
  68. Replace these files with new ones, even if you used NewsIndex0.9 - 0.91
  69. and already have these in the NewsFolders directory.
  70.  
  71. [3] Patch NewsGrazer so it won't claim *.nfold as its document file
  72. package (This interferes with ixbuild), by  editing out the second
  73. line of __ICON segment __header section.
  74. This patch disables launching of NewsGrazer via double-clicking
  75. *.nfold in FileViewer (of WorkSpace).  I don't use it, but if you
  76. actually rely on this feature, don't do it.
  77. A shell script "patch_NG" is provided for doing this.  Copy this
  78. script into NewsGrazer.app directory, and run it.  If you don't own
  79. NewsGrazer.app directory and its content, you may have to become root.
  80. After the patch, try doing Command-u in WorkSpace while NewsGrazer.app
  81. is selected.
  82.  
  83. NOTE: An alternative to patching is to move NewsGrazer.app to a
  84. directory that is not in the ApplicationPath such as /LocalUtil.  Then,
  85. the *.nfold will not be recognized as doc packages for NewsGrazer.
  86.  
  87.  
  88. [4] Do "make_services" or, logout/relogin or whatever necessary to
  89. make WorkSpace recreate its services cache.  Try doing Command-u in
  90. WorkSpace while ~/Library/Services/NewsIndexing.service (or /LocalLibrary...)
  91. is selected.
  92.  
  93. [5] Cd to ~/Library/NewsGrazer/NewsFolders, and do:
  94.  
  95.     rm .index.store
  96.     ixbuild -gsv -LEnglish .
  97. This will create the first usable index for DL.
  98.  
  99. [6] Start DL and drag ~/Library/NewsGrazer/NewsFolders onto shelf. Save.
  100.  
  101. [7] From this point on, you should be able to update the index from within
  102. DL via the inspector.
  103.  
  104. Have fun.
  105.  
  106. -Izumi
  107.  
  108. ---
  109. Izumi Ohzawa             [ $@Bg_78^=;(J ]
  110. USMail: University of California, 360 Minor Hall, Berkeley, CA 94720
  111. Telephone: (510) 642-6440     Fax:  (510) 642-3323
  112. Internet: izumi@pinoko.berkeley.edu (NeXTMail OK)
  113.  
  114.  
  115.