2022-09-29 09:44:26

by Khalid Masum

[permalink] [raw]
Subject: [PATCH v2] Documentation: Kunit: Use full path to .kunitconfig

The fourth list item on writing test cases instructs adding Kconfig
fragments to .kunitconfig, which should have been full path to the file
(.kunit/.kunitconfig).

Cc: Sadiya Kazi <[email protected]>
Cc: David Gow <[email protected]>
Suggested-by: Bagas Sanjaya <[email protected]>
Signed-off-by: Khalid Masum <[email protected]>
---
Changes since v1:
- Update commit message
- Make the instruction more descriptive

Documentation/dev-tools/kunit/start.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/dev-tools/kunit/start.rst b/Documentation/dev-tools/kunit/start.rst
index 867a4bba6bf6..69361065cda6 100644
--- a/Documentation/dev-tools/kunit/start.rst
+++ b/Documentation/dev-tools/kunit/start.rst
@@ -217,7 +217,7 @@ Now we are ready to write the test cases.

obj-$(CONFIG_MISC_EXAMPLE_TEST) += example_test.o

-4. Add the following lines to ``.kunitconfig``:
+4. Add following configuration fragments to ``.kunit/.kunitconfig``:

.. code-block:: none

--
2.37.3


2022-09-29 13:34:12

by Bagas Sanjaya

[permalink] [raw]
Subject: Re: [PATCH v2] Documentation: Kunit: Use full path to .kunitconfig

On 9/29/22 15:53, Khalid Masum wrote:
> The fourth list item on writing test cases instructs adding Kconfig
> fragments to .kunitconfig, which should have been full path to the file
> (.kunit/.kunitconfig).
>
> Cc: Sadiya Kazi <[email protected]>
> Cc: David Gow <[email protected]>
> Suggested-by: Bagas Sanjaya <[email protected]>
> Signed-off-by: Khalid Masum <[email protected]>
> ---
> Changes since v1:
> - Update commit message
> - Make the instruction more descriptive
>
> Documentation/dev-tools/kunit/start.rst | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/dev-tools/kunit/start.rst b/Documentation/dev-tools/kunit/start.rst
> index 867a4bba6bf6..69361065cda6 100644
> --- a/Documentation/dev-tools/kunit/start.rst
> +++ b/Documentation/dev-tools/kunit/start.rst
> @@ -217,7 +217,7 @@ Now we are ready to write the test cases.
>
> obj-$(CONFIG_MISC_EXAMPLE_TEST) += example_test.o
>
> -4. Add the following lines to ``.kunitconfig``:
> +4. Add following configuration fragments to ``.kunit/.kunitconfig``:
>
> .. code-block:: none
>

Looks OK, thanks!

Reviewed-by: Bagas Sanjaya <[email protected]>

--
An old man doll... just what I always wanted! - Clara

2022-09-30 04:31:49

by David Gow

[permalink] [raw]
Subject: Re: [PATCH v2] Documentation: Kunit: Use full path to .kunitconfig

On Thu, Sep 29, 2022 at 4:56 PM Khalid Masum <[email protected]> wrote:
>
> The fourth list item on writing test cases instructs adding Kconfig
> fragments to .kunitconfig, which should have been full path to the file
> (.kunit/.kunitconfig).
>
> Cc: Sadiya Kazi <[email protected]>
> Cc: David Gow <[email protected]>
> Suggested-by: Bagas Sanjaya <[email protected]>
> Signed-off-by: Khalid Masum <[email protected]>
> ---
> Changes since v1:
> - Update commit message
> - Make the instruction more descriptive
>

I confess, I think I prefer v1 overall here. Further notes below.

If there are no further objections, I'll continue to propose v1 for 6.1.

Cheers,
-- David


> Documentation/dev-tools/kunit/start.rst | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/dev-tools/kunit/start.rst b/Documentation/dev-tools/kunit/start.rst
> index 867a4bba6bf6..69361065cda6 100644
> --- a/Documentation/dev-tools/kunit/start.rst
> +++ b/Documentation/dev-tools/kunit/start.rst
> @@ -217,7 +217,7 @@ Now we are ready to write the test cases.
>
> obj-$(CONFIG_MISC_EXAMPLE_TEST) += example_test.o
>
> -4. Add the following lines to ``.kunitconfig``:
> +4. Add following configuration fragments to ``.kunit/.kunitconfig``:

At the risk of starting an argument, I actually preferred "the
following lines" here. "configuration fragments" doesn't quite
describe this perfectly, IMO. Maybe something like "config options"
would work better. Otherwise, just sticking with "lines" is probably
fine for the getting started guide. It's unlikely to confuse people,
and there's further discussion elsewhere in the documentation.

Regardless, we definitely should keep "the" here in "Add _the_
following". "Add following" is grammatically more dubious.

>
> .. code-block:: none
>
> --
> 2.37.3
>


Attachments:
smime.p7s (3.91 kB)
S/MIME Cryptographic Signature