README for contrib/noweb/general

This directory includes all files necessary to build pretzel
prettyprinting filters for noweb.

The main parts of these files comes directly from the noweb
distribution and are copyright by Norman Ramsey. These files are:

    columns.nw
    errors.nw
    getline.nw
    match.nw
    pretty.nw
    strsave.nw

(Permission to include them in the pretzel distribution has been
kindly granted by Norman Ramsey.)

The file pretty.nw contains an API for a noweb prettyprinting function
and an additional main() program that calls this prettyprinter.

An additional file nowebpretzelpp.nw (by Felix Gaertner :-) interfaces
a Pretzel prettyprinter with the noweb prettyprinter API. All objects
of these files (except pretty.nw) are added to the Pretzel library
(libpretzel.a) when you `make release'.  Also, the object file
pretty.o is copied to the Pretzel library directory as nowebpp.o so
that pretzel-it can find it when invoked with the noweb option (-n).


The following make'able targets are defined:

*none* or
prettytest	to make a test prettyprinting filter for noweb

regression	run noweave using prettytest on testcode.nw

clean		clean up all objects
clobber		clean up C sources, header files and executables

release		copy the main nowebpp.o object to the library dir
		and add necessary objects to pretzel library



