0README

ALT.GOURMAND RECIPES AND PROGRAMS, PORTED TO MACOSX

recipes
|-- 0README		this file
|-- 0NOTE		a complete listing of the files in each directory 
|		   [the following list is of directories only]
|-- ALT-GOURMAND	alt.gourmand 1988 distribution
|   |-- Cookbook		Mac OS X programs: produce alt.gourmand Cookbook
|   |-- Program			1988 alt.gourmand programs: not ported Mac OS X
|   `-- Recipes			recipes from alt.gourmand
|-- RUPLEY		Mac OS X - j.a. rupley mods of alt-gorumand software
|   |-- Programs		programs: format recipes, make Cookbook
|   `-- Recipes			recipes from j.a. rupley in alt.gourmand style
|-- Cookbook		Cookbooks formated from alt.gourmand and rupley recipes
|-- Programs		Mac OS X programs, set up for test to format a Cookbook
|-- Recipes		a few recipes to use in test
|-- bin			executables installed in test
`-- man			man pages installed in test


{See "./0NOTE" for full listing of files in "recipes" hierarchy.]


Brian Reid's newsgroup alt.gourmand was one of the founding groups
of the alt hierarchy.  It is no longer active.  The last postings
and software revisions are from the late 1980's.  Some 500 recipes
were posted.  These are in Unix troff format and use the "man"
macros and special recipe macros. The recipes were generally embedded
in a newsgroup article. The alt.gourmand software provided program
scripts to strip away the article header and footer, to format
the recipe text, generally as PostScript (troff) or ascii text
(nroff), and to generate a Cookbook.

The alt.gourmand distribution is in the hierarchy below the directory,
"./ALT-GOURMAND"


Mac OS X uses GNU versions of the software found in AT&T Documenter's
WorkBench and earlier troff/nroff packages.  Porting the alt.gourmand
software to Mac OS X was straightforward, with:

	adjustment of tmac.recip macros; 
	changes in troff/nroff options; 
	changes in gptx (replaces ptx) options; 
	addition of code to handle French characters, etc., in the indexing;
	changes in some default directory pathnames.

In the version of the recipe software for Mac OS X, there are only two recipe-formatting programs: (1) "rcbook.t"
generates a PostScript-format Cookbook from a set of recipes in
alt.gourmand style ("rcbook.n" is identical to "rcbook.t"); (2)
"rctypeset" formats a single recipe.  The structure of "rcbook.t"
was changed, to incorporate into one file the actions of several
alt.gourmand programs, including: "rcnew", "rcindex", "rcextract",
and "rcintro".  The idiosyncratic merging of several programs into
"rcbook.t" was done because I find it easier to tweak a single
script to produce desired formatter output than to work with separate
scripts that are interdependent.

The Mac Os X version of the recipes software is in the hierarchy under 
"./RUPLEY", where there are also a collection of recipes written in
alt.gourmand style.

The directory "./Programs" has software from "./RUPLEY" that is set
up to run as a test.  For a trial run execute the following from
the command line:

	cd Programs
	# edit Makefile as indicated to adapt to your system 
	make clean
	make configure
	make install
	./rcbook.t	#for Cookbook.ps
	./rcbook.n 	#for Cookbook.nroff

You then should find in the working directory, "./Programs", a
PostScript-format "Cookbook.ps" and an ascii-format "Cookbook.nroff".
View with:

	gv Cookbook.ps
	more Cookbook.nroff


See "./Programs/0NOTE" for:

	brief instructions on how to produce a Cookbook, i.e., how
	to format recipes written in tmac.recip = alt.gourmand
	style;

	how to configure formatting programs, "rcbook.t" and
	"rctypeset";

	how to write a recipe in alt.gourmand style.


John Rupley
rupley@u.arizona.edu -or- jar@rupley.com
30 Calle Belleza, Tucson AZ 85716 - (520) 325-4533; fax - (520) 325-4991
Dept. Biochemistry & Molecular Biophysics, Univ. Arizona, Tucson AZ 85721