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

Bugs item #1015389, was opened at 2004-08-24 18:43
Message generated for change (Comment added) made by kriede
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: Kurt Riede (kriede)
Date: 2004-09-20 11:21

Message:
Logged In: YES 
user_id=484961

Hi Colin,

the problem seems to be solved.
Could you please retest with current CVS HEAD?

Regards
Kurt


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

Comment By: Colin Guthrie (colinguthrie)
Date: 2004-09-15 18: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-04 00: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: YOU BE THE JUDGE. Be one of 170
Project Admins to receive an Apple iPod Mini FREE for your judgement on
who ports your project to Linux PPC the best. Sponsored by IBM.
Deadline: Sept. 24. Go here: http://sf.net/ppc_contest.php