Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP Path: utzoo!mnetor!seismo!lll-crg!ames!ucbcad!ucbvax!decvax!decwrl!recipes From: reid@decwrl (Brian Reid) Newsgroups: mod.recipes Subject: How to do your own TRoff commands (last updated 17 Jul 86) Message-ID: <6635@decwrl.DEC.COM> Date: Fri, 28-Nov-86 04:12:18 EST Article-I.D.: decwrl.6635 Posted: Fri Nov 28 04:12:18 1986 Date-Received: Fri, 28-Nov-86 19:40:52 EST Sender: recipes@decwrl.DEC.COM Organization: DEC Western Research Laboratory, Palo Alto, CA Lines: 63 Keywords: automatic monthly posting 6 of 8 Approved: reid@decwrl.UUCP DO YOUR OWN FORMATTING If you put formatting commands in the recipes that you sub- mit, they will go out more quickly, since the editor won't have to do it. It's easy to do. 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 process- ing programs search through these files and look for string matches on things like ``.IG'' and ``.RZ''. Print out a few of the recipe source files from /usr/spool/news/mod/recipes, and then use /usr/local/bin/rctypeset or /usr/local/bin/rcnroff to produce formatted versions of them. Have that at hand when you are formatting your recipe. You can test your formatting by using rctypeset or rcnroff on your draft versions before you submit the recipe. A ``skeleton'' recipe follows. .RH is the recipe header com- mand; it must be the first line of each recipe and it must have 4 arguments. ``RECIPE-ID'' is the file name under which the recipe will be stored. Normally the editor chooses the recipe id, but you can put a suggestion there if you like. It must be 14 characters or less, and must not duplicate any previous or pending recipe id. The ``?'' is a ``what kind of recipe'' code from the code table below. .RH MOD.RECIPES-SOURCE RECIPE-ID ? "22 Dec 83" .RZ "RECIPE TITLE IN CAPITALS" "One-line description of it" Introductory comments; use .PP between paragraphs. .IH "Makes 4 cups" <- 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 Boil the water. <- Text for that step .SK 2 <- and so forth. .NX <- Notes header Notes (commentary) goes here; use .PP to separate paragraphs. .WR <- Wrapup Signature information goes here. As a minimum you should list your name, network address, organization (company, university, etc.), and the city you live or work in. Remember that when you post to a moderated newsgroup, the news software usually forgets to include your .signature file, so you should be sure to include it manually. If it manages to get there twice, I will remove the extra copy. You can also use the following -man macros; see man(7) for the complete list. .I "italic words" .B "boldface words" .SM "small words" .PP <- paragraph break .PD<- paragraph distance .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: \fI, \fB, \fR, .if, .ds, .br, .nf, .fi, and .ta