DO NOT REPLY [Bug 11388] New: - In XML and XSLT for building tag library docs, add "default" for non-required attrs

[bu...@apache.org]

DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG 
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://nagoya.apache.org/bugzilla/show_bug.cgi?id=11388>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND 
INSERTED IN THE BUG DATABASE.

http://nagoya.apache.org/bugzilla/show_bug.cgi?id=11388

In XML and XSLT for building tag library docs, add "default" for non-required attrs

           Summary: In XML and XSLT for building tag library docs, add
                    "default" for non-required attrs
           Product: Struts
           Version: Nightly Build
          Platform: Other
        OS/Version: Other
            Status: NEW
          Severity: Enhancement
          Priority: Other
         Component: Documentation
        AssignedTo: struts-dev@jakarta.apache.org
        ReportedBy: dmkarr@earthlink.net


Since we have this nice XML format for describing the tag libraries and their
documentation, we should avoid adding "boilerplate" strings that could easily be
"codified" by XML data and XSLT processes.

Therefore, for tag attributes which are not required, allow an optional
"default" element that contains the value of the attribute if not specified. 
This is especially useful when the question is important enough to include a
"[...]" marker in the attribute description, like for the "method" attribute of
the "form" tag.  The XSLT stylesheet should be easily enhanced to check for
"default" and add "[" + value + "]" to the end of the description field.

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>