/usr/share/doc/pretzel/examples/contrib/noweb/cee.latex/README is in pretzel 2.0n-2-0.3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 | $Id: README,v 1.1 1996/12/16 19:02:09 gaertner Exp $
README for contrib/noweb/cee.latex
A noweb prettyprinter for C using Pretzel
Prerequisites:
--------------
You need:
- the Pretzel system (the new version 2.0x)
- the noweb system
Files:
------
Makefile
README this file
cee.ft formatted tokens for very simple C
cee.fg formatted grammar for very simple C
Using:
------
The files in contrib/noweb/general contain an explanation
about the ideas involved here. All you need is a working version
of pretzel-it.
To use, change the cee.ft and cee.fg files to what you think will be a
good prettyprinting style and then
pretzel-it -n cee prettycee
This will build an executable noweb filter that prettyprints the code
parts according to the specs in cee.ft and cee.fg.
make prettyceetest
to run it on some example noweb files. There's a lot of debugging
information around at the moment. Also, the LaTeX styles of Pretzel
and noweb still bite eachother (working on this). You might want
to look at the same stuff for HTML instead of LaTeX (in directory
contrib/noweb/cee.html).
Ommissions (work to be done):
-----------------------------
o a lot
Help (some is a little outdated):
---------------------------------
o Why does pretzel-it not work?
You have to set environment variables PRETZEL_LIBDIR and
PRETZEL_INCLUDE to the correct paths of your Pretzel
installation (e.g. something line /usr/local/lib/pretzel
and /usr/local/include/pretzel).
o Why does pretzel gobble up newlines when I prettyprint
code?
You probably have a line like
[\t\ \n] // empty
in your formatted token file. This naturally will gobble
up all newlines sent to the prettyprinter by noweb. Pretzel
by itself does not place any newlines into the prettyprinted
output. You have to do this yourself, e.g. by stating
\n NEWL
in your formatted token file and then saying
newl : NEWL ;
in the formatted grammar, where the token newl is again
reduced within a rule that is appropriate for parsing
the newline token.
|