#12 "@" tags must be placed after comments

closed-invalid
None
5
2006-09-01
2006-09-01
lions2912
No

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
tags
-->
<!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.

Discussion

  • 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
    user_id=449266

    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