4
***********************************************************************
5
FUNNELWEB MANUAL WEB PAGE
6
=========================
7
Copyright (c) Ross N. Williams 1992,1999. All rights reserved.
9
Permission is granted to redistribute and use this manual in
10
any medium, with or without modification, provided that all
11
notices (including, without limitation, the copyright
12
notice, this permission notice, any record of modification,
13
and all legal notices) are preserved on all copies, that all
14
modifications are clearly marked, and that modified versions
15
are not represented as the original version unless all the
16
modifications since the manual's original release by Ross N.
17
Williams (www.ross.net) consist of translations or other
18
transformations that alter only the manual's form, not its
19
content. THIS MANUAL IS PROVIDED "AS IS" AND WITHOUT ANY
20
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT
21
LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND
22
FITNESS FOR A PARTICULAR PURPOSE. TO THE EXTENT PERMITTED BY
23
LAW THERE IS ABSOLUTELY NO WARRANTY.
25
***********************************************************************
29
<TITLE>1.4 Diagnostics</TITLE>
30
<STYLE TYPE="text/css"> <!-- A {text-decoration: none} // --> </STYLE>
32
<BODY BACKGROUND="binary/background.gif"
41
<TD WIDTH="130" VALIGN="top">
42
<IMG SRC="binary/d_clear.gif" ALT="" WIDTH="130" HEIGHT="1"><BR>
47
<A HREF="http://www.ross.net/"
49
onClick="window.open('','rosshome','location,status,menubar,scrollbars,resizable',false).focus(); return true;"
51
<IMG SRC="binary/rossnet_logo.gif"
52
WIDTH="64" HEIGHT="32"
53
BORDER="0" ALT="RossNet"
54
HSPACE="0" VSPACE="1"></A><BR>
57
<A HREF="../index.shtml"
59
onClick="window.open('','funnelweb','location,status,menubar,scrollbars,resizable',false).focus(); return true;"
61
<IMG SRC="binary/linklogo.gif"
62
WIDTH="64" HEIGHT="32"
63
BORDER="0" ALT="FunnelWeb"
64
HSPACE="0" VSPACE="1"></A><BR>
66
<TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0><TR><TD BGCOLOR="#000000">
67
<A HREF="../tutorial/index.html"
68
TARGET="funnelwebtutorial"
69
onClick="window.open('','funnelwebtutorial','location,status,menubar,scrollbars,resizable',false).focus(); return true;"
70
><FONT COLOR="#FFFFFF"><B>Tutorial</B></FONT></A><BR>
72
<A HREF="../developer/index.html"
73
TARGET="funnelwebdeveloper"
74
onClick="window.open('','funnelwebdeveloper','location,status,menubar,scrollbars,resizable',false).focus(); return true;"
75
><FONT COLOR="#FFFFFF"><B>Developer</B></FONT></A><BR>
77
<A HREF="index.html"><FONT COLOR="#FFFFFF"><B>Reference</B></FONT></A><BR>
78
<A HREF="intro.html"><FONT COLOR="#FFFFFF">1 Introduction</FONT></A><BR>
79
<A HREF="interface.html"><FONT COLOR="#FFFFFF">2 Interface</FONT></A><BR>
80
<A HREF="scanner.html"><FONT COLOR="#FFFFFF">3 Scanner</FONT></A><BR>
81
<A HREF="parser.html"><FONT COLOR="#FFFFFF">4 Parser</FONT></A><BR>
82
<A HREF="analyser.html"><FONT COLOR="#FFFFFF">5 Analyser</FONT></A><BR>
83
<A HREF="tangle.html"><FONT COLOR="#FFFFFF">6 Tangle</FONT></A><BR>
84
<A HREF="weave.html"><FONT COLOR="#FFFFFF">7 Weave</FONT></A><BR>
85
<A HREF="shell.html"><FONT COLOR="#FFFFFF">8 Shell</FONT></A><BR>
86
<A HREF="commands.html"><FONT COLOR="#FFFFFF">9 Commands</FONT></A><BR>
87
<A HREF="glossary.html"><FONT COLOR="#FFFFFF">10 Glossary</FONT></A><BR>
88
<A HREF="references.html"><FONT COLOR="#FFFFFF">11 References</FONT></A><BR>
91
<A HREF="search.html"><FONT COLOR="#FFFFFF"><B>SEARCH</B></FONT></A><BR>
97
<TD WIDTH="360" VALIGN="top">
101
<A HREF="index.html"><IMG SRC="binary/title.gif"
102
WIDTH="316" HEIGHT="24"
103
BORDER="0" ALT="FunnelWeb Reference Manual"
104
HSPACE="0" VSPACE="0"></A>
105
<P><FONT SIZE="5">1.4 Diagnostics</FONT><BR>
108
<P>During execution, FunnelWeb proceeds cautiously with
109
each of its phases, only proceeding with the next phase if
110
the previous phase has been successful. This means that,
111
when debugging a FunnelWeb file, you may find that the
112
number of errors <I>increases</I> after you fix some of
113
them, as you will be exposing yourself to the next FunnelWeb
116
<P>FunnelWeb employs five levels of
117
diagnostics at different
118
levels of severity. Severity is defined in
119
terms of the level of activity at which the diagnostic
120
causes FunnelWeb to abort.
122
<P><BLOCKQUOTE><B>Warning:</B> A
123
warning does not cause FunnelWeb
124
to terminate or curtail its operation in any way, but serves
125
merely to warn the user of particular conditions that might
126
be symptomatic of deeper problems.</BLOCKQUOTE>
128
<P><BLOCKQUOTE><B>Error:</B> An error
129
causes FunnelWeb to terminate processing of the current
130
input file at the end of the current phase. For example, if
131
an error occurs during scanning, FunnelWeb will continue
132
scanning (and possibly generate further scanning
133
diagnostics), but will not invoke the parser.</BLOCKQUOTE>
135
<P><BLOCKQUOTE><B>Severe Error:</B> A
136
severe error (or "severe" for short) is the same as
137
an error except that FunnelWeb terminates the current phase
138
immediately.</BLOCKQUOTE>
140
<P><BLOCKQUOTE><B>Fatal Error:</B> A
141
fatal error causes FunnelWeb not only to terminate the
142
current phase and run immediately, but also to terminate
143
total FunnelWeb processing immediately. A severe error will
144
not cause a FunnelWeb script to terminate, but a fatal error
145
will. A fatal error causes FunnelWeb to return control to
146
the operating system.</BLOCKQUOTE>
148
<P><BLOCKQUOTE><B>Assertion
149
Error:</B> An assertion error
150
occurs if FunnelWeb detects an internal inconsistency, in
151
which case FunnelWeb terminates immediately and
152
ungracefully. Such an error can occur only if there are
153
bugs in FunnelWeb. With luck, such errors will be extremely
156
<P>FunnelWeb indicates the level of severity of each
157
diagnostic that it issues by starting each diagnostic either
158
with the full name of the severity level or with just the
159
first letter of the severity level followed by a colon.
161
<P>FunnelWeb conveys the presence or absence of
162
diagnostics at the operating system level by returning
163
<SAMP>EXIT_SUCCESS</SAMP> status if no
164
diagnostics occurred during the run and
165
<SAMP>EXIT_FAILURE</SAMP> status if one or more diagnostics
166
(including warnings) occurred during the run. (From
167
the symbols of the ANSI standard C library
168
<SAMP>stdlib.h</SAMP>. See <STRONG>[Kernighan88]</STRONG>, p.252.)
174
<TD ALIGN="left" VALIGN="bottom"><A HREF="intro_arch.html"><IMG SRC="binary/fw_left.gif" HEIGHT="32" WIDTH="32" BORDER="0" ALT="Prev"></A></TD>
175
<TD ALIGN="center" VALIGN="bottom"><A HREF="intro.html"><IMG SRC="binary/fw_up.gif" HEIGHT="32" WIDTH="32" BORDER="0" ALT="Up"></A></TD>
176
<TD ALIGN="right" VALIGN="bottom"><A HREF="intro_typesetter.html"><IMG SRC="binary/fw_right.gif" HEIGHT="32" WIDTH="32" BORDER="0" ALT="Next"></A></TD>
185
<A HREF="mailto:webmaster@ross.net">Webmaster</A>
186
<A HREF="copyright.html">Copyright © Ross N. Williams 1992,1999. All rights reserved.</A><BR>
198
<!-- *********************************************************************** -->
199
<!-- End Of A FunnelWeb Manual Web Page (www.ross.net/funnelweb/) -->
200
<!-- *********************************************************************** -->