[Development] Missing documentation in Qt 5.12

André Pönitz apoenitz at t-online.de
Tue Dec 18 20:43:43 CET 2018


On Tue, Dec 18, 2018 at 11:49:22AM +0000, Eike Ziller wrote:
> 
> 
> > On Dec 18, 2018, at 11:25, Konstantin Shegunov <kshegunov at gmail.com>
> > wrote:
> > 
> > On Tue, Dec 18, 2018 at 9:39 AM Martin Smith <Martin.Smith at qt.io>
> > wrote: I'll argue with you about it being a p1. If the problem is
> > confined to the all-members list, it's not a p1 problem because the
> > information is still there via the inherits links, which are more
> > useful for seeing what is inherited anyway.
> > 
> > You can argue with the people that handled it through the tracker, I
> > don't prioritize bugs. From my point of view, however, it falls
> > strictly into the P1 category - it's a regression from the last
> > version, not an edge-case data loss, and it's pretty embarrassing.
> > 
> > My own opinion is that the all-members list should be removed.
> > 
> > I think no, unless there's another way to search for a method in the
> > hierarchy. Allowing for a somewhat contrived example: Say I'm
> > working with `QTemporaryFile` I know there exists something for
> > checking about it being readable but I don't know exactly from where
> > it comes from, then the all-members page is really useful. That
> > use-case gets even more prominent for classes that implement
> > interfaces and/or that have multiply inherited (e.g. QLabel's
> > indirect inheritance from QPaintDevice).
> 
> This happens to me all the time with classes inheriting from IODevice,
> layouts like QHBoxLayout, and quite some widgets, where the useful
> methods are often spread through the whole hierarchy. Clicking up
> through the hierarchy works, but is not very efficient, the all
> members list is much more convenient.

Same here.

Especially for "feature discovery" one flat list is the best option.

Andre'



More information about the Development mailing list