On 24/02/2011 13:52, Ed Leafe wrote: > On Feb 24, 2011, at 2:22 AM, Werner F. Bruhin wrote: > >> Above are flagged private i.e. "._" which means the doc suppresses them >> but then they contain properties/methods which are used. >> >> Any reason why we could not remove the "_", so they get documented? > > Yes: it indicates that these are not classes designed to be used by > developers. I.e., they are for "internal use only", which is what a leading > underscore is supposed to indicate. 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? e.g. dabo.lib.datanav.Page.EditPage.layout on http://thewinecellarbook.com/daboDocTest/dabo.lib.datanav.Page.EditPage.html Or the Checked property on: http://thewinecellarbook.com/daboDocTest/dabo.ui.dMenuItem.dCheckMenuItem.html 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]
