:navigation-title: Orphans

..  include:: /Includes.rst.txt

..  index:: pair: reST; Orphaned pages
..  _rest-orphans:

==============
Orphaned pages
==============

Usually it is desired to have each and every .rst- file appear in the
menu somewhere. The rendering tool issues warnings if a file is not included.

..  hint::

    If really needed, an .rst file may be tagged as :orphan: right at the beginning.
    This will suppress the warning.


..  code-block:: rst

    :orphan: