[ xframe-Patches-3182629 ] Feature requests 3175990, 3175992, 3175997

"SourceForge.net" <[email protected]> Tue, 08 Mar 2011 09:25:31 +0000
Newsgroups gmane.text.xml.xframe.xsddoc
Message-ID <[email protected]>
Patches item #3182629, was opened at 2011-02-15 19:52
Message generated for change (Comment added) made by kriede
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=454393&aid=3182629&group_id=48863

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: all platforms
Group: xsddoc-1.0
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Christoph Schwarz (cschwarz1)
Assigned to: Kurt Riede (kriede)
Summary: Feature requests 3175990, 3175992, 3175997

Initial Comment:
Dear xsddoc admins/maintainers,

I patched xsddoc version 1.-0 to accomodate my above mentioned feature requests and kindly ask that you integrate the patch into xsddoc.

- Improved command line error handling
- Errors cause xsddoc to exit with code 1
- New command line argument -n|-neDoc sets nested element documentation mode to short, full or full/preformatted text
- Ability to specify and document multiple XML schema documents on the command line

While you are at it, please change the line terminators in the UNIX shell script bin/xssdoc from Windows to UNIX format. (The script won't work with Windows line terminators)

Also can you make a release 1.1 or 1.0.1 ?

If you don't have the time to do all this , I'd be happy to help out if you give me the appropriate rights (I have own SF projects so I know what to do).

thank you
Chris


----------------------------------------------------------------------

>Comment By: Kurt Riede (kriede)
Date: 2011-03-08 10:25

Message:
Hi Chris,

your patch is now applied on my desktop, but not yet checked-in to CVS.

I like your on-the fly generation of a mediator schema for collecting
multiple schema files.

Concerning the handling of nested element documentaion, I am wondering if
we should offer this in general, or at least a part your changes. Here are
my sugestions

(1) pre-tags: I would suggest a new parameter that is used for ALL
documentation, similar to the -noasciiart parameter in xnsdoc
(http://www.buldocs.com/xnsdoc/usage.html)

(2) short or long: I would suggest a new paramter -(e.g. -longDoc) that is
used for all documentation that is currently transformed in
short-documentation mode.

(3) Apache Ant: I will take care of enabeling all new features in the Ant
task. For the multiple schema file feature I hopefully can adopt some code
from xnsdoc.

Please let me know if you agree with my suggestions or if you have
different or further ideas.

Thank you
Kurt

----------------------------------------------------------------------

Comment By: Christoph Schwarz (cschwarz1)
Date: 2011-03-05 02:00

Message:
Hello Kurt,

I uploaded the patch in unified format and also added a patch that removes
DOS line feeds from the xsddoc shell script.

Thanks for taking time. Will there be an official release of these (and
possibly other) changes?

thanks, Chris


----------------------------------------------------------------------

Comment By: Kurt Riede (kriede)
Date: 2011-03-04 22:46

Message:
Hello Chris,

thank you for your patch. Please provide a patch in the unified format
that the Eclipse can Apply Patch Wizzard accepts?
I will the check-in your changes.

Thank you,
Kurt

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=454393&aid=3182629&group_id=48863

------------------------------------------------------------------------------
What You Don't Know About Data Connectivity CAN Hurt You
This paper provides an overview of data connectivity, details
its effect on application quality, and explores various alternative
solutions. http://p.sf.net/sfu/progress-d2d