Comentários são uma construção SGML, e são normalmente válidos apenas dentro de um DTD. Entretanto, como mostrou a Section 3.4, “Voltando para o SGML”, é possível utilizar sintaxe SGML com os seus documentos.
O delimitador para um comentário SGML é o
conjunto de caracteres “--
”.
A primeira ocorrência deste conjunto de caracteres abre
um comentário e a segunda fecha.
Se você já utilizou HTML antes, você pode ter
sido exposto a regras diferentes para comentários. Em
particular, você pode pensar que o conjunto de caracteres
<!--
abre um comentário e que ele
apenas é fechado por um -->
.
Este não é o caso. Muitos dos navegadores web possuem interpretadores HTML quebrados, e irão aceitar isso como válido. Entretanto, os interpretadores SGML utilizados pelo projeto de documentação são muito mais rígidos, e irão rejeitar os documentos que contiverem este erro.
O interpretador SGML irá tratar isto como ele é realmente;
Isto não é um SGML válido, e pode dar mensagens de erro confusas.
E como o exemplo sugere, não escreva comentários como esse.
Esta é uma abordagem (ligeiramente) melhor, mas ele ainda é potencialmente confuso para as pessoas novas no uso do SGML.
Este, e outros documentos, podem ser obtidos em ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/
Para perguntas sobre FreeBSD, leia a
documentação antes de contatar
<questions@FreeBSD.org>.
Para perguntas sobre esta documentação, envie e-mail para
<doc@FreeBSD.org>.