Bug #918
closed
example tag in eml:documentation
Added by Peter McCartney about 22 years ago.
Updated almost 22 years ago.
Category:
eml - general bugs
Description
Ive noticed at least one place in eml-attribute where the example tag in the
documention inlines the element name as part of the text using > and <
symbols. It seems this practic is generall dropped (for good reason) so we might
want to scan for the odd case where it still exists. I didnt fix it in
eml-attribute because matt currently has that in a branch and i dont know where
the best place to put it is.
oops...the example i saw was actually for a non-leaf node in which it lookes
like someone was trying to show examples for the both the leaf nodes it
contains. so let me rewrite this bug to say:
it seems like we have inconsistent methods for examples for non-leaf nodes. some
are empty, some have text that says in so many words "see examples for child
nodes" and at least one shows an XML snippet. this might make automated
processing of examples difficult if we cant predict whats going to be in there
DONE. Went through all xsd files and rewrote any examples that contained element
names to no longer use those names.
Original Bugzilla ID was 918
Also available in: Atom
PDF