b2bf463ed9
Clean the "Rust" main page by introducing a 'Code documentation" section
to separate it from the rest of the text above.
In addition, introduce the "Rust code documentation" term, which may be
clearer than referring to a potentially unknown tool.
Furthermore, for the HTML case, homogenize both `rustdoc` and
non-`rustdoc` cases and use the term introduced above instead.
Then, always generate the pregenerated version part, since now there
is a section that is always generated and thus makes sense to do so.
Finally, finish the new section with a link to more details about the
Rust code documentation.
The intention is that:
- The non-HTML case mentions the code documentation too, making it
more prominent for readers of non-HTML docs.
- Both HTML cases read more naturally.
- The pregenerated version is always mentioned, since it is likely
useful for readers of non-HTML docs.
Link: https://lore.kernel.org/r/20240818141200.386899-2-ojeda@kernel.org
Signed-off-by: Miguel Ojeda <ojeda@kernel.org>
65 lines
1.6 KiB
ReStructuredText
65 lines
1.6 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
Rust
|
|
====
|
|
|
|
Documentation related to Rust within the kernel. To start using Rust
|
|
in the kernel, please read the quick-start.rst guide.
|
|
|
|
|
|
The Rust experiment
|
|
-------------------
|
|
|
|
The Rust support was merged in v6.1 into mainline in order to help in
|
|
determining whether Rust as a language was suitable for the kernel, i.e. worth
|
|
the tradeoffs.
|
|
|
|
Currently, the Rust support is primarily intended for kernel developers and
|
|
maintainers interested in the Rust support, so that they can start working on
|
|
abstractions and drivers, as well as helping the development of infrastructure
|
|
and tools.
|
|
|
|
If you are an end user, please note that there are currently no in-tree
|
|
drivers/modules suitable or intended for production use, and that the Rust
|
|
support is still in development/experimental, especially for certain kernel
|
|
configurations.
|
|
|
|
|
|
Code documentation
|
|
------------------
|
|
|
|
Given a kernel configuration, the kernel may generate Rust code documentation,
|
|
i.e. HTML rendered by the ``rustdoc`` tool.
|
|
|
|
.. only:: rustdoc and html
|
|
|
|
This kernel documentation was built with `Rust code documentation
|
|
<rustdoc/kernel/index.html>`_.
|
|
|
|
.. only:: not rustdoc and html
|
|
|
|
This kernel documentation was not built with Rust code documentation.
|
|
|
|
A pregenerated version is provided at:
|
|
|
|
https://rust.docs.kernel.org
|
|
|
|
Please see the :ref:`Code documentation <rust_code_documentation>` section for
|
|
more details.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
quick-start
|
|
general-information
|
|
coding-guidelines
|
|
arch-support
|
|
testing
|
|
|
|
.. only:: subproject and html
|
|
|
|
Indices
|
|
=======
|
|
|
|
* :ref:`genindex`
|