This directory contains sources for programs to convert to and from
other display file formats.  Since most sites will not use all the
different file formats, or we may not have written a conversion
program for your favorite format, this file contains a few words on
customizing the directory and rolling your own.

The makefile is conditionalized with "cpp"-like operations.  To
specify that you want a particular conversion, add a #define line
near the beginning of the makefile (e.g., '#define SUNRASTER').  You
can then cause makefile lines to be conditionally included by enclosing
them between '#ifdef SUNRASTER'/'#endif' pairs.  These may NOT be 
nested.  Finally, a program can be added to the list of programs to
compile with a line like '#ifadd SUNRASTER PGMS rastorle.out'

Then, use makedef.awk to process the makefile:
	makedef.awk makefile | into makefile
(Or, if you don't have 'into', 
	makedef.awk makefile >makefile.tmp ; mv makefile.tmp makefile)

You may also have to edit library names, if you have a particular
device, but call its library by a different name than we do.

If you do write a conversion program for a file format that is not 
supported in this distribution, please send it to us, so we can add
it to the distribution, and others will not have to duplicate your 
hard work.  Similarly, if you are thinking of writing a conversion
program, you might send us a note and see if anyone else has already
done one.
