On 24/02/2011 14:28, Ed Leafe wrote: > On Feb 24, 2011, at 7:08 AM, Werner F. Bruhin wrote: > >> Shouldn't then all "mixin" type classes be treated/flagged that way? >> >> I'd prefer not:) as it means a lot more special treatment in the >> documentation, i.e. classes inheriting these mixin's should have methods >> documented from there, no? > > Not necessarily. Most mixins are general purpose, such as dPemMixin, > while the two you cited were for use only within the particular script in > which they are defined. IOW, dPemMixin *is* designed to be used outside of > where it is defined (i.e., every UI class), whereas _dBasePanelMixin is only > an implementation detail of the dPanel classes. > > So, what would everyone want to see in the documentation?
1. do not include at all in documentation _AnyTypeOfClass etc and have no links to members of these from other classes 2. document _AnyTypeOfClass but hide on TOC's and provide links to members of these from other classes 3. ? Werner _______________________________________________ Post Messages to: [email protected] Subscription Maintenance: http://leafe.com/mailman/listinfo/dabo-users Searchable Archives: http://leafe.com/archives/search/dabo-users This message: http://leafe.com/archives/byMID/[email protected]
