First figure building example

For example, if the rule for building the figure named spectrum is

#define DATA /q2/wz/wz.26.H
FIGDIR/spectrum.v : DATA  myspectrum.x
        <DATA myspectrum.x | Graph > junk.H out=FIGDIR/spectrum.v

and your directory contains a fortran source file named myspectrum.f, then the included rules will compile myspectrum.f and link it to the libraries. In the above rule you can use myspectrum in the place of myspectrum.x. We prefer myspectrum.x, however, because our jclean rule knows about .x files whereas jclean does not know how to identify myspectrum as something that needs to be removed at cleaning time.

Each of our figure-building cakefiles contains the definition of a list of figures that it can build and manipulate. Above, that definition is

        #define FIGLIST data spectrum

The application-specific rules in the cakefile should make FIGDIR/data.v and FIGDIR/spectrum.v (or possibly corresponding postscript files, but for now nearly all our figures are made in the vplot intermediate plot language and SEP.idoc.rules builds the postscript for us.) Because we always include SEP.idoc.rules in any of our figure-building directories we can issue the following commands:

cake burn               # Remove vplot and postscript figures
cake burnps             # Remove only postscript figures
cake figures            # build postscript for all figs
cake vplot              # build vplot for all figs
cake tube               # view all the vplot files
cake otube              # view vplots without rebuilding if out of date
cake idoc               # run thru all push button actions
cake NAME.tube          # view with tube the file FIGDIR/NAME.v
cake NAME.idoc          # do the electronic book action of figure NAME
cake NAME.menu          # pop up a menu of actions for figure NAME
cake install            # install programs in official place