1-NOTE


FILES AND PROGRAMS IN THIS DIRECTORY

	formatting of recipes in alt.gourmand style;
	based upon alt.gourmand files and programs;
	but structured differently.

---------------------------------------------------------------------------

RCBOOK.T
	the single program, "rcbook.t" (shell script), generates
	"Cookbook.ps"

	operations of the following alt.gourmand programs are
	included within rcbook.t
		rcextract	
			remove news headers and trailers from recipe posting
		rcindex	
			generate ptx-style index
		rcintro	
			generate cookbook cover page and introductory material
		rcnew.t	
			generate update of cookbook, for newer recipes

	ancillary files used by rcbook.t
		rcbook.cover
			must be available to rcbook.t
		tmac.recip
			man-related macros specific for recipe files
			used in generating rcbook.t from rcbook.t.X;
			see configure.sh


RCTYPESET
	the program "rctypeset" (shell script) formats a single
	file in tmac.recip format;

	script includes alt.gourmand program
		rcextract


MKONE
	the script "Mkone" automates use of rctypeset


MKONE.ALL
	"Mkone.all" is "Mkone" for a set of files

---------------------------------------------------------------------------
[scripts not yet ported to macosx]

MKPSNUP2	
	"Mkpsnup2" rearranges "Cookbook.ps" into "Cookbook.psnup2.ps",
	a file with two logical pages per physical page, with the
	TOC and permuted index immediately following the cover page,
	and with each recipe on a separate physical page even if
	two logical pages in length.

SPELL-CHECK
	"Spell-check" does what it says to a set of input files,
	producing a sorted list of mis-spelled (or unrecognized) words or
	word fragments; only slightly useful.

----------------------------------------------------------------------
[other files]

OOOKBOOK.1
	man page for Cookbook;
	not very relevant after demise of alt.gourmand

RECIPES.5
	how to format a recipe;
	tmac.recip (alt.gourmand) macros;
	relevant

MAST.RECIPE
	"mast.recipe" is what it says;
	fill in the blanks with recipe information

MAST.ADDON
	template where want to link a second (or more) recipes to
	a single recipe header, e.g, a set of brown sauce recipes,
	of pastry recipes, etc.

----------------------------------------------------------------------
[configuration files]

MAKEFILE
	set "Makefile" variables to correct values for system and recipes;
	especially:
		OBJDIR TEMPDIR BOOKTITLE DEFDIR DEFPATH 
		DEFTROFF METRIC EXTRACTOR COVERPAGE 

CONFIGURE.SH
	"configure.sh" does the makefile work, 
	generating the properly configured program scripts:
		rcbook.t.X	->	rcbook.t
		rctypeset.X	->	rctypeset

	and man pages
		cookbook.1.X	->	cookbook.1
		recipes.5.X	->	recipes.5

----------------------------------------------------------------------
----------------------------------------------------------------------

ALT.GOURMAND PROGRAMS DELETED:

	programs included in rcbook.t, rctypeset
		rcextract	
		rcindex	
		rcintro	
		rcnew.t	

	news handling scripts 
		rckeep
		rckeepnew

	scripts generating output with nroff 
		rcshow
		rcnroff (created from rctypeset in old configure.sh)
		rcbook.n (sym-linked to rcbook.t)



----------------------------------------------------------------------


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
