reid@decwrl (Brian Reid) (03/03/86)
COOKBOOK(1) UNIX Programmer's Manual COOKBOOK(1)
NAME
cookbook: rckeep, rcbook.t, rcbook.n, rctypeset, rcnroff -
Store and print the mod.recipes USENET Cookbook
SYNOPSIS
rckeep < /usr/spool/news/mod/recipes/? (or s |rckeep from a
news-reading program.)
rcbook.t to typeset a cookbook from saved recipes
rcbook.n to nroff a cookbook from saved recipes
DESCRIPTION
The USENET Cookbook is an online database distributed in the
mod.recipes newsgroup. This software makes it easy for you
to clip recipes that interest you, to store them in your own
directory, and to make printed cookbooks from those stored
recipes.
SAVING RECIPES
Read the news with your favorite news reading program. If
you don't have a favorite, try rn. When you see a recipe
that interests you, type
s |rckeep
The ``s'' command means ``save''; the vertical bar means
``save into a program''. rckeep is the program that keeps
recipes. It will save recipes into a directory named
Recipes, and it will create that directory for you if it
does not currently exist. If you would like recipes saved in
some other place, you can type
s |rckeep PartyRecipes
s |rckeep ~/PartyRecipes
s |rckeep /usr/local/lib/Recipes
and so forth. From time to time, an entry will come through
in mod.recipes that is labeled PATCH. This is not a recipe,
but an update to a previously-posted recipe. If you use
rckeep in the regular way, i.e. type s |rckeep, it will
apply the patch(1) program to update your stored copy of the
recipe.
HOW RECIPES ARE SAVED
Every recipe is given a code word by the editor of
mod.recipes. That code word is contained in the first few
lines of the article body. The rckeep program uses the code
word as a file name in your keep directory. For example, if
you are saving a recipe whose 1-line description is
PHEASANT-PERRY - Pheasant for Thanksgiving
it will be saved in your keep directory under the filename
``pheasant-perry''. These filenames are forced to lower
case by rckeep.
MAKING A COOKBOOK
To typeset a cookbook, just type
rcbook.t
Printed 2/28/86 27 Nov 85 1
COOKBOOK(1) UNIX Programmer's Manual COOKBOOK(1)
and all of the recipes in your keep directory will be
typeset in alphabetical order, with an index, introduction,
and title page added. If you don't have a typesetter or if
you don't have the troff(1) program, then use ``rcbook.n''
instead; it uses nroff(1).
If you have more than one keep directory, for specialty
cookbooks of different types, you can give rcbook a direc-
tory name as an argument, e.g.:
rcbook.t /usr/local/lib/Recipes
COPYRIGHT
The entire USENET cookbook is copyrighted by the USENET Com-
munity Trust. The purpose of this copyright is to prevent
commercial use of the material. The USENET Community Trust
permits any noncommercial use of the contents of the recipe
database, and forbids any commercial use.
FILES
/usr/spool/news/mod/recipes USENET recipe directory
$HOME/Recipes Your keep directory (saved recipes)
/usr/local/bin/rc* The recipe software
SEE ALSO
recipes(5), rn(1), patch(1),
AUTHOR
Brian K. Reid, DEC Western Research Laboratory
Printed 2/28/86 27 Nov 85 2recipes@decwrl.UUCP (05/29/86)
COOKBOOK(1) UNIX Programmer's Manual COOKBOOK(1)
NAME
cookbook: rckeep, rckeepnew, rcbook.t, rcbook.n, rctypeset,
rcnroff - Store and print the mod.recipes USENET Cookbook
SYNOPSIS
rckeep < filename copies a recipe to your keep directory
s |rckeep (same thing, from a news-reading program.)
rckeepnew [ directory ] finds and keeps new recipes
rcbook.t [ -t ] [ -m ] [ -M ] typesets a cookbook from kept
recipes
rcbook.n [ -m ] [ -M ] nroffs a cookbook from kept
recipes
rctypeset [ -m ] [ -M ] typesets one recipe from std input
rcnroff [ -m ] [ -M ] nroffs one recipe from std input
rcnew.t [ -m ] [ -M ] typesets new kept recipes
rcnew.n [ -m ] [ -M ] nroffs new kept recipes
DESCRIPTION
The USENET Cookbook is an online database distributed in the
mod.recipes newsgroup. This software makes it easy for you
to clip recipes that interest you, to store them in your own
directory, and to make printed cookbooks from those stored
recipes.
SAVING RECIPES ONE AT A TIME
Read the news with your favorite news reading program. If
you don't have a favorite, try rn. When you see a recipe
that interests you, type
s |rckeep
The ``s'' command means ``save''; the vertical bar means
``save into a program''. rckeep is the program that keeps
recipes. It will save recipes into a directory named
Recipes, and it will create that directory for you if it
does not currently exist. If you would like recipes saved in
some other place, you can type
s |rckeep PartyRecipes
s |rckeep ~/PartyRecipes
s |rckeep /usr/local/lib/Recipes
and so forth.
SAVING NEW RECIPES AUTOMATICALLY
If you don't want to take the time and trouble to run rckeep
on every recipe, you can run rckeepnew from time to time.
When rckeepnew is run, it looks in the netnews spooling
directory to find the files that hold the articles that hold
the recipes, and automatically runs rckeep on every file
that contains a recipe and that has arrived since the last
time you ran rckeepnew. Like rckeep, rckeepnew can be given
the name of a directory to use as the keep directory:
rckeepnew
or
rckeepnew /usr/local/lib/Recipes
and so forth.
HOW RECIPES ARE STORED
Every recipe is given a code word by the editor of
mod.recipes. That code word is contained in the first few
lines of the article body. The rckeep and rckeepnew programs
use that code word as a file name in your keep directory.
For example, if you are saving a recipe whose 1-line
description is
PHEASANT-PERRY - Pheasant for Thanksgiving
it will be saved in your keep directory under the filename
``pheasant-perry''. These filenames are forced to lower
case by rckeep.
MAKING A COOKBOOK
To typeset a cookbook, just type
rcbook.t
and all of the recipes in your keep directory will be
typeset in alphabetical order, with an index, introduction,
and title page added. They will come out either in English
units (cups and teaspoons) or in metric units (grams and
deciliters) depending on how the mod.recipes software has
been installed at your site. If you want to print the cook-
book in English units regardless of what the software
installer did, then type
rcbook.t -M
and if you want to print the cookbook in metric units
regardless of what the software installer did, then type
rcbook.t -m
If you don't have a typesetter or if you don't have the
troff(1) program, then use ``rcbook.n'' instead; it uses
nroff(1). and sends the results of the formatting to stan-
dard output. It supports the same -m and -M options that
rcbook.t does.
If you have more than one keep directory, for specialty
cookbooks of different types, you can give rcbook a direc-
tory name as an argument, e.g.:
rcbook.t /usr/local/lib/Recipes
You can capture the output of rcbook.t in a file by using
the ``-t'' option:
rcbook.t -t > FormattedFile
PRINTING ONE RECIPE
The program rctypeset typesets one recipe, from its standard
input. It is able to discard news and mail headers from the
beginning of the recipe; you may use rctypeset on a netnews
message in the form that it is stored in a spooling direc-
tory, or you may use it directly from a news-reading pro-
gram. rctypeset supports the metric (-m) and non-metric (-M)
options explained above.
The program rcnroff performs the same function as rctypeset,
except that it formats to standard output instead of to the
typesetter.
PRINTING NEW RECIPES
It is a nuisance to keep track of which recipes you have
printed and which you have not. It is expensive and slow to
print the entire cookbook every time a few more recipes
arrive. The rcnew.t program works very much like rcbook.t,
except that it typesets only those recipes that were put
into the keep directory after the last time you ran rcnew.t.
It produces a complete new index, though. It uses the crea-
tion time of the file INDEX in your keep directory to deter-
mine the last time you created an index, which is presumably
the last time you ran rcbook.t or rcnew.t. rcnew.t supports
the metric (-m) and non-metric (-M) options explained above.
The program rcnew.n does the same thing as rcnew.t, except
that it formats to standard output instead of to the
typesetter.
COPYRIGHT
The entire USENET cookbook is copyrighted by the USENET Com-
munity Trust. The purpose of this copyright is to prevent
commercial use of the material. The USENET Community Trust
permits any noncommercial use of the contents of the recipe
database, and forbids any commercial use.
FILES
/usr/spool/news/mod/recipes USENET recipe directory
$HOME/Recipes Your keep directory (saved
recipes)
$HOME/Recipes/.keepnew Record of when rckeepnew last
run
$HOME/Recipes/INDEX Record of when rcnew last run
/usr/bin/rc* The recipe software
SEE ALSO
recipes(5), rn(1)
AUTHOR
Brian K. Reid, DEC Western Research Laboratoryreid@decwrl (Brian Reid) (11/28/86)
COOKBOOK(1) UNIX Programmer's Manual COOKBOOK(1)
NAME
cookbook: rckeep, rckeepnew, rcbook.t, rcbook.n, rctypeset,
rcnroff - Store and print the mod.recipes USENET Cookbook
SYNOPSIS
rckeep < filename copies a recipe to your keep directory
s |rckeep (same thing, from a news-reading program.)
rckeepnew [ directory ] finds and keeps new recipes
rcbook.t [ -t ] [ -m ] [ -M ] [ -f ] typesets a cookbook
from kept recipes
rcbook.n [ -m ] [ -M ] nroffs a cookbook from kept
recipes
rctypeset [ -m ] [ -M ] [ -f ] typesets one recipe from
std input
rcnroff [ -m ] [ -M ] nroffs one recipe from std input
rcnew.t [ -m ] [ -M ] [ -f ] typesets new kept recipes
rcnew.n [ -m ] [ -M ] nroffs new kept recipes
DESCRIPTION
The USENET Cookbook is an online database distributed in the
mod.recipes newsgroup. This software makes it easy for you
to clip recipes that interest you, to store them in your own
directory, and to make printed cookbooks from those stored
recipes.
SAVING RECIPES ONE AT A TIME
Read the news with your favorite news reading program. If
you don't have a favorite, try rn. When you see a recipe
that interests you, type
s |rckeep
The ``s'' command means ``save''; the vertical bar means
``save into a program''. rckeep is the program that keeps
recipes. It will save recipes into a directory named
Recipes, and it will create that directory for you if it
does not currently exist. If you would like recipes saved in
some other place, you can type
s |rckeep PartyRecipes
s |rckeep ~/PartyRecipes
s |rckeep /usr/local/lib/Recipes
and so forth.
SAVING NEW RECIPES AUTOMATICALLY
If you don't want to take the time and trouble to run rckeep
on every recipe, you can run rckeepnew from time to time.
When rckeepnew is run, it looks in the netnews spooling
directory to find the files that hold the articles that hold
the recipes, and automatically runs rckeep on every file
that contains a recipe and that has arrived since the last
time you ran rckeepnew. Like rckeep, rckeepnew can be given
the name of a directory to use as the keep directory:
rckeepnew
or
rckeepnew /usr/local/lib/Recipes
and so forth.
HOW RECIPES ARE STORED
Every recipe is given a code word by the editor of
mod.recipes. That code word is contained in the first few
lines of the article body. The rckeep and rckeepnew programs
use that code word as a file name in your keep directory.
For example, if you are saving a recipe whose 1-line
description is
PHEASANT-PERRY - Pheasant for Thanksgiving
it will be saved in your keep directory under the filename
``pheasant-perry''. These filenames are forced to lower
case by rckeep.
MAKING A COOKBOOK
To typeset a cookbook, just type
rcbook.t
and all of the recipes in your keep directory will be
typeset in alphabetical order, with an index, introduction,
and title page added. They will come out either in English
units (cups and teaspoons) or in metric units (grams and
deciliters) depending on how the mod.recipes software has
been installed at your site. If you want to print the cook-
book in English units regardless of what the software
installer did, then type
rcbook.t -M
and if you want to print the cookbook in metric units
regardless of what the software installer did, then type
rcbook.t -m
If you don't have a typesetter or if you don't have the
troff(1) program, then use ``rcbook.n'' instead; it uses
nroff(1). and sends the results of the formatting to stan-
dard output. It supports the same -m and -M options that
rcbook.t does.
If you have more than one keep directory, for specialty
cookbooks of different types, you can give rcbook a direc-
tory name as an argument, e.g.:
rcbook.t /usr/local/lib/Recipes
You can capture the output of rcbook.t in a file by using
the ``-t'' option:
rcbook.t -t > FormattedFile
PRINTING ONE RECIPE
The program rctypeset typesets one recipe, from its standard
input. It is able to discard news and mail headers from the
beginning of the recipe; you may use rctypeset on a netnews
message in the form that it is stored in a spooling direc-
tory, or you may use it directly from a news-reading pro-
gram. rctypeset supports the metric (-m) and non-metric (-M)
options explained above.
The program rcnroff performs the same function as rctypeset,
except that it formats to standard output instead of to the
typesetter.
PRINTING NEW RECIPES
It is a nuisance to keep track of which recipes you have
printed and which you have not. It is expensive and slow to
print the entire cookbook every time a few more recipes
arrive. The rcnew.t program works very much like rcbook.t,
except that it typesets only those recipes that were put
into the keep directory after the last time you ran rcnew.t.
It produces a complete new index, though. It uses the crea-
tion time of the file INDEX in your keep directory to deter-
mine the last time you created an index, which is presumably
the last time you ran rcbook.t or rcnew.t. rcnew.t supports
the metric (-m) and non-metric (-M) options explained above.
The program rcnew.n does the same thing as rcnew.t, except
that it formats to standard output instead of to the
typesetter.
SPECIAL CHARACTERS
Troff has a number of special characters, such as such as
typeset fractions (``1/2'' for 1/2), which are not available
on some brands of typesetters and laser printers. If your
typesetter handles those characters incorrectly, then you
should add the ``-f'' option to rcbook.t, rctypeset, and
rcnew.t. The ``-f'' option causes the recipe software to
translate those special characters into standard ASCII char-
acters before printing.
COPYRIGHT
The entire USENET cookbook is copyrighted by the USENET Com-
munity Trust. The purpose of this copyright is to prevent
commercial use of the material. The USENET Community Trust
permits any noncommercial use of the contents of the recipe
database, and forbids any commercial use.
FILES
/usr/spool/news/mod/recipes USENET recipe directory
$HOME/Recipes Your keep directory (saved
recipes)
$HOME/Recipes/.keepnew Record of when rckeepnew last
run
$HOME/Recipes/INDEX Record of when rcnew last run
/usr/local/bin/rc* The recipe software
SEE ALSO
recipes(5), rn(1)
AUTHOR
Brian K. Reid, DEC Western Research Laboratory