Files
xen/docs/index.rst
T
Andrew Cooper 233f03dd83 docs/sphinx: Fix FUSA indexing
Sphinx complains:

  docs/fusa/index.rst:6: WARNING: toctree contains reference to nonexisting document 'fusa/reqs'
  docs/fusa/reqs/index.rst:6: WARNING: toctree contains reference to nonexisting document 'fusa/reqs/market-reqs'
  docs/fusa/reqs/index.rst:6: WARNING: toctree contains reference to nonexisting document 'fusa/reqs/product-reqs'
  docs/fusa/reqs/index.rst:6: WARNING: toctree contains reference to nonexisting document 'fusa/reqs/design-reqs/arm64'

  docs/fusa/index.rst: WARNING: document isn't included in any toctree
  docs/fusa/reqs/design-reqs/arm64/generic-timer.rst: WARNING: document isn't included in any toctree
  docs/fusa/reqs/design-reqs/arm64/sbsa-uart.rst: WARNING: document isn't included in any toctree
  docs/fusa/reqs/index.rst: WARNING: document isn't included in any toctree
  docs/fusa/reqs/market-reqs/reqs.rst: WARNING: document isn't included in any toctree
  docs/fusa/reqs/product-reqs/arm64/reqs.rst: WARNING: document isn't included in any toctree

Fix the toctrees.

Signed-off-by: Andrew Cooper <andrew.cooper3@citrix.com>
Reviewed-by: Ayan Kumar Halder <ayan.kumar.halder@amd.com>
2024-11-25 13:44:56 +00:00

78 lines
1.7 KiB
ReStructuredText

.. SPDX-License-Identifier: CC-BY-4.0
The Xen Hypervisor documentation
================================
.. note::
Xen's Sphinx/RST documentation is a work in progress. The existing
documentation can be found at https://xenbits.xen.org/docs/
Xen is an open source, bare metal hypervisor. It runs as the most privileged
piece of software on the system, and shares the resources of the hardware
between virtual machines. See :doc:`admin-guide/introduction` for an
introduction to a Xen system.
User documentation
------------------
This is documentation for an administrator of a Xen system. It is intended
for someone who is not necesserily a developer, has installed Xen from their
preferred distribution, and is attempting to run virtual machines and
configure the system.
.. toctree::
:maxdepth: 2
admin-guide/index
Guest documentation
-------------------
This documentation concerns the APIs and ABIs available to guests. It is
intended for OS developers trying to use a Xen feature, and for Xen developers
to avoid breaking things.
.. toctree::
:maxdepth: 3
guest-guide/index
Hypervisor developer documentation
----------------------------------
This is documentation for a hypervisor developer. It is intended for someone
who is building Xen from source, and is running the new hypervisor in some
kind of development environment.
.. toctree::
:maxdepth: 2
hypervisor-guide/index
Unsorted documents
------------------
Documents in need of some rearranging.
.. toctree::
:maxdepth: 2
designs/launch/hyperlaunch
designs/launch/hyperlaunch-devicetree
misc/xen-makefiles/makefiles
misra/index
fusa/index
Miscellanea
-----------
.. toctree::
faq
glossary