diff mbox series

contributor-guide: clarify patchtest usage

Message ID 20231017163203.2268267-1-tgamblin@baylibre.com
State New
Headers show
Series contributor-guide: clarify patchtest usage | expand

Commit Message

Trevor Gamblin Oct. 17, 2023, 4:32 p.m. UTC
- Make it clear that patchtest only supports openembedded-core for now
- Add a short list of instructions for installing Python module
  dependencies on the host
- Add a step to add meta-selftest with bitbake layers so that all tests
  can run

Signed-off-by: Trevor Gamblin <tgamblin@baylibre.com>
---
 .../contributor-guide/submit-changes.rst         | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

Comments

Michael Opdenacker Oct. 19, 2023, 1:13 p.m. UTC | #1
Hi Trevor

On 17.10.23 at 18:32, Trevor Gamblin wrote:
> - Make it clear that patchtest only supports openembedded-core for now
> - Add a short list of instructions for installing Python module
>    dependencies on the host
> - Add a step to add meta-selftest with bitbake layers so that all tests
>    can run
>
> Signed-off-by: Trevor Gamblin <tgamblin@baylibre.com>
> ---
>   .../contributor-guide/submit-changes.rst         | 16 +++++++++++-----
>   1 file changed, 11 insertions(+), 5 deletions(-)
>
> diff --git a/documentation/contributor-guide/submit-changes.rst b/documentation/contributor-guide/submit-changes.rst
> index 8a300c366..f93c87ca3 100644
> --- a/documentation/contributor-guide/submit-changes.rst
> +++ b/documentation/contributor-guide/submit-changes.rst
> @@ -282,12 +282,18 @@ Here is the general procedure on how to create patches to be sent through email:
>   Validating Patches with Patchtest
>   =================================
>   
> -``patchtest`` is available in ``openembedded-core`` as a tool for making sure
> -that your patches are well-formatted and contain important info for
> +``patchtest`` is available in ``openembedded-core`` as a tool for making
> +sure that your patches are well-formatted and contain important info for
>   maintenance purposes, such as ``Signed-off-by`` and ``Upstream-Status``
> -tags. Once you have generated the patch files and run ``source
> -oe-init-build-env`` to initialize your workspace, you can run ``patchtest``
> -like so::
> +tags. Currently, it only supports testing patches for
> +``openembedded-core`` branches. To setup, perform the following::
> +
> +#. ``pip install -r meta/lib/patchtest/requirements.txt``
> +#. ``source oe-init-build-env``
> +#. ``bitbake-layers add-layer ../meta-selftest``


Thanks for the update. I just removed the "#." characters which made the 
output look weird.
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Merged into "master-next".

Cheers
Michael.
diff mbox series

Patch

diff --git a/documentation/contributor-guide/submit-changes.rst b/documentation/contributor-guide/submit-changes.rst
index 8a300c366..f93c87ca3 100644
--- a/documentation/contributor-guide/submit-changes.rst
+++ b/documentation/contributor-guide/submit-changes.rst
@@ -282,12 +282,18 @@  Here is the general procedure on how to create patches to be sent through email:
 Validating Patches with Patchtest
 =================================
 
-``patchtest`` is available in ``openembedded-core`` as a tool for making sure
-that your patches are well-formatted and contain important info for
+``patchtest`` is available in ``openembedded-core`` as a tool for making
+sure that your patches are well-formatted and contain important info for
 maintenance purposes, such as ``Signed-off-by`` and ``Upstream-Status``
-tags. Once you have generated the patch files and run ``source
-oe-init-build-env`` to initialize your workspace, you can run ``patchtest``
-like so::
+tags. Currently, it only supports testing patches for
+``openembedded-core`` branches. To setup, perform the following::
+
+#. ``pip install -r meta/lib/patchtest/requirements.txt``
+#. ``source oe-init-build-env``
+#. ``bitbake-layers add-layer ../meta-selftest``
+
+Once these steps are complete and you have generated your patch files,
+you can run ``patchtest`` like so::
 
     patchtest --patch <patch_name>