[1.8.x] Fixed #23903 -- Configured Sphinx to autogenerate django-admin manpage

# One entry per manual page. List of tuples

# (source start file, name, description, authors, manual section).

man_pages = [

    ('contents', 'django', 'Django Documentation', ['Django Software Foundation'], 1)

    ('ref/django-admin', 'django-admin', 'Utility script for the Django Web framework', ['Django Software Foundation'], 1),

]

See :ref:`Localizing the Django documentation <translating-documentation>` if

you'd like to help translate the documentation into another language.

.. _django-admin-manpage:

``django-admin`` man page

-------------------------

Sphinx can generate a manual page for the

:doc:`django-admin </ref/django-admin>` command. This is configured in

``docs/conf.py``. Unlike other documentation output, this man page should be

included in the Django repository and the releases as

``docs/man/django-admin.1``. There isn't a need to update this file when

updating the documentation, as it's updated once as part of the release process.

To generate an updated version of the man page, run ``make man`` in the

``docs`` directory. The new man page will be written in

``docs/_build/man/django-admin.1``.