• Martin Smith's avatar
    qdoc: Add index of obsolete members to obsolete page · 02157fad
    Martin Smith authored
    
    qdoc has been modified to emit a compact list of the
    classes that have one or more obsolete members. The
    command is:
    
    \generatelist obsoletecppmembers
    
    This generates an index of all such classes,
    where each class name is a link to the class's
    subpage of obsolete members. A class's subpage
    of obsolete members is also accessible from the
    class's reference page, but now it is also
    accessible from this index.
    
    Also, The command shown has been added to the
    page obsoleteclasses.html in the generated
    output. This page already contains the index
    of obsolete classes.
    
    Currently, no such output is generated for
    QML types and QML types with obsolete members.
    But qdoc does accept commands for those:
    
    \generatelist obsoleteqmltypes
    
    and
    
    \generatelist obsoleteqmlmembers
    
    ...but qdoc doesn't know what to do with
    those commands yet.
    
    Task-number: QTBUG-30270
    Change-Id: Ia5cd309a3593c231d01cafb8a72fa544aeeb5ab9
    Reviewed-by: default avatarJerome Pasion <jerome.pasion@digia.com>
    02157fad
classes.qdoc 4.33 KiB
/****************************************************************************
**
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file.  Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: http://www.gnu.org/copyleft/fdl.html.
** $QT_END_LICENSE$
****************************************************************************/
/*!
    \group classlists
    \title Class and Function Documentation
    \brief Lists and Indexes of classes, functions, and types.
    Links to indexes and lists for finding class and function
    reference documentation.
    \section2 Class Lists
    \annotatedlist classlists
    \section2 Function Lists
    \annotatedlist funclists
/*!
    \page classes.html
    \title All Classes
    \ingroup classlists
    \brief If you know the name of the class you want, find it here.
    This is a list of all Qt classes. For classes that have been
    deprecated, see the \l{Obsolete Classes} list.
    \generatelist classes
    \sa {All Modules}, {Obsolete Classes}
/*!
    \page annotated.html
    \title Annotated Class List
    \ingroup classlists
    \brief If you don't know the name of the class you want, but you
    know what the class should do, you might try looking here.
    Qt classes with brief descriptions:
7172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
\generatelist annotatedclasses */ /*! \group groups \title Groups Of Related Classes \ingroup classlists \brief If you know what kind of class you want (GUI, painting, I.O, etc), look here. This is a list of functional groups of Qt classes. A class can appear in more than one functional group. \generatelist{related} */ /*! \page hierarchy.html \title Inheritance Hierarchy \ingroup classlists \brief The C++ class inheritance hierarchy for all classes in the Qt API. \generatelist classhierarchy */ /*! \page obsoleteclasses.html \title Obsolete Classes \ingroup classlists \brief Classes and members marked obsolete that should not be used in new code. \section1 C++ classes that are deprecated The following Qt C++ classes are now obsolete. Obsolete classes are no longer maintained. They are provided to keep old source code working, but they can be removed in a future release. We strongly advise against using these classes in new code. \generatelist obsoleteclasses \section1 C++ classes that contain one or more members that are deprecated The following Qt C++ classes contain one or more members that are now obsolete. Obsolete members are no longer maintained. They are provided to keep old source code working, but they can be removed in a future release. We strongly advise against using these obsolete members in new code. Click on a class to see its deprecated members. \generatelist obsoletecppmembers */ /*! \page functions.html \title All Functions \ingroup funclists \brief All documented Qt functions listed alphabetically with a link to where each one is declared. This is the list of all documented member functions and global functions in the Qt API. Each function has a link to the class or header file where it is declared and documented.
141142143144145146147148149150151152153154155156
\generatelist functionindex */ /*! \page namespaces.html \title All Namespaces \ingroup classlists \brief A Qt namespace contains enum types, functions, and sometimes classes. This is a list of the main namespaces in Qt. \generatelist{namespaces} */