Re: [VE][388] Error Message Feedback

Michael Adams wrote:

> On Fri, 12 May 2006 23:40:58 +0300 (EEST)
> "Jukka K. Korpela" <jkorpela@cs.tut.fi> wrote:
> 
> 
>>On Fri, 12 May 2006, Jan Christian Anker wrote:
>>
>>
>>>The following line in my HTML-coding results in a bunch of
>>>WARNING messages (i.e. no error, but annoyance)
>>><!-- ----------------- Text etc goes here ----------------- -->
>>>The following line validates just fine:
>>><!-- _________________ Text etc goes here _________________ -->
>>

>> Comments considered harmful.)
>>
> 
> 
> Ok, Jukka, I'll bite. Why are comments considered harmful? (I Googled
> and couldn't find any relevant hits.)
> 
Michael I'm with you. I have tried to maintain Jakka's software/HTML 
without comments or documentation. I think Jakka is into job security. 
The real problem with the first comment line is the -- within the 
comment.  Quoting from HTML 4.01 Specification, 3.2.4 Comments

"White space is not permitted between the markup declaration open 
delimiter("<!") and the comment open delimiter ("--"), but is permitted 
between the comment close delimiter ("--") and the markup declaration 
close delimiter (">"). A common error is to include a string of hyphens 
("---") within a comment. Authors should avoid putting two or more 
adjacent hyphens inside comments."

Comments are good. Try - - -

Received on Saturday, 13 May 2006 12:04:20 UTC