Le langage SGML/Commentaires

Les commentaires sont utiles pour expliquer la syntaxe ou le contenu sans que les explications appartiennent au contenu du document.

Syntaxe

modifier

Leur syntaxe est basée sur celles des balises spéciales en encadrant le texte du commentaire entre <!-- et -->.

Exemple :

<!-- Un commentaire simple. -->

Cette syntaxe est aussi utilisée en HTML et XML.

Cependant la syntaxe est plus complexe : les commentaires commencent et se terminent par un double tiret à l'intérieur de la déclaration des types de document SGML, comme dans l'exemple ci-dessous qui est un extrait de la déclaration du type des documents XML :

<!SGML "ISO 8879:1986 (WWW)"

     -- SGML Declaration for XML 1.0 --

     -- from: 
        Final text of revised Web SGML Adaptations Annex (TC2) to ISO 8879:1986
        ISO/IEC JTC1/SC34 N0029: 1998-12-06
        Annex L.2 (informative): SGML Declaration for XML

        changes made to accommodate validation are noted with 'VALID:'
     --

     CHARSET
         BASESET "ISO Registration Number 177//CHARSET
                 ISO/IEC 10646-1:1993 UCS-4 with implementation
                 level 3//ESC 2/5 2/15 4/6"
     --
       ...
     --
!>

L'exemple ci-dessus contient 3 commentaires mis en évidence dans la déclaration entre <! et !>.

Cette syntaxe, légale en SGML, mais interdit l'utilisation d'une séquence de tirets dans les commentaires en XML et HTML.