Re: [PATCH 6/7] Documentation: rust: rename `#[test]`s to "`rusttest` host tests"

David Gow
2025-05-05T06:02:52Z

[-- Attachment #1: Type: text/plain, Size: 1651 bytes --]

On Sat, 3 May 2025 at 05:52, Miguel Ojeda <ojeda@kernel.org> wrote:
>
> Now that `rusttest`s are not really used much, clarify the section of
> the documentation that describes them.
>
> In addition, free the section name for the KUnit-based `#[test]`s that
> will be added afterwards. To do so, rename the section into `rusttest`
> host tests.
>
> Signed-off-by: Miguel Ojeda <ojeda@kernel.org>
> ---

Reviewed-by: David Gow <davidgow@google.com>

Cheers,
-- David

> Documentation/rust/testing.rst | 13 +++++++------
> 1 file changed, 7 insertions(+), 6 deletions(-)
>
> diff --git a/Documentation/rust/testing.rst b/Documentation/rust/testing.rst
> index f692494f7b74..6337b83815ab 100644
> --- a/Documentation/rust/testing.rst
> +++ b/Documentation/rust/testing.rst
> @@ -130,16 +130,17 @@ please see:
>
> https://rust.docs.kernel.org/kernel/error/type.Result.html#error-codes-in-c-and-rust
>
> -The ``#[test]`` tests
> ----------------------
> +The ``rusttest`` host tests
> +---------------------------
>
> -Additionally, there are the ``#[test]`` tests. These can be run using the
> -``rusttest`` Make target::
> +These are userspace tests that can be built and run in the host (i.e. the one
> +that performs the kernel build) using the ``rusttest`` Make target::
>
> make LLVM=1 rusttest
>
> -This requires the kernel ``.config``. It runs the ``#[test]`` tests on the host
> -(currently) and thus is fairly limited in what these tests can test.
> +This requires the kernel ``.config``.
> +
> +Currently, they are mostly used for testing the ``macros`` crate's examples.
>
> The Kselftests
> --------------
> --
> 2.49.0
>

[-- Attachment #2: S/MIME Cryptographic Signature --]
[-- Type: application/pkcs7-signature, Size: 5281 bytes --]