.\" @(#)using	2.6 12/8/92
.EQ
delim off
.EN
.H1 "Using the preprocessor"
.pp
The preprocessor permits many star definitions to be written in one file;
processing the file results in one .cc file and one .h file for each
class.  However, this is not recommended.
The recommended procedure (the
.i required
procedure if you want Pigi's incremental linking and code viewing
features to work correctly) is to write the definition for a star in
domain XXX with name YYY in file XXXYYY.pl.  Then, running the command
.(c
        ptlang XXXYYY.pl
.)c
will produce the files XXXYYY.cc, XXXYYY.h, and XXXYYY.t.
With this policy, the makefiles can contain the default rules
.(c
        .pt.cc:
                ptlang $<

        .pt.h:
                ptlang $<
.)c     
See the ``common Makefile rules'' file ~ptolemy/common.mk
for how this can be made to work ``in context''.
.pp
The documentation
file
can be printed out using the command ~ptolemy/doc/bin/printpage.
By convention, the documentation file has the name
XXXYYY.t, where XXX is the domain name and YYY is the star name.
The printpage command assumes your PRINTER environment variable is set
to the printer of choice.  The following line in your .cshrc file,
for example, will ensure this:
.(c
setenv PRINTER printer_name
.)c
.EQ
delim $$
.EN
