[Chameleon-dev] [Bug 743] [Chameleon - doc builder] Button attributes are not all extracted from Button.php

[bugzilla-daemon at www.maptools.org]

http://www.maptools.org/bugzilla/show_bug.cgi?id=743





------- Additional Comments From cthorne at dmsolutions.ca  2004-11-02 10:59 -------
I agree with this paul, this is what I am looking for and should be consider for
the future as Darren suggests (which I also agree with).
-----------------
What is, perhaps, missing is a mechanism for the widgets to declare the contents
of SharedResources in a way that can be validated (as widget attributes are
declared and validated).  I would see this as a useful change as it would allow:

1. more complete automated verification of templates
2. support for automatically documenting SharedResource structure associated
with widgets.
----------------

As for your comment paul about your expectations of what the widget docs have of
the shared resource section. yes there is a sheared resource section, but if you
view for example the Button attribute group you will notice that the Shared
resource section is meant to describe how this user can utilized the shared
resource for that particular widget/attribute group. It also contains examples.
In this section it does not make sense to outline shared resource attributes. 

Personally All attributes related to the widget/attribute group weather they are
used in the widget or strictly in the shared resource should be explained in the
shared resource section.  

Once we have a clear/consistent way a sheared resources is used and/or defined
we can deal with how to document this chameleon feature.

One last comment, in the past I was under the impression that the these Shear
Resources Only attributes could be defined in the widget and a one or two of
these attributes were defined that these attributes would take priority over the
same attributes defined in the Shared Resource. I never tried doing this with
the Text button shared resources, but this was what I thought.

I created a new bug to address the changes that will currently have to de done
on the widget doc xml schema (bug 808) 



------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.