ftp.nice.ch/peanuts/GeneralData/Documents/literature/RecipeIndex.0.94.README

This is the README for RecipeIndex.0.94.NI.bs.tar.gz [Download] [Browse] [Up]

RecipeIndex  [V0.94 by Izumi Ohzawa, izumi@pinoko.berkeley.edu]

[Archive maintainer: please store this file in the same directory
as Recipes.tar.Z, since this package contains a set of tools to index
recipe files in that collection.  Thanks.]

OS: 3.0 or later
ARCH: MAB (m68k,i386)

This is a Sevice filter daemon for indexing recipe collection in
nroff format available as Recipes.tar.Z at FTP archives.  This is
a replacement (update) for scripts found in Recipes/.index directory
which no longer work for Digital Librarian in NS 3.x or later.
Precompiled FAT binary (m68k,i386) is included.

Nroff-format recipe files themselves are not included, you must
obtain them by getting Recipes.tar.Z from the archives.  There is
no need to modify the original recipe files.  You only have to add
several files to the Recipes database directory from this distribution,
and install indexing tools and display scripts.  From the original
package, only the README file is included here as README-Recipes.orig.

An alternative way to index this thing is to use a nroff2rtf type
converter, which must exist somewhere, while moving the recipe title
to the top of file.  Then again, you will lose such cool features,
e.g., ability to display recipes with metric measurement units with
a simple modification to .displayCommand.

This is a quickly hacked version of the indexing tool for NewsGrazer
articles available as NewsIndex0.93* from the archives.  Only minimal
modifications have been made.  See README-OLD.NewsInex0.93 for info on
details not found in this README file.

CAVEAT:  This indexing service may or may not interfere if you
attempt to index local man pages for DL, because it registers file type
"nr".  If you have trouble indexing new man pages, remove
RecipesIndexing.service.  Since the recipes collection appears to
be static (no new ones avaialble), you might want to remove the
service after you've created the index anyway.

Also for now, you should avoid using Igor.app from AFS
that comes with WriteUp.app (maybe also with PasteUp too).
NS Release 3.2, DigitalLibrarian, ixbuild are not happy
when Igor.app is in /LocalApps or ~/Apps.  You will get
lots of error messages in the console log from ixbuild
and DL saying ascii paste board could not be filtered etc.
This may not necessarily cause apps to mulfunction, but
it is annoying.  The bug, I was told, is in NeXT side of
software, but until that is fixed, you might avoid Igor.app
anyway.


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

[2] Copy the following 6 files:
	.index.ftype
	.index.swords
	.displayCommand
	.roffArgs
	.dir.tiff
	Copyright.rtf
into ~/Library/Recipes directory (or wherever you have
installed nroff recipe files).  (Enable "Unix Expert mode" in
Preferences, if you don't see these files in FileViewer.)

Rename the obsolete .index directory to something else like .index.old
(just in case the old directory is not completely ignored).

[3] Copy xart.awk into /usr/local/lib directory.  Also copy tmac.recip
into /usr/local/lib/tmac.  Create the directories if they do not exist.
[These files and .displayCommand come from rcshow shell script in
the original package written by Brian Reid.]

[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/RecipeIndexing.service (or /LocalLibrary...)
is selected.

[5] Cd to ~/Library/Recipes (or wherever), and do:

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

With the '-v' flag for the ixbuild command, it should print out
filenames being indexed followed by the file type "nr" for nroff
file.  If the file type is not "nr", something is wrong with the
installation.  Possible causes include missing .index.ftype or
RecipeIndexing.service is not correctly installed or the servce is
not yet registered by Workspace (see [4] above).

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

[7] From this point on, you should be able to update the index from within
DL via the inspector (if you ever get new recipes in nroff format).

[8] To display in Metric measurements (grams, milliliters, etc.
instead of lbs, cups), change "-rM0" to "-rM1" in .displayCommand.

[9] Delete the installed RecipeIndexing.service if you are not adding
any new recipes in nroff format (see CAVEAT at the top of file).

[10] Install a tastier .dir.tiff in the Recipes folder than the one
I included from NeXT-icon@gun.com Archives (Tools/Spatula/Spatula.tiff).

No Copyright is claimed for the RecipeIndex/RecipeFilter.
This program is hereby released into the public domain, and you are free
to use it for any purpose including commercial use.
Note the copyright for the original recipes, however.

=================================================================================
For more detailed info on the workings of this daemon and other tips, see
README-OLD.NewsInex0.93.


--- 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.
---------------------------------------------------------------------------------

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