[Zope] What's the difference between <dtml-var and <!--#var

[Brian.Burton@nlynx.com]

Reading the documentation for Zope had me believing that <dtml-var and <!--#var
was different.  Now reading the postings with the subject Is it Just Me, I don't
know if they are different.  Will someone please enlighten me to the difference
and where you would use one over the other (if they are different).  In the
documentation (at the beginning of the DTML reference, it states:

The DTML Tag is supported by three syntaxes.1 This includes the DTML document
templates, server-side includes and Python string formats. When using document
templates from Python, the syntax used depends on the document template class
used (or subclasses). The server-side-include new DTML syntax described here is
used by the classes DocumentTemplate.HTML and DocumentTemplate.HTMLFile.

The syntax formats are shown below:

<dtml-name>

%(name)x

<!--#name-->


I assumed that the last is the server side include format (although you could
not tell by the syntax of the preceding documentation!)
Perhaps this document could be fixed a bit for us newbies?