ftp.nice.ch/pub/next/tools/usenet/NewsIndex.0.93.README

This is the README for NewsIndex.0.93.NI.bs.tar.gz [Download] [Browse] [Up]

NewsIndex (NewsFilter) [V0.93 by Izumi Ohzawa, izumi@pinoko.berkeley.edu]

News filtering and description services for DL indexing of usenet
news articles.  The following two services are implemented.

[1] NewsDescribe Service:
Describes news articles based currently on Subject:, From:, and Date: lines.
Some effort has been made to extract full name of the poster from
the From: line.  With this service, when you search in DigitalLibrarian,
titles are listed in the format:

Re: DigitalLibrarian indexing service -- (Joe R. Poster), Sun Jan 23 1994 12:39

Without this filter, all you see as titles are filenames of news articles and
the beginning of the first line, which aren't informative at all, e.g.,

NeXT-Announce.nfold/comp.sys.next.announce.9823 Path: agate!howland.reston.ans.ne


[2] NewsFilter Service:
Starting with Version 0.93, another service -NewsFilter:... has been added.
The purpose of this filter is to remove junk, such as uuencoded
stuff, Path: ..., and Nntp-posting-host: ... lines  before the
article text is handed over to indexing scanner.  This should reduce
the size of .index.store somewhat (upto 20% compared with Version 0.91).

Code is a quick hack, but it should serve a purpose as a starting point
for writing other description filter daemons for DL.

Advantage of this Listener daemon scheme over the Unix stdio filter
(invoked via NXUNIXSTDIO port) is that the daemon based filter is
invoked only once per DL indexing session, while stdio filter is
invoked for every article indexed.
Daemons can keep running indefinitely, but this one quits after some
duration of inactivity.


No Copyright is claimed.
This program is hereby released into the public domain.

Benoät GrangÝ [ben@fizz.fdn.org] distributed a similar daemon
free of charge, but no source code was included in the distribution.
This version has been developed from scratch by myself, and comes with
sources.

(Precompiled binary has been tested only under 3.2 Motorola.  With
recompile, it should work for Releases 3.x.  You can also compile FAT
as explained below.)

BTW, this thing works with news articles saved by other news readers,
but it assumes that articles are saved in separate files like NewsGrazer does.

	Izumi Ohzawa, izumi@pinoko.berkeley.edu.

--- To Build FAT binary: --------------------------------------------------------
Launch ProjectBuilder.app, do Project->Open Makefile, and open the Makefile
in this directory.  Select target <Default>, and build!
If there is an error, first select target "clean", build, and then select
target <Default> and build.

--- Installation Procedure ------------------------------------------------------
[1] Copy "NewsIndexing.service" folder into
/LocalLibrary/Services or ~/Library/Services.

[2] Copy .index.ftype, and .index.swords into
~/Library/NewsGrazer/NewsFolders directory.
(Enable Unix Expert mode in Preferences, if you don't see these files.)
Replace these files with new ones, even if you used NewsIndex0.9 - 0.91
and already have these in the NewsFolders directory.

[3] Patch NewsGrazer so it won't claim *.nfold as its document file
package (This interferes with ixbuild), by  editing out the second
line of __ICON segment __header section.
This patch disables launching of NewsGrazer via double-clicking
*.nfold in FileViewer (of WorkSpace).  I don't use it, but if you
actually rely on this feature, don't do it.
A shell script "patch_NG" is provided for doing this.  Copy this
script into NewsGrazer.app directory, and run it.  If you don't own
NewsGrazer.app directory and its content, you may have to become root.
After the patch, try doing Command-u in WorkSpace while NewsGrazer.app
is selected.

NOTE: An alternative to patching is to move NewsGrazer.app to a
directory that is not in the ApplicationPath such as /LocalUtil.  Then,
the *.nfold will not be recognized as doc packages for NewsGrazer.


[4] Do "make_services" or, logout/relogin or whatever necessary to
make WorkSpace recreate its services cache.  Try doing Command-u in
WorkSpace while ~/Library/Services/NewsIndexing.service (or /LocalLibrary...)
is selected.

[5] Cd to ~/Library/NewsGrazer/NewsFolders, and do:

	rm .index.store
	ixbuild -gsv -LEnglish .
This will create the first usable index for DL.

[6] Start DL and drag ~/Library/NewsGrazer/NewsFolders onto shelf. Save.

[7] From this point on, you should be able to update the index from within
DL via the inspector.

Have fun.

-Izumi

---
Izumi Ohzawa             [ $@Bg_78^=;(J ]
USMail: University of California, 360 Minor Hall, Berkeley, CA 94720
Telephone: (510) 642-6440     Fax:  (510) 642-3323
Internet: izumi@pinoko.berkeley.edu (NeXTMail OK)


These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.