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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
|
<HTML>
<HEAD>
<!-- This HTML file has been created by texi2html 1.29
from ../tnf/output.tnf on 12 Febuary 2003 -->
<TITLE>Tasks related to generating output - Pretty Printing</TITLE>
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000EE" VLINK="#551A8B" ALINK="#FF0000" BACKGROUND="gifs/bg.gif">
<TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0" VALIGN=BOTTOM>
<TR VALIGN=BOTTOM>
<TD WIDTH="160" VALIGN=BOTTOM><IMG SRC="gifs/elilogo.gif" BORDER=0> </TD>
<TD WIDTH="25" VALIGN=BOTTOM><img src="gifs/empty.gif" WIDTH=25 HEIGHT=25></TD>
<TD ALIGN=LEFT WIDTH="600" VALIGN=BOTTOM><IMG SRC="gifs/title.gif"></TD>
</TR>
</TABLE>
<HR size=1 noshade width=785 align=left>
<TABLE BORDER=0 CELLSPACING=2 CELLPADDING=0>
<TR>
<TD VALIGN=TOP WIDTH="160">
<h4>General Information</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="index.html">Eli: Translator Construction Made Easy</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="gindex_toc.html">Global Index</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="faq_toc.html" >Frequently Asked Questions</a> </td></tr>
</table>
<h4>Tutorials</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="EliRefCard_toc.html">Quick Reference Card</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="novice_toc.html">Guide For new Eli Users</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="news_toc.html">Release Notes of Eli</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="nametutorial_toc.html">Tutorial on Name Analysis</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="typetutorial_toc.html">Tutorial on Type Analysis</a></td></tr>
</table>
<h4>Reference Manuals</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="ui_toc.html">User Interface</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="pp_toc.html">Eli products and parameters</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="lidoref_toc.html">LIDO Reference Manual</a></td></tr>
</table>
<h4>Libraries</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="lib_toc.html">Eli library routines</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="modlib_toc.html">Specification Module Library</a></td></tr>
</table>
<h4>Translation Tasks</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="lex_toc.html">Lexical analysis specification</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="syntax_toc.html">Syntactic Analysis Manual</a></td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="comptrees_toc.html">Computation in Trees</a></td></tr>
</table>
<h4>Tools</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="lcl_toc.html">LIGA Control Language</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="show_toc.html">Debugging Information for LIDO</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="gorto_toc.html">Graphical ORder TOol</a> </td></tr>
</table>
<p>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="fw_toc.html">FunnelWeb User's Manual</a> </td></tr>
</table>
<p>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="ptg_toc.html">Pattern-based Text Generator</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="deftbl_toc.html">Property Definition Language</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="oil_toc.html">Operator Identification Language</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="tp_toc.html">Tree Grammar Specification Language</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="clp_toc.html">Command Line Processing</a> </td></tr>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="cola_toc.html">COLA Options Reference Manual</a> </td></tr>
</table>
<p>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="idem_toc.html">Generating Unparsing Code</a> </td></tr>
</table>
<p>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="mon_toc.html">Monitoring a Processor's Execution</a> </td></tr>
</table>
<h4>Administration</h4>
<table BORDER=0 CELLSPACING=0 CELLPADDING=0>
<tr valign=top><td><img src="gifs/gelbekugel.gif" WIDTH=7 HEIGHT=7 ALT=" o"> </td><td><a href="sysadmin_toc.html">System Administration Guide</a> </td></tr>
</table>
<HR WIDTH="100%">
<CENTER> <A HREF="mailto:elibugs@cs.colorado.edu"><IMG SRC="gifs/button_mail.gif" NOSAVE BORDER=0 HEIGHT=32 WIDTH=32></A><A HREF="mailto:elibugs@cs.colorado.edu">Questions, Comments, ....</A></CENTER>
</TD>
<TD VALIGN=TOP WIDTH="25"><img src="gifs/empty.gif" WIDTH=25 HEIGHT=25></TD>
<TD VALIGN=TOP WIDTH="600">
<H1>Tasks related to generating output</H1>
<P>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="output_4.html"><IMG SRC="gifs/prev.gif" ALT="Previous Chapter" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="output_6.html"><IMG SRC="gifs/next.gif" ALT="Next Chapter" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="output_toc.html"><IMG SRC="gifs/up.gif" ALT="Table of Contents" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT="">
<HR size=1 noshade width=600 align=left>
<H1><A NAME="SEC5" HREF="output_toc.html#SEC5">Pretty Printing</A></H1>
<P>
The module <SAMP>`PrettyPrint'</SAMP> supplies C functions that can be inserted in
PTG patterns to handle line breaks properly. The functions try
to break the current line at the last possible position that precedes the
maximum line width. Furthermore, regions of text can be indented.
<P>
Functions exist to mark line breaks and the begin and end of an
indentation region. These functions can be included into
PTG pattern definitions.
<P>
<DL COMPACT>
<A NAME="IDX46"></A>
<DT><CODE>PP_BreakLine</CODE>
<DD>Specifies, that a line break can be inserted at this point. A line will
only be broken at these points.
<P>
<A NAME="IDX47"></A>
<DT><CODE>PP_Indent</CODE>
<DD><A NAME="IDX48"></A>
<DT><CODE>PP_Exdent</CODE>
<DD><CODE>PP_Indent</CODE> marks the beginning of an indented region. Line feeds
following this function call will not only begin a new line but also indent
the next line by an indentation step,
the width of indentation can be adjusted with a function
discussed later. Indented regions can be nested and are terminated by a call
to the <CODE>PP_Exdent</CODE>-pattern function.
<P>
<A NAME="IDX49"></A>
<DT><CODE>PP_Newline</CODE>
<DD>Forces a line feed thereby inserting the newline sequence. The next line
will be indented properly. The newline character <SAMP>`"\n"'</SAMP> in a
PTG pattern is a shortcut for a call to this output function.
</DL>
<P>
<H4>Examples</H4>
<P>
The following PTG patterns can be used to yield different styles of
indenting for blocks.
Here <CODE>{</CODE> and <CODE>}</CODE> are the symbols that denote the
beginning and end of a block, <CODE>$</CODE> is the insertion point for the
indented block. The first example sets those symbols in a
new line at the indentation level of the outer block:
<P>
<PRE>
Block: "\n{" [PP_Indent]
"\n" $ [PP_Exdent]
"\n}"
Stmt: [PP_BreakLine] $
</PRE>
<P>
The next example also specifies an indented region. Here, the opening
brace is set as last token outside the block, separated with whitespace
instead of a newline:
<P>
<PRE>
Block: " " [PP_BreakLine] "{" [PP_Indent]
"\n" $ [PP_Exdent]
"\n}"
</PRE>
<P>
The third example uses the indentation style commonly known as the
GNU indentation style. Here, the braces are set on a new line, indented
two positions. The indented region then follows indented four positions. To
use this, set the indentation width to two by one of the function calls
discussed later. Then use the following pattern:
<P>
<PRE>
Block: [PP_Indent] "\n{" [PP_Indent]
"\n" $ [PP_Exdent]
"\n}" [PP_Exdent]
</PRE>
<P>
<H4>Additional functions</H4>
<P>
Additional functions exist to influence the behavior of the module.
<P>
<A NAME="IDX50"></A>
<DL COMPACT>
<A NAME="IDX51"></A>
<DT><CODE>PP_SetLineWidth(int width)</CODE>
<DD>Sets the linewidth to the specified value. The default is 80.
<P>
<A NAME="IDX52"></A>
<DT><CODE>PP_SetSoftBreakShortcut(char)</CODE>
<DD>Assigns a character that should behave like a call to
<CODE>PP_LineBreak</CODE>. A good choice for this would be the tab
character. The default is set to the null character what disables
substitution.
<A NAME="IDX53"></A>
<P>
<A NAME="IDX54"></A>
<DT><CODE>PP_SetIndentationWidth(int width)</CODE>
<DD>Sets the amount to indent in one indentation level. Indentation is
normally done by spaces. If a negative value is used, a tab character
will be used for one indentation step (counting as 8 character
positions).
<P>
<A NAME="IDX55"></A>
<DT><CODE>PP_SetEndline(char *endline)</CODE>
<DD>Assigns the given string to be used as end-of-line sequence. Default for
this is <SAMP>`"\n"'</SAMP>. Another good choice would be <SAMP>`"\r\n"'</SAMP>.
</DL>
<P>
All these functions need to be called prior to the start of the output with
one of the following functions. They replace the PTG generated ones, if
PrettyPrinting should be used.
<P>
<A NAME="IDX56"></A>
<DL COMPACT>
<A NAME="IDX57"></A>
<DT><CODE>PP_OutFPtr(FILE *f, PTGNode n)</CODE>
<DD>Outputs the given <SAMP>`PTGNode'</SAMP> to the given file that must
have been opened for output.
<P>
<A NAME="IDX58"></A>
<DT><CODE>PP_OutFile(char *filename, PTGNode n)</CODE>
<DD>Outputs the given <SAMP>`PTGNode'</SAMP> to the named file.
<P>
<A NAME="IDX59"></A>
<DT><CODE>PP_Out(PTGNode n)</CODE>
<DD>Outputs the given <SAMP>`PTGNode'</SAMP> to the standard output.
</DL>
<P>
<H4>Usage of Module</H4>
<P>
To use the pretty printing module, simply include it's name in one of the
<CODE>.specs</CODE> files:
<P>
<PRE>
$/Output/PrettyPrint.fw
</PRE>
<P>
<H4>Restrictions</H4>
<P>
In two cases it is possible that an output line exceeds the given maximal
length:
<UL>
<LI>
A sequence of characters longer than the specified linewidth is
output without intermediate call to <CODE>PP_LineBreak</CODE>.
<LI>
A PTG Pattern contains tab characters that will be counted to have a
width of 1 which of course is not always true.
</UL>
<P>
Additional information about this module and it's implementation can be
obtained by the derivation
<PRE>
$elipkg/Output/PrettyPrint.fw :fwTexinfo :display
</PRE>
<A NAME="IDX60"></A>
<P>
<HR size=1 noshade width=600 align=left>
<P>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="output_4.html"><IMG SRC="gifs/prev.gif" ALT="Previous Chapter" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="output_6.html"><IMG SRC="gifs/next.gif" ALT="Next Chapter" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT=""><A HREF="output_toc.html"><IMG SRC="gifs/up.gif" ALT="Table of Contents" BORDER="0"></A>
<IMG SRC="gifs/empty.gif" WIDTH=25 HEIGHT=25 ALT="">
<HR size=1 noshade width=600 align=left>
</TD>
</TR>
</TABLE>
</BODY></HTML>
|
