Details
-
Bug
-
Resolution: Done
-
P1: Critical
-
5.0.0 Beta 1
-
None
-
befde564549ba866076b35c94580300dfa278fcf
Description
Background
Inherited member functions used to be excluded from class refs. However, this is no longer the case. I'm guessing this is either:
- Done so that users can see all available functions, without having to read an ancestor's class ref, or
- A bug in QDoc
There are some bad side-effects:
Issues
- Many benefits of convenience classes are lost – they now look as complicated and intimidating as their abstract ancestors
- Nonsensical listings now exist
- E.g. QStringListModel lists functions such as insertColumn(). "Columns" have no meaning in a list model
- SOME constructors and destructors of ancestor classes are shown too
- E.g. QCommandLinkButton shows destructors for QAbstractButton and QPaintDevice (but strangely, not for QPushButton)
Suggestion
Revert to old Qt 4.8 doc-generation behaviour, so that it's easier to see which functions were introduced or reimplemented by a subclass
Attachments
Issue Links
- is required for
-
QTBUG-27512 Qt 5 Documentation Issues (Meta Bug)
- Closed