0README


ALT.GOURMAND RECIPES AND PROGRAMS, PORTED TO MACOSX

recipes
|-- 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 - jar mods of alt-gorumand software
|   |-- Programs		programs: format recipes, make Cookbook
|   `-- Recipes			recipes from rupley in alt.gourmand style
|-- Cookbook		Cookbooks from alt.gourmand and rupley recipes
|-- Programs		test of Mac OS X programs to make Cookbook
|-- Recipesa		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, with use of man macros
and special recipe macros. They are generally embedded in a newsgroup
article. The alt.gourmand software provided program scripts to strip
away the article header and footer, and to format the recipe text,
generally as PostScript (troff) or ascii text (nroff), so generating 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.

Additionally, the structure of "rcbook.t" was changed, to incorporate
into one file various actions of alt.gourmand programs, including:
"rcnew", "rcindex", "rcextract", and "rcintro".

Software that runs under Mac OS X is in the directory "./Programs".
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 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
