#12 "@" tags must be placed after comments


This is more of an annoyance because it is not
documented anywhere and it has a major impact.

If any of DTDDoc's attributes are used in a comment,
they MUST come at the end of the comment. If not, any
text that follows them will receive the same formatting.

For example:

@title This is the title

This tag is the root tag and will contain all other
<!ELEMENT rootTag (allOtherTags*)>

This will cause the title format to be applied to the
entire comment. Clearly, DTDDoc treats its attributes
in the same way as WordPerfect treated its format
markers, the only difference being that there is no way
in DTDDoc to indicate where the formatting should end.

At best, it would be nice to have a way to know when an
attribute ends. At worst, the current behaviour needs
to be documented.

WORKAROUND: place all DTDDoc attributes at the end of
the comment.


  • Herve BOUTEMY

    Herve BOUTEMY - 2006-09-01
    • assigned_to: nobody --> hboutemy
    • status: open --> closed-invalid
  • Herve BOUTEMY

    Herve BOUTEMY - 2006-09-01

    Logged In: YES

    This "feature" is like javadoc : since a tag comment can
    span multiple lines, a consequence is that as soon as a tag
    starts, you cannot write any "non tag" comment...

    I changed http://dtddoc.sourceforge.net/documentation.html,
    trying to make this detail more clear : I hope a multi-lines
    tag comment will help


Log in to post a comment.

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.

No, thanks