[yocto] [yocto-docs] documentation: Updated testimage targets.

[Scott Rifenbark]

Paulo,

I have some questions on this commit for the dev-manual.

See inline comments from me....



On Mon, Aug 6, 2018 at 4:34 AM, Paulo Neves <ptsneves at gmail.com> wrote:

> The documentation of available names for TEST_TARGET have
> been updated to match the convention of using the
> class names of controllers.
>
> Signed-off-by: Paulo Neves <ptsneves at gmail.com>
> ---
>  documentation/dev-manual/dev-manual-common-tasks.xml |  8 ++++----
>  documentation/ref-manual/ref-variables.xml           | 19
> ++++---------------
>  2 files changed, 8 insertions(+), 19 deletions(-)
>
> diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml
> b/documentation/dev-manual/dev-manual-common-tasks.xml
> index 0cb967f..2fcdad0 100644
> --- a/documentation/dev-manual/dev-manual-common-tasks.xml
> +++ b/documentation/dev-manual/dev-manual-common-tasks.xml
> @@ -11400,7 +11400,7 @@
>                              within a separately started QEMU or any
>                              other virtual machine manager.
>                              </para></listitem>
> -                        <listitem><para><emphasis>"Systemd-bootTarget":</
> emphasis>
> +                        <listitem><para><emphasis>"
> SystemdbootTarget":</emphasis>
>                              Choose "Systemd-bootTarget" if your hardware
> is
>

There are many instances of the term "Systemd-bootTarget" remaining in the
manual.  I assume they also will need to convert to "SystemdbootTarget"?


>                              an EFI-based machine with
>                              <filename>systemd-boot</filename> as
> bootloader and
> @@ -11459,10 +11459,10 @@
>              </section>
>
>              <section id='selecting-systemd-boottarget'>
> -                <title>Selecting Systemd-bootTarget</title>
> +                <title>Selecting SystemdbootTarget</title>
>
>                  <para>
> -                    If you did not set <filename>TEST_TARGET</filename>
> to
> +                    If you did not set <filename>TEST_TARG
>

Looks like an early truncation of the line that is used for the
replacement?  Should be "If you did not set
<filename>TEST_TARGET</filename> to"

                     "Systemd-bootTarget", then you do not need any
> information
>                      in this section.
>                      You can skip down to the
> @@ -11472,7 +11472,7 @@
>
>                  <para>
>                      If you did set <filename>TEST_TARGET</filename> to
> -                    "Systemd-bootTarget", you also need to perform a
> one-time
> +                    "SystemdbootTarget", you also need to perform a
> one-time
>                      setup of your master image by doing the following:
>                      <orderedlist>
>                          <listitem><para><emphasis>Set
> <filename>EFI_PROVIDER</filename>:</emphasis>
> diff --git a/documentation/ref-manual/ref-variables.xml
> b/documentation/ref-manual/ref-variables.xml
> index 2465553..a61fee6 100644
> --- a/documentation/ref-manual/ref-variables.xml
> +++ b/documentation/ref-manual/ref-variables.xml
> @@ -15162,35 +15162,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR
> = "${INC_PR}.3"
>                      You can provide the following arguments with
>                      <filename>TEST_TARGET</filename>:
>                      <itemizedlist>
> -                        <listitem><para><emphasis>"qemu" and
> "QemuTarget":</emphasis>
> +                        <listitem><para><emphasis>"
> QemuTarget":</emphasis>
>                              Boots a QEMU image and runs the tests.
>                              See the
>                              "<ulink url='&YOCTO_DOCS_DEV_URL;#
> qemu-image-enabling-tests'>Enabling Runtime Tests on QEMU</ulink>"
>                              section in the Yocto Project Development Tasks
>                              Manual for more information.
>                              </para></listitem>
> -                        <listitem><para><emphasis>"simpleremote" and
> "SimpleRemoteTarget":</emphasis>
> +                        <listitem><para><emphasis>"SimpleRemoteTarget":</
> emphasis>
>                              Runs the tests on target hardware that is
> already
>                              up and running.
>                              The hardware can be on the network or it can
> be
>                              a device running an image on QEMU.
>                              You must also set
>                              <link linkend='var-TEST_TARGET_IP'><
> filename>TEST_TARGET_IP</filename></link>
> -                            when you use "simpleremote" or
> "SimpleRemoteTarget".
> +                            when you use "SimpleRemoteTarget".
>                              <note>
>                                  This argument is defined in
> -                                <filename>meta/lib/oeqa/
> targetcontrol.py</filename>.
> -                                The small caps names are kept for
> compatibility
> -                                reasons.
> -                            </note>
> -                            </para></listitem>
> -                        <listitem><para><emphasis>"
> GummibootTarget":</emphasis>
> -                            Automatically deploys and runs tests on an
> -                            EFI-enabled machine that has a master image
> -                            installed.
> -                            <note>
> -                                This argument is defined in
> -                                <filename>meta/lib/oeqa/
> controllers/masterimage.py</filename>.
> +                                <filename>meta/lib/oeqa/
> controllers/simpleremote.py</filename>.
>

I cannot find any file named "meta/lib/oeqa/controllers/simpleremote.py" in
the poky repository.  Is this file you are specifying correct for a
reference to the "SimpleRemoteTarget" parameter?

                             </note>
>                              </para></listitem>
>                      </itemizedlist>
> --
> 2.7.4
>
> --
> _______________________________________________
> yocto mailing list
> yocto at yoctoproject.org
> https://lists.yoctoproject.org/listinfo/yocto
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.yoctoproject.org/pipermail/yocto/attachments/20180806/64ddbe36/attachment.html>