Qt Documentation

Qt 5.8
QDoc Manual
Document Structure

Document Structure

The document structuring commands are for dividing your document into sections. QDoc supports six kinds of sections: \part, \chapter, \section1, \section2, \section3, and \section4. The \section1..4 commands are the most useful. They correspond to the traditional section, subsection, etc used in outlining.

\part

The \part command is intended for use in a large document, like a book.

In general a document structuring command considers everything that follows it until the first line break as its argument. The argument is rendered as the unit's title. If the title needs to be spanned over several lines, make sure that each line (except the last one) is ended with a backslash.

In total, there are six levels of sections in QDoc: \part, \chapter, \section1, \section2, \section3 and \section4. \section1 to \section4 correspond to the traditional section, subsection, subsubsection and subsubsubsection.

There is a strict ordering of the section units:

For example, a section1 unit can only appear as the top level section or inside a chapter unit. Skipping a section unit, for example from part to section1, is not allowed.

You can begin with either of the three: part, chapter or section1.

/ *!
    \part Basic Qt

    This is the first part.


        \chapter Getting Started

        This is the first part's first chapter.


            \section1 Hello Qt

            This is the first chapter's first section.


            \section1 Making Connections

            This is the first chapter's second section.


            \section1 Using the Reference Documentation

            This is the first chapter's third section.


        \chapter Creating Dialogs

        This is the first part's second chapter.


            \section1 Subclassing QDialog

            This is the second chapter's first section.

            ...


    \part Intermediate Qt

    This is the second part.


        \chapter Layout Management

        This is the second part's first chapter.


            \section1 Basic Layouts

            This is the first chapter's first section.

    ...
* /

QDoc renders this as:

Basic Qt

This is the first part.

Getting Started
This is the first part's first chapter.
Hello Qt

This is the first chapter's first section.

Making Connections

This is the first chapter's second section.

Using the Reference Documentation

This is the first chapter's third section.

Creating Dialogs

This is the first part's second chapter.

Subclassing QDialog

This is the second chapter's first section.
...
Intermediate Qt

This is the second part.

Layout Management

This is the second part's first chapter.

Basic Layouts

This is the first chapter's first section.
...

Each section is a logical unit in the document. The section heading appears in the automatically generated table of contents that normally appears in the upper right-hand corner of the page.

\chapter

The \chapter command is intended for use in larger documents, and divides the document into chapters.