
Messages
hsc is able to produce lots of different warnings and
errors when parsing html-files. The messages alway look the same:
"file" (line#, colum#), class and message-id, message
with
file input file that caused message; file names surrounded by
"[" and "]" indicate pseudo-filenames like macros.
line#, position in input file that caused error
colum#
class one of Note, Warning, Error or Fatal error
message message text
Message Classes
Note is a message only for the
users information. It can be suppressed using IGNORE.
Bad style informs the user that
his altough legal HTML-code includes constructs that indicate a bad style.
It can be suppressed using IGNORE.
Warning tells you that your source
includes some problematic parts, that can lead to problems with several
browsers.
It can be suppressed using IGNORE.
Error indicates that there is something
wrong with your HTML-source. No output is written.
Fatal error tells you that something
terrible has happened and there is no way to continue the conversion.
No output is written.
Note: I've already started to collect the messages, but
this list is not yet complete.
-
fatal
1 : out of memory
-
There is not enough memory available. Free some memory and restart
hsc again.
-
fatal
2 : write error
-
An error occured writing the output file or some of hsc's own
files. Usualy, the cause of the error should be displayed with
this message.
-
fatal
3 : unexpected end of file
-
There are still characters to be read from input, but the file
already ends. Usualy, hsc tells you what it still expects to come.
-
error
4 :
-
Undocumented.
-
error
5 :
-
Undocumented.
-
fatal
6 : can not open file for input
-
An input file could not been opened. A more detailed message that tells
you why is displayed, too.
-
error
7 :
-
Undocumented.
-
error
8 :
-
Undocumented.
-
error
9 :
-
Undocumented.
-
style
10 : "click here" syndrome detected
-
A keyword defined with the global attribute
__CLICK_HERE__
has been found within the text inside an anchor specification.
Ok, now again in english: you used some term like "Click here" inside
the text describing a link. This is very clumsy and should be avoided;
see Composing
Good HTML for details.
-
error
11 : unknown tag <tag>
-
You refered to an unknown tag or macro.
-
error
12 : tag <tag> occured too often
-
A tag that is expected to occure only once appeared at least twice.
Remove all unneccessary occurences of the tag.
-
warning
13 : unmatched closing tag <tag>
-
You called a closing tag without using the corresponding opening tag
before.
-
warning
14 : illegal closing tag nesting
-
Undocumented.
A closing tag appeard where a different closing tag was expected to
appear before. Example: instead of
<B><I>bold and italic</B></I>
you should write
<B><I>bold and italic</I></B>
-
warning
15 : required tag <tag> missing
-
A tag that is required for every document is missing.
-
warning
16 : closing tag <tag> missing
-
You called an opening tag, but didn't close it. Insert the required
closing tag.
-
error
17 :
-
Undocumented.
-
warning
18 : unknown entity
-
You used an entity, that hsc doesn't know. This can happen if you
made a typo, or the entity has not been defined within
hsc.prefs.
-
error
19 :
-
Undocumented.
-
error
20 : reference to unknown attribute
-
You referered to an attribute that doesn't exist at all.
-
warning
21 : path to URI not found: file
-
A tag points to a local resource that doesn't exist.
-
warning
22 : argument without quote
-
You passed a value to an attribute, but did not embed it into single
or double quotes. This is not legal, altough many browser support it.
-
error
23 : empty reference to attribute attrib
-
An attribute referes to an attribute that has been defined, but no
value has been set for. Usually, you try to refer to an attribute
inside a macro, that no value has been passed to within the call
of the macro.
-
error
24 :
-
Undocumented.
-
style
25 : <BLINK> sucks
-
Some browser support the non-HTML-tag <BLINK>. It is used
to make text blinking, which annoys many users. Additionally, most
of them don't know how to configure their browser that it doesn't
blink, so you really should avoid it.
-
error
26 : default value for attribute attrib already set
-
You tried to set the default value for an attribute twice. Nasty guy!
-
error
27 : no default value for boolean attribute attrib allowed
-
You tried to set a default value to a boolean attribute. A boolean attribute
can't have any values, it can only appear or not appear.
-
error
28 :
-
Undocumented.
-
error
29 :
-
Undocumented.
-
error
30 : unmatched ">"
-
A "greater than" sign appeared inside the text. You should write
"
>" instead.
-
error
31 :
-
Undocumented.
-
error
32 :
-
Undocumented.
-
error
33 :
-
Undocumented.
-
error
34 :
-
Undocumented.
-
error
35 : unknown value value for enumerator attribute attrib
-
You tried to set an enumerator to a value it can't have.
-
warning
36 : suspicious value value for attribute attrib
-
Same as Error 35; but this time, "*" is part of the enumerator values.
That means, the enumerator has some predefined values, but if you are
a jerk, you can use other values, too (Example:
ALIGN
within <IMG>.
-
warning
37 : tag <tag> is obsolete
-
The tag was defined within some old HTML-version, but should
not be used any more (eg. <LISTING>).
-
warning
38 : tag <tag> is only used by jerks
-
This tag is no legal HTML-tag and is only supportet by special
browsers.
-
note
39 :
-
-
error
40 :
-
Undocumented.
-
error
41 :
-
Undocumented.
-
error
42 :
-
Undocumented.
-
error
43 : unknown attribute option option
-
You defined a new attribute, but used an
option that is unknown.
-
error
44 : required attribute attrib missing
-
An attribute that is required has not been set within the call
of a tag or macro.
-
error
45 :
-
Undocumented.
-
note
46 : replaced char by entity
-
Informs you that a special character (non-7-bit-ASCII) has been replaced
by it's corresponding entity.
-
error
47 :
-
Undocumented.
-
error
48 :
-
Undocumented.
-
error
49 :
-
Undocumented.
-
error
50 :
-
Undocumented.
-
note
51 : quote found inside text
-
A quote has been found inside the text. This doesn't indicate
any problems, I think, but can someone tell me why the invented
"
""?
-
error
52 :
-
Undocumented.
-
error
53 :
-
Undocumented.
-
error
54 :
-
Undocumented.
-
error
55 :
-
Undocumented.
-
error
56 :
-
Undocumented.
-
error
57 :
-
Undocumented.
-
error
58 :
-
Undocumented.
-
error
59 :
-
Undocumented.
-
error
60 : tag <tag> must be inside tag <tag>
-
Before you are allowed to use the first tag, the second tag has to
occure before. Example: <INPUT> may only occure
inside <FORM>.
-
error
61 : tag <tag> not allowed within tag <tag>
-
A tag occures inside another tag that doesn't allowe this. For example,
you can't recursively use <A> inside <A>.
-
error
62 : no attributes allowed for closing tags
-
You tried to pass values to a closing tag or macro. If you need an attribute
for a closing macro only, you still have to define and pass it within the
opening macro.
-
warning
63 : redefinance of attribute attrib
-
You redefined an alredy existing attribute. If this occures during
the definition of a new macro, you just tried to give to arguments the
same name. Within <$LET>, you should use the flag
$UPDATE
to avoid this message.
-
error
64 :
-
Undocumented.
-
error
65 :
-
Undocumented.
-
error
66 : illegal closing tag
-
You tried to use a simple tag as a container.
-
error
67 :
-
Undocumented.
-
error
68 :
-
Undocumented.
-
error
69 :
-
Undocumented.
Thomas Aglassinger (
agi@sbox.tu-graz.ac.at
), 21-Dec-1995