[ xframe-Bugs-1015389 ] documentation of nested element incomplete

Bugs item #1015389, was opened at 2004-08-24 16:43
Message generated for change (Comment added) made by colinguthrie
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=454391&aid=1015389&group_id=48863

Category: all platforms
Group: xsddoc-0.5-beta
Status: Open
Resolution: None
Priority: 5
Submitted By: Kurt Riede (kriede)
Assigned to: Kurt Riede (kriede)
Summary: documentation of nested element incomplete

Initial Comment:
When declaring nested elements in a russion-doll design, 
the nested elements are not listed in the namespace-
overview and the namespace-summary. Furthermore the 
documentation of attributes of nested tags is missing.

In an easy solution, they might be listed in the 
namespace-overview like this:

russianDoll
russianDoll.rdRoot
russianDoll.rdRoot.rdChild1
russianDoll.rdRoot.rdChild2

As a minimum, the links could direct to the 
documentation of the main element.

But simmilar to JavaDoc, it would be more helpfull to 
have a seperate documentation pages for each inner 
declaration. Otherwise it would be quiet complex to 
display and to understand, which attribute is used where.

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

Comment By: Colin Guthrie (colinguthrie)
Date: 2004-09-15 16:11

Message:
Logged In: YES 
user_id=1122390

This seems to work OK for me. Now (very) happily seeing my
nested element documented.

I do get this warning when I start xsddoc:
fatal: :819:82 A node test that matches either NCName:* or
QName was expected.
fatal: :819:82 Extra illegal tokens: 'name', '(', '..', ')',
'=', ''xs:redefine'', ']'

But the error does not actually seem to be fatal after all
as the docs /do/ get generated.

This may be due to some other random CVS related thing or
just my build....

Thanks for developing this tool tho', it's much appreciated.
I like the docs made by XMLSpy but seeing as it doesn't run
on Linux and it costs loads, I can't really use it.

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

Comment By: Kurt Riede (kriede)
Date: 2004-09-03 22:30

Message:
Logged In: YES 
user_id=484961

A first good solution is now available in CVS HEAD.
We are now awaiting feedbach from users before we release a 
new version of xsddoc.

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

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


-------------------------------------------------------
This SF.Net email is sponsored by: thawte's Crypto Challenge Vl
Crack the code and win a Sony DCRHC40 MiniDV Digital Handycam
Camcorder. More prizes in the weekly Lunch Hour Challenge.
Sign up NOW http://ad.doubleclick.net/clk;10740251;10262165;m