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