[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Annoying problem: embedded HTML in body of documentation tag

This archive contains answers to questions sent to Unidata support through mid-2025. Note that the archive is no longer being updated. We provide the archive for reference; many of the answers presented here remain technically correct, even if somewhat outdated. For the most up-to-date information on the use of NSF Unidata software and data services, please consult the Software Documentation first.

  • Subject: Annoying problem: embedded HTML in body of documentation tag
  • Date: Fri, 15 Nov 2002 15:53:12 -0500
I mention this only because it is an issue that should be addressed:
personally it seems more of a pain than anything else.

Text that I use to construct the contents of the documentation tag

<documentation>
This is the text I mean
</documentation>


occasionally has embedded html in it, mostly the <b></b> and <i></i>
needed to do paper references.   These tags are technically illegal in
our xml document,    so I am supposed to change the < and > to an entity
and then it will parse.  That, however, changes the meaning of the
string, i.e. HTML no longer thinks they are tags, either.   I could take
the tags out, but then I lose meaning, albeit not a lot.

So could we allow some formatting in the documentation?   Alternatively,
can we allow meaningless tags as far as XML is concerned?


Benno