[mod.recipes] how to put your own troff commands in a recipe

reid@glacier.UUCP (Brian Reid) (11/30/85)

If you want to try your hand at the xroff commands, here's the format.
It's based on the manual page macros. I don't really know any troff
commands, and I don't have a manual; I learned troff by reading the files in
/usr/lib/tmac on my machine, and I have no idea how idiomatic they are. This
is extremely simple stuff, so it should all work ok on other machines.

The basic principle is to use as few commands as possible, and in general to
use only commands that are defined in the manual macros or the recipe macro
package. Various processing programs search through these files and look for
string matches on things like ".IG" and ".RZ".

"RECIPE-ID" is the file name under which the recipe will be stored; it must
be 14 characters or less. The "?" is a "what kind of recipe" code that I
will fill in.

.RH MOD.RECIPES-SOURCE RECIPE-ID ? "22 Dec 83" 
.RZ "RECIPE TITLE" "One-line description of it"
Introductory comments; use .PP for new paragraph.
.IH "Serves 13"				<-- Ingredients Header
.IG "1/2 cup" "butter"			<-- Ingredient (please use quotes)
.IG "1" "onion"
(medium to large, chopped fine. Don't try to use instant onion
in this recipe)
.PH					<-- Procedure header
.SK 1					<-- Procedure step
Preheat oven to 600 degrees
.SK 2
Parboil apples, then blend carefully with buckwheat groats
.NX					<-- Notes header
Notes (commentary) goes here; use .PP to separate paragraphs.
.WR					<-- Wrapup
Signature information goes here. A copy of your .signature file is OK,
but remember that there will already be one at the end of your message,
so if that's what you want, then just put the word ".signature" here.


You can also use the following -man macros:

.SS "subsection heading"
.I "italic words"
.B "boldface words"
.SM "small words"
.PP 			<-- paragraph break
.PD <distance>		<-- paragraph distance (.PD 0 and .PD are the two
			    most useful values.)
.IP "indented paragraph".
.RS 			<-- relative start: move things to the right
.RE			<-- relative end: move things left again

You can also use these nroff/troff commands if you know how:

.if
.ds
.br
.ns
.ta 			<-- but be careful (it has to work in nroff too)
.ti			<-- ditto