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 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE>hsc - Messages</TITLE>
<LINK REV="owns" TITLE="Thomas Aglassinger" HREF="mailto:agi@giga.or.at">
<LINK REL="Next" HREF="envvar.html">
<LINK REL="Copyright" HREF="copy.html">
<LINK REL="Previous" HREF="fileargs.html">
<META name="ROBOTS" content="NOINDEX, NOFOLLOW">
</HEAD>
<BODY>
<A HREF="index.html"><IMG SRC="image/main.gif" ALT="Contents" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<IMG SRC="image/noindex.gif" ALT="-----" ALIGN="middle" WIDTH="70" HEIGHT="16">
<A HREF="copy.html"><IMG SRC="image/copy.gif" ALT="Copyright" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<A HREF="index.html"><IMG SRC="image/back.gif" ALT="Up" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<A HREF="fileargs.html"><IMG SRC="image/prev.gif" ALT="Previous" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<A HREF="envvar.html"><IMG SRC="image/next.gif" ALT="Next" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<HR>
<P ALIGN="right"><I>What happened to the attitude you used to have at school<BR>What happened to the attitude when you broke all the rules</I><BR>
(The Farm, "Groovy Train")
</P>
<H1>Messages</H1>
<P><KBD>Hsc</KBD> is able to produce lots of different warnings and errors
when parsing hsc-sources. The are divided into several classes, and
there is a possibility to filter out specific messages or whole
message classes. There are also possibilities to change the appearance
of messages and redirect them to a file, making it easy to integrate
<KBD>hsc</KBD> into existing developer environments.</P>
<P>[ <A HREF="#message.1">1-10</A>
| <A HREF="#message.11">11-20</A>
| <A HREF="#message.21">21-30</A>
| <A HREF="#message.31">31-40</A>
| <A HREF="#message.41">41-50</A>
| <A HREF="#message.51">51-60</A>
| <A HREF="#message.61">61-70</A>
| <A HREF="#message.71">71-80</A>
| <A HREF="#message.71">81-..</A>
]
</P>
<H2><A NAME="elements">Message Elements</A></H2>
For example, a typical message could be:
<PRE>hugo.hsc (17,23): Warning 11: unknown tag <SEPP></PRE>
with being..<UL>
<LI>..<CODE>hugo.hsc</CODE> the name of the input file that caused the message.
<LI>..<CODE>17</CODE> and <CODE>23</CODE> the position
in input file. 17 denotes the line, and 23 the column of the
item that caused the message
<LI>..<CODE>Warning</CODE> the message class. There are several other
messages classes: <A HREF="messages.html#msg_note">Note</A>, <A HREF="messages.html#msg_style">Bad-style</A>, <A HREF="messages.html#msg_port">Portability-problem</A>, <A HREF="messages.html#msg_err">Error</A> or <A HREF="messages.html#msg_ferr">Fatal error</A>.
See below for details about those message classes.
<LI>..<CODE>11</CODE> the number of the message. You can use this to
quickly find the description of the message (see below) or to
suppress it in further runs using <A HREF="options.html#ignore"><KBD>IGNORE</KBD></A>.
<LI>..<CODE>unknown tag <SEPP></CODE> the message text, which describes what
went wrong.
</UL>
<H2><A NAME="classes">Message Classes</A></H2>
<P><STRONG><A NAME="msg_note">Note</A></STRONG> is a message only for the
user's information. It can be suppressed using <CODE><A HREF="options.html#ignore">IGNORE</A></CODE>.</P>
<P><STRONG><A NAME="msg_style">Bad-style</A></STRONG> informs the user
that his although legal html-code includes constructs that indicate a
bad style. It can be suppressed using <CODE><A HREF="options.html#ignore">IGNORE</A></CODE>.</P>
<P><STRONG><A NAME="msg_port">Portability-problem</A></STRONG> informs
the user that his although legal html-code includes constructs can
lead to problems on old or buggy browsers. It can be suppressed using
<CODE><A HREF="options.html#ignore">IGNORE</A></CODE>.</P>
<P><STRONG><A NAME="msg_warn">Warning</A></STRONG> tells you that your
source includes some problematic parts, that can lead to problems with
several browsers. It can be suppressed using <CODE><A HREF="options.html#ignore">IGNORE</A></CODE>.</P>
<P><STRONG><A NAME="msg_err">Error</A></STRONG> indicates that there
is something wrong with your html-source. Conversion will continue,
but no output will written be written after finishing it.</P>
<P><STRONG><A NAME="msg_ferr">Fatal error</A></STRONG> tells you that something
terrible has happened and there is no way to continue the conversion.
No output will be written.</P>
<P>There is also another class called <STRONG>internal error
messages</STRONG>, which are used by <KBD>hsc</KBD> to report that something
unexpected happened. To find out more about this, look at the chapter
about ``<A HREF="bugs.html">Known Bugs, Problems And Limitations</A>''.</P>
<H2><A NAME="options">Message Options</A></H2>
There are several CLI options to modify the behavior of <KBD>hsc</KBD>'s
messages:
<UL>
<LI><A HREF="options.html#ignore"><KBD>IGNORE</KBD></A> can be used to suppress single messages or whole
message classes, if you are not interested in them
<LI><KBD><A HREF="options.html#msgformat">MSGFORMAT</A></KBD>
specifies the appearance of messages, for example concerning the
sequence of the elements described before.
<LI><KBD><A HREF="options.html#msgformat">MSGFILE</A></KBD> can be used to
redirect messages into a file, from where they can be processed
for example by some message parser that controls your editor
<LI><KBD><A HREF="options.html#msgformat">MSGANSI</A></KBD> tells
<KBD>hsc</KBD> to insert a few ANSI escape sequences to make messages easier to
read. This only makes sense if you refuse use a message browser as
suggested above, and only let them show up on the screen.
</UL>
<HR>
<H2><A NAME="list">List Of Messages</A></H2>
Below you can find a list of messages that can show up when processing
hsc sources. Most of them also include a short explanation what could
have caused the problem and how to fix it.
However, this is not a html-tutorial. Fully
understanding these messages requires some experience from the user.
<DL>
<DT><A NAME="message.1"><STRONG>warning
1: unable to open project-file</STRONG></A><DD>
The project-file specified could not been open. This indicates
no problem, if you specified a project-file using <A HREF="options.html#prjfile"><KBD>PRJFILE</KBD></A>
the first time; it will be created automatically after the
html-object has successfully been processed.
<DT><A NAME="message.2"><STRONG>fatal error
2: project-file corrupt</STRONG></A><DD>
The data found in the project file are not of the required
form. Most likely, the file-format-version is outdated.
Remove the old file, <KBD>hsc</KBD> will create a new one next time it
is invoked.
<DT><A NAME="message.3"><STRONG>fatal error
3: unexpected end of file</STRONG></A><DD>
There are still characters to be read from input, but the file
already ends; <KBD>hsc</KBD> tells you what it still expects to come.
<DT><A NAME="message.4"><STRONG>fatal error
4: error reading <I>file</I></STRONG></A><DD>
On attempting to read from an input file, an error has occured. This
usually is on a hardware level, and can only be fix by one of those
tools to validate and repair a disk structure common on every
platform.
<DT><STRONG>message 5:</STRONG><DD>Unused or undocumented.
<DT><A NAME="message.6"><STRONG>fatal error
6: can not open <I>file</I> for input</STRONG></A><DD>
An input file could not be opened. A more detailed description that
tells you why is displayed, too.
<DT><A NAME="message.7"><STRONG>note
7: stripped tag <<I>tag</I>></STRONG></A><DD>
Notifies user that a tag has been removed. This usually happens
because the user requested this with one of the CLI-options.
<DT><STRONG>message 8:</STRONG><DD>Unused or undocumented.
<DT><A NAME="message.9"><STRONG>bad style
9: expected heading <CODE><Hx></CODE></STRONG></A><DD>
A heading should not be more than one level below the heading
which preceded it. That is, an <CODE><H3></CODE> element should not
follow an <CODE><H1></CODE> element directly. The first heading
showing up in a document should be <CODE><H1></CODE>.
<DT><A NAME="message.10"><STRONG>bad style
10: "click here" syndrome detected</STRONG></A><DD>
A keyword defined with the special attribute <CODE>HSC.CLICK-HERE</CODE>
has been found within the text inside an anchor specification.<P>
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 <A HREF="http://www.cs.cmu.edu/~tilt/cgh/index.html#linktext">Composing
Good HTML</A> for details.
<DT><A NAME="message.11"><STRONG>error
11: unknown tag <<I>tag</I>></STRONG></A><DD>
You refered to an unknown tag or macro.
<DT><A NAME="message.12"><STRONG>error
12: tag <<I>tag</I>> occured too often</STRONG></A><DD>
A tag that is expected to occure only once appeared at least twice.
Remove all unneccessary occurences of the tag.
<DT><A NAME="message.13"><STRONG>error
13: unmatched end-tag <<I>tag</I>></STRONG></A><DD>
You called a end-tag without using the corresponding start-tag
before.
<DT><A NAME="message.14"><STRONG>warning
14: illegal end-tag nesting</STRONG></A><DD>
A end-tag appeared where a different end-tag was expected to
appear before. Example: instead of
<PRE>
<B><I>bold and italic</B></I>
</PRE>
you should write
<PRE>
<B><I>bold and italic</I></B>
</PRE>
Note the different location of <CODE></I></CODE> in both cases.
<DT><A NAME="message.15"><STRONG>warning
15: required tag <<I>tag</I>> missing</STRONG></A><DD>
A tag that is required for every document is missing.
<DT><A NAME="message.16"><STRONG>warning
16: end-tag <<I>tag</I>> missing</STRONG></A><DD>
You called an start-tag, but didn't end it. Insert the required
end-tag.
<DT><A NAME="message.17"><STRONG>error
17: unknown tag modifier <I>/modifier</I></STRONG></A><DD>
You have used an unknown <A HREF="macro/flag.html">modifier</A>
to define the characteristics of an tag or macro.
<DT><A NAME="message.18"><STRONG>warning
18: unknown entity</STRONG></A><DD>
You used an entity, that <KBD>hsc</KBD> doesn't know. This can happen if you
made a typo, or the entity has not been defined within
<I>hsc.prefs</I>.
<DT><A NAME="message.19"><STRONG>warning
19: ";" expected after entity</STRONG></A><DD>
Entities require a semicolon (``<CODE>;</CODE>'') to end them. For instance, if you try
to use ``<CODE>&uuml</CODE>'' instead of
``<CODE>&uuml<STRONG>;</STRONG></CODE>'' (to get an
``<CODE>ü</CODE>'', this message will show up. Simply append the
``<CODE>;</CODE>'' to fix it.
<DT><A NAME="message.20"><STRONG>error
20: unknown attribute <I>attrib</I></STRONG></A><DD>
You tried to access an attribute which has not been defined before.
<DT><A NAME="message.21"><STRONG>warning
21: path to URI not found: <I>file</I></STRONG></A><DD>
An attribute refers to a local resource (like another document or
image) that doesn't exist. Common reasons for that are typos, a
case-sensitive file system or indeed a missing file.
<DT><A NAME="message.22"><STRONG>warning
22: argument without quote</STRONG></A><DD>
You passed a value to an attribute, but did not embed it into single
or double quotes. This can lead to problems with older browsers.
<DT><A NAME="message.23"><STRONG>error
23: empty reference to attribute <I>attrib</I></STRONG></A><DD>
An attribute refers 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.
<DT><A NAME="message.24"><STRONG>warning
24: attribute option ``<I>option</I>'' not allowed in this context</STRONG></A><DD>
You have used an <A HREF="macro/attrib.html#modifier">option</A>
to define the characteristics of an attribute, which is not allowed to
appear at this location.
<DT><A NAME="message.25"><STRONG>bad style
25: <CODE><BLINK></CODE> sucks</STRONG></A><DD>
Some browser support the non-html-tag <CODE><BLINK></CODE>. 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.
<DT><A NAME="message.26"><STRONG>error
26: default value for attribute <I>attrib</I> already set</STRONG></A><DD>
You tried to assign more than one default value within an attribute declaration.
For instance, like in
<PRE>
<$define HUGO:string="hugo"="or sepp?">
</PRE>
Remove the part corresponding to ``<CODE>="or sepp?"</CODE>''.
<DT><A NAME="message.27"><STRONG>error
27: attempt to modify constant attribute <I>attrib</I></STRONG></A><DD>
You tried to assign a new value to an attribute declared as constant.
That is, the <A HREF="macro/attrib.html#modifier">attribute option</A>
<CODE>/CONST</CODE> has been specified when defining it earlier.
<DT><A NAME="message.28"><STRONG>fatal error
28: no content within current context</STRONG></A><DD>
You tried to call <A HREF="features/spctags.html#content"><CODE><$content></CODE></A> outside any container macro.
<DT><A NAME="message.29"><STRONG>error
29: tag <A> without HREF or NAME</STRONG></A><DD>
An anchor tag has been specified without one of the required attributes
<CODE>HREF</CODE> or <CODE>NAME</CODE>.
<DT><A NAME="message.30"><STRONG>error
30: unmatched ">"</STRONG></A><DD>
A "greater than" sign appeared inside the text. You should write
"<CODE>&gt;</CODE>" instead. This can also happen, if you made
an error calling a tag, and <KBD>hsc</KBD>'s parser couln't recover.
<DT><A NAME="message.31"><STRONG>error
31: expected "<I>element_expected</I>", found "<I>element_found</I>"</STRONG></A><DD>
A syntax element did not occur where it has been expected.
<DT><STRONG>message 32:</STRONG><DD>Unused or undocumented.
<DT><A NAME="message.33"><STRONG>warning
33: linefeed found inside string</STRONG></A><DD>
<DT><STRONG>message 34:</STRONG><DD>Unused or undocumented.
<DT><A NAME="message.35"><STRONG>error
35: unknown value <I>value</I> for enumerator attribute <I>attrib</I></STRONG></A><DD>
You tried to set an enumerator to a value it doesn't support.
<DT><A NAME="message.36"><STRONG>warning
36: server relative URI to <I>uri</I></STRONG></A><DD>
<P>An URI-attribute started with a slash (``<CODE>/</CODE>'') (like for example
``<CODE>/image/next.png</CODE>''), denoting a so called server relative URI.
This is a really braindead concept, which might help to save a few
bytes in your html-object, but will make your documents unreadable
if stored on your local disk, as they depend on a specific server
structure.</P>
<P>Normally, <KBD>hsc</KBD> is unable to validate links or obtain image sizes
of data referenced using server relative URIs because of reasons that
should be obvious to everyone.</P>
<P>If you because of some obscure reasons (or simply stupidity) insist
on using URIs of such kind, you can set the CLI option <A HREF="options.html#serverdir"><KBD>SERVERDIR</KBD></A>
to specifiy the root directory for server relative URIs.</P>
<DT><A NAME="message.37"><STRONG>warning
37: tag <<I>tag</I>> is obsolete</STRONG></A><DD>
The tag was defined within some old html-version, but should
not be used any more (eg. <CODE><LISTING></CODE>).
<DT><A NAME="message.38"><STRONG>warning
38: tag <<I>tag</I>> is only used by jerks</STRONG></A><DD>
This tag is no legal html-tag and is only supported by special
browsers.
<DT><A NAME="message.39"><STRONG>error
39: <I>custom user message</I></STRONG></A><DD>
This text and class of this message can be controlled by the
user using <A HREF="features/spctags.html#message"><CODE><$message></CODE></A>.
<DT><A NAME="message.40"><STRONG>fatal error
40: can not open preferences file</STRONG></A><DD>
The file <I>hsc.prefs</I> could not be found at any of the
<A HREF="features/prefs.html#search">expected locations</A>.
<DT><A NAME="message.41"><STRONG>warning
41: unknown environment variable ``<I>envvar</I>''</STRONG></A><DD>
The function <A HREF="features/expressions.html#getenv"><CODE>GetEnv()</CODE></A>
could not access the environment variable specified an returned an
empty value.
<DT><A NAME="message.42"><STRONG>error
42: missing value for attribute <I>attrib</I></STRONG></A><DD>
Non-boolean attributes require an value set.
<DT><A NAME="message.43"><STRONG>error
43: unknown attribute option <I>option</I></STRONG></A><DD>
You defined a new attribute, but used an
<A HREF="macro/attrib.html#modifier">option</A> that is unknown.
<DT><A NAME="message.44"><STRONG>error
44: required attribute <I>attrib</I> missing</STRONG></A><DD>
An attribute that is required has not been set within the call
of a tag or macro.
<DT><A NAME="message.45"><STRONG>warning
45: unexpected value for attribute <I>attrib</I>: expected ``<I>value</I>'', found ``<I>value</I>''</STRONG></A><DD>
This message can show up if you have specified <A HREF="options.html#getsize"><KBD>GETSIZE</KBD></A> when invoking <KBD>hsc</KBD>,
and have set the attribute <CODE>WIDTH</CODE> and/or <CODE>HEIGHT</CODE> by
hand. It denotes that the values you have used differ from those <KBD>hsc</KBD> has
evaluated from the image data.
<DT><A NAME="message.46"><STRONG>note
46: replaced <I>char</I> by <I>entity</I></STRONG></A><DD>
Informs you that a special character (non-7-bit-ASCII) has been replaced
by it's corresponding entity.
<DT><A NAME="message.47"><STRONG>error
47: illegal white space</STRONG></A><DD>
A white space occurred at a place where it was not supposed to.
<DT><A NAME="message.48"><STRONG>portability problem
48: line feed inside sgml-comment</STRONG></A><DD>
<DT><A NAME="message.49"><STRONG>portability problem
49: ">" inside sgml-comment</STRONG></A><DD>
<DT><A NAME="message.50"><STRONG>portability problem
50: sgml-comment ends inside quotes</STRONG></A><DD>
The messages#48 to #50 point out problems that are known bugs of
several browsers. A general comment on sgml-comments: Try to avoid
them, use the <A HREF="features/spctags.html#comments"><CODE><* <I>comment</I> *></CODE></A>
tag instead.
<DT><A NAME="message.51"><STRONG>warning
51: no entry for document "<I>document</I>" in project data to check id <I>id</I></STRONG></A><DD>
This message is active only if you specified a project file when
invoking <KBD>hsc</KBD> using the option <A HREF="options.html#prjfile"><KBD>PRJFILE</KBD></A>. It tells you that a
reference to an ID inside another document could not be checked
because the document linked to is not mentioned in the project file.
<P>Usually, this happens when you did not process the above mentioned
document with a project file specified before. Do not worry about that
too much, after processing all documents of your project at least
once, this message usually does not show up any more.</P>
If it still is there, then you are refering to documents that are part
of none or another project using another project-file; if so, there is
no work-around for this case.
<DT><STRONG>message 52:</STRONG><DD>Unused or undocumented.
<DT><A NAME="message.53"><STRONG>error
53: unmatched conditional <CODE><$else|$elseif></CODE></STRONG></A><DD>
An <CODE><$else></CODE> tag has been at an unexptected position. Usually,
a single preceding <CODE><$if></CODE> has two or more corresponding <CODE><$else></CODE>
tags assigned.
<DT><A NAME="message.54"><STRONG>warning
54: calling external command returned <I>value</I></STRONG></A><DD>
You have invoked a shell-command using <A HREF="features/exec.html"><CODE><$exec></CODE></A> and it returned a
value unequal to zero, which usually denotes an error while processing
the command. For error analysis, look at the output that the command
(hopefully) has made.
<DT><A NAME="message.55"><STRONG>warning
55: text outside sgml-comment context</STRONG></A><DD>
This message often shows up, if you are not using an even number of
hypens (``<CODE>-</CODE>'') as delimters inside your source. For example,
<PRE><!--------></PRE>
(8 hyphens) works fine, whereas
<PRE><!---------></PRE>
(9 hyphens) will cause problems.
<DT><STRONG>message 56:</STRONG><DD>Unused or undocumented.
<DT><A NAME="message.57"><STRONG>error
57: no start tag for end tag <<I>tag</I>></STRONG></A><DD>
An end tag has been detected without it's corresponding start tag
occuring before.
<DT><A NAME="message.58"><STRONG>portability problem
58: icon-entity <I>entity</I> found</STRONG></A><DD>
Icon-entities are not (yet) widely supported.
<DT><A NAME="message.59"><STRONG>warning
59: redefined tag <<I>tag</I>></STRONG></A><DD>
You have just redefined a tag or macro that has already been
declared before. The previous declaration will be thrown away.
<DT><A NAME="message.60"><STRONG>error
60: tag <<I>tag</I>> must be inside tag <<I>tag</I>></STRONG></A><DD>
Before you are allowed to use the first tag, the second tag has to
occure before. Example: <CODE><INPUT></CODE> may only occure
inside <CODE><FORM></CODE>.
<DT><A NAME="message.61"><STRONG>error
61: tag <<I>tag</I>> not allowed within tag <<I>tag</I>></STRONG></A><DD>
A tag occurs inside another tag that does not allow this. For example,
you can't recursively use <CODE><A></CODE> inside <CODE><A></CODE>.
<DT><A NAME="message.62"><STRONG>error
62: no attributes allowed for end-tags</STRONG></A><DD>
You tried to pass values to a end-tag or macro. If you need an attribute
for a end-macro only, you still have to define and pass it within the
start-macro; the end-macro will have access to all these attributes
and its values.
<DT><A NAME="message.63"><STRONG>warning
63: redefinition of attribute <I>attrib</I></STRONG></A><DD>
You redefined an alredy existing attribute. If this occures during
the definition of a new macro, you just tried to give two arguments the
same name.
<DT><A NAME="message.64"><STRONG>error
64: illegal attribute identifier "<I>attribute_name</I>"</STRONG></A><DD>
You have tried to use an attribute name which contains characters not
allowed for that. Legal characters for attribute names are letters, digits,
underscore (``<CODE>_</CODE>''), period (``<CODE>.</CODE>'') and hyphen (``<CODE>-</CODE>'').
<DT><A NAME="message.65"><STRONG>error
65: unknown binary operator "<I>operator</I>"</STRONG></A><DD>
Within an <A HREF="features/expressions.html">expression</A>,
you have used an binary operator that is not
one of those mentioned in the
<A HREF="features/expressions.html#operators">list of operators</A>.
<DT><A NAME="message.66"><STRONG>error
66: illegal end-tag</STRONG></A><DD>
You tried to use a simple tag as a container, for example <CODE></IMG></CODE>
<DT><A NAME="message.67"><STRONG>bad style
67: recommended tag <<I>tag</I>> missing</STRONG></A><DD>
A tag that ought to appear is missing.
<DT><A NAME="message.68"><STRONG>note
68: unknown filetype</STRONG></A><DD>
<KBD>hsc</KBD> could not <A HREF="features/getsize.html">determine the size</A>
of a link destination.
<DT><A NAME="message.69"><STRONG>error
69: illegal entity definition</STRONG></A><DD>
Somethings wrong with a <A HREF="features/prefs.html#defent"><CODE><$defent></CODE></A> or <A HREF="features/prefs.html#deficon"><CODE><$deficon></CODE></A> call.
<DT><A NAME="message.70"><STRONG>warning
70: can not strip special tag <<I>tag</I>></STRONG></A><DD>
You have tried to strip one of <KBD>hsc</KBD>'s
<A HREF="features/spctags.html">special tags</A> using the CLI-option
<A HREF="options.html#striptags"><KBD>STRIPTAGS</KBD></A>. This does not make much sense, because all these tags
will not show up in the output anyway.
<DT><A NAME="message.71"><STRONG>error
71: illegal numeric value <I>value</I> for attribute <I>attrib</I>/entity</STRONG></A><DD>
A numeric value must only consist of digits. Only integer values are
allowed, therefor even a period (``<CODE>.</CODE>'') must not be used.
<DT><A NAME="message.72"><STRONG>warning
72: illegal color value</STRONG></A><DD>
A color value must fit the template ``<CODE>#rrggbb</CODE>''
or be one of the values declared in the special attribute
<A HREF="features/spcattr.html#colornames"><CODE>HSC.COLOR-NAMES</CODE></A>
defined in <I>hsc.prefs</I>
<DT><STRONG>message 73:</STRONG><DD>Unused or undocumented.
<DT><A NAME="message.74"><STRONG>warning
74: unknown id <I>id</I></STRONG></A><DD>
You forgot to specify the ID mentioned using <CODE><A NAME=..></CODE>,
or just made a typo.
<DT><A NAME="message.75"><STRONG>warning
75: local id <I>id</I> already declared</STRONG></A><DD>
You tried to redefine an ID that has already been declared before within
the current document.
<DT><A NAME="message.76"><STRONG>bad style
76: frames are disgusting</STRONG></A><DD>
This message should need no comment; anyway, read
<A HREF="http://www.useit.com/alertbox/9612.html">Why Frames Suck (Most of the Time)</A>
or
<A HREF="http://www.ummed.edu/pub/i/ijosh/frames/">Why Frames Suck</A>
for more details.
<DT><A NAME="message.77"><STRONG>note
77: replacing icon-entity</STRONG></A><DD>
A icon-entity has been found is was replaced by an <CODE><IMG></CODE>.
This message will only show up if you have passed the CLI option
<A HREF="options.html#iconbase"><KBD>ICONBASE</KBD></A>.
<DT><A NAME="message.78"><STRONG>bad style
78: succeeding white space for tag <<I>tag</I>></STRONG></A><DD>
See below.
<DT><A NAME="message.79"><STRONG>portability problem
79: preceding white space for end tag <<I>tag</I>></STRONG></A><DD>
These two messages point out that instead of (read the underscore (``<CODE>_</CODE>''))
as a blank)
<BLOCKQUOTE>
<CODE><STRONG></CODE>__important__<CODE></STRONG></CODE>
</BLOCKQUOTE>
you better should use
<BLOCKQUOTE>
<CODE><STRONG></CODE>important<CODE></STRONG></CODE>
</BLOCKQUOTE>
<P>It only affects tags like <CODE><A></CODE>, <CODE><TITLE></CODE>, headings and
physical/locigal styles.</P>
<P>This message might seem unreasonable, as according to the
specifications for html-readers such white spaces should be skipped.
However, some browsers fail to do so.
<DT><STRONG>message 80:</STRONG><DD>Unused or undocumented.
<DT><A NAME="message.81"><STRONG>warning
81: value for attribute <I>attrib</I> requires quotes</STRONG></A><DD>
If a attribute value contains any characters other then letters,
digits, period (``<CODE>.</CODE>'') or hyphen (``<CODE>-</CODE>''), it needs to be quoted.
<DT><A NAME="message.82"><STRONG>note
82: changed quotes for attribute <I>attrib</I> from [<I>style</I>] to [<I>style</I>]</STRONG></A><DD>
The quote style has been changed for a specific attribute.
This message will only show up if you have passed the CLI option
<A HREF="options.html#quotestyle"><KBD>QUOTESTYLE</KBD></A>.
<DT><STRONG>message 83:</STRONG><DD>Unused or undocumented.
<DT><A NAME="message.84"><STRONG>warning
84: unknown attribute <I>attrib</I> for tag <<I>tag</I>></STRONG></A><DD>
A tag call contains an unknown attribute, which was not defined with
the corresponding <A HREF="features/prefs.html#deftag"><CODE><$deftag></CODE></A>. This does not denote a serious problem,
as html provides a vast selection of esoteric attributes and browsers
usually ignore unknown attributes, but you should confirm you did not
make a typo.
<DT><A NAME="message.85"><STRONG>error
85: unknown attribute <I>attrib</I> for tag <<I>tag</I>></STRONG></A><DD>
A macro call contains an unknown attribute, which was not defined
with the corresponding <A HREF="macro/macros.html"><CODE><$macro></CODE></A>. As it would not make sense to
pass unknown attributes to macros, this is considered an error.
Look at the macro declaration which attribute you meant.
</DL>
</BODY></HTML>
|