Naming Things

In general, a title command considers everything that follows it until the first line break as its argument. If the title is so long it must span multiple lines, end each line (except the last one) with a backslash.

Commands

\title

The \title command sets the title for a documentation page, or allows you to override it.

/*!
    \page signalandslots.html

    \title Signals & Slots

    Signals and slots are used for communication between
    objects. The signals and slots mechanism is a central
    feature of Qt, and probably the part that differs most
    from the features provided by other frameworks.

    ...
*/

QDoc renders this as:

Signal and Slots

Signals and slots are used for communication between objects. The signals and slots mechanism is a central feature of Qt and probably the part that differs most from the features provided by other frameworks. ...

See also \subtitle.

\subtitle

The \subtitle command sets a subtitle for a documentation page.

/*!
    \page qtopiacore-overview.html

    \title Qtopia Core
    \subtitle Qt for Embedded Linux

    Qt/Embedded, the embedded Linux port of Qt, is a
    complete and self-contained C++ GUI and platform
    development tool for Linux-based embedded development.
    ...
*/

QDoc renders this as:

Qtopia Core

Qt for Embedded Linux

Qt/Embedded, the embedded Linux port of Qt, is a complete and self-contained C++ GUI and platform development tool for Linux-based embedded development. ...

See also \title.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.