A megjegyzések tehát SGML-beli konstrukciók, és általában csak a DTD-ben érvényes a használatuk. A 3.4 Szakaszban viszont láthattuk, hogy az SGML szerkezetei akár a dokumentumokban is használhatóak.
Az SGML megjegyzéseket “--” szimbólumok használatával határolhatjuk el. A szimbólum első előfordulásával kezdjük a megjegyzést és a másodikkal zárjuk le.
Példa 3-8. Általános SGML megjegyzés
<!-- próba megjegyzés -->
<!-- Most a megjegyzés belsejében vagyunk --> <!-- Ez pedig egy másik megjegyzés --> <!-- Így lehet például többsoros megjegyzéseket írni --> <!-- Ez egy másik módja a -- -- többsoros megjegyzések írásának -->
Ha dolgoztunk már korábban HTML kóddal, akkor előfordulhat, hogy más meghatározást láttunk a megjegyzésekre. Ezért tévesen azt gondolhattuk, hogy a megjegyzéseket a <!-- karaktersorozat vezeti be, és csak a --> zárhatja le.
Valójában viszont nem így van. Sok böngésző hibás HTML elemzőt tartalmaz, ezért ezt érvényesnek fogadják el. A Dokumentációs Projektben használt SGML elemzők azonban ennél sokkal szigorúbbak és az ilyen hibás dokumentumokat visszadobják.
Példa 3-9. Hibás SGML megjegyzések
<!-- Most egy megjegyzés belsejében vagyunk -- KÍVÜL VAGYUNK A MEGJEGYZÉSEN! -- ismét megjegyzésben vagyunk -->
Az SGML elemző ezt valahogy így fogja értelmezni:
<!KÍVÜL VAGYUNK A MEGJEGYZÉSEN>
Ez nem szabályos SGML és ráadásul félrevezető hibaüzenetet eredményez.
<!------------------ Ez nem szép dolog! ----------------->
A példa szövege szerint sem javasolt ilyen megjegyzéseket írni.
<!--===================================================-->
Ez már (valamivel) értelmesebb megoldás, de még feláll a veszélye, hogy megtéveszti az SGML-ben járatlan olvasókat.
Tegyünk néhány megjegyzést a korábban készített próba.xml állományunkba, majd az onsgmls segítségével ellenőrizzük, hogy közben érvényes marad.
Tegyünk néhány érvénytelen megjegyzést a próba.xml állományba, majd nézzük meg, hogy az onsgmls milyen hibaüzeneteket ad rájuk.
Ha kérdése van a FreeBSD-vel kapcsolatban, a következő
címre írhat (angolul): <freebsd-questions@FreeBSD.org>.
Ha ezzel a dokumentummal kapcsolatban van kérdése,
kérjük erre a címre írjon: <gabor@FreeBSD.org>.