<div dir="ltr">Regarding the patch to add instructions on how to set up a  patch message in which file should I create this patch or make changes?<br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Mar 15, 2021 at 8:57 PM Gedare Bloom <<a href="mailto:gedare@rtems.org">gedare@rtems.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi Ida,<br>
<br>
On Mon, Mar 15, 2021 at 1:50 PM Gedare Bloom <<a href="mailto:gedare@rtems.org" target="_blank">gedare@rtems.org</a>> wrote:<br>
><br>
> Hi Ida,<br>
><br>
> did you send the same set of patches twice, or are there changes<br>
> between the two sets?<br>
><br>
<br>
Since I'm not quite sure what to look at here, please do me a favor<br>
and send a new patchset with a -v2 indicator [1], and also set the<br>
patch message to specify rtems-docs. git format patch supports to set<br>
the prefix with:<br>
     git format-patch HEAD^ --subject-prefix="PATCH rtems-docs"<br>
You can also create an alias to make this simpler [2]. In fact, if you<br>
can send a patch to add instructions how to set up patch message with<br>
the repo name to the text at [1] that would be another nice<br>
contribution :)<br>
<br>
[1] <a href="https://docs.rtems.org/branches/master/eng/vc-users.html#creating-a-patch" rel="noreferrer" target="_blank">https://docs.rtems.org/branches/master/eng/vc-users.html#creating-a-patch</a><br>
[2] <a href="https://lists.rtems.org/pipermail/devel/2020-April/059308.html" rel="noreferrer" target="_blank">https://lists.rtems.org/pipermail/devel/2020-April/059308.html</a><br>
<br>
Thank you,<br>
Gedare<br>
<br>
> On Sun, Mar 14, 2021 at 8:26 PM Ida Delphine <<a href="mailto:idadelm@gmail.com" target="_blank">idadelm@gmail.com</a>> wrote:<br>
> ><br>
> > ---<br>
> >  user/start/app.rst | 104 ++++++++++++++++++++++-----------------------<br>
> >  1 file changed, 52 insertions(+), 52 deletions(-)<br>
> ><br>
> > diff --git a/user/start/app.rst b/user/start/app.rst<br>
> > index 8900f78..c343551 100644<br>
> > --- a/user/start/app.rst<br>
> > +++ b/user/start/app.rst<br>
> > @@ -8,7 +8,7 @@ Build Your Application<br>
> >  ======================<br>
> ><br>
> >  You tested a BSP in the previous section.  We built the ``erc32`` BSP<br>
> > -and it is installed under :file:`$HOME/quick-start/rtems/5`.<br>
> > +and it is installed under :file:`$HOME/quick-start/rtems/6`.<br>
> ><br>
> >  We will now create a simple Hello World application with a Git<br>
> >  repository and using the `Waf <<a href="https://waf.io" rel="noreferrer" target="_blank">https://waf.io</a>>`_ build system.<br>
> > @@ -107,7 +107,7 @@ and copy the Waf script:<br>
> >      #<br>
> >      from __future__ import print_function<br>
> ><br>
> > -    rtems_version = "5"<br>
> > +    rtems_version = "6"<br>
> ><br>
> >      try:<br>
> >          import rtems_waf.rtems as rtems<br>
> > @@ -142,52 +142,52 @@ Configure the application using Waf's ``configure`` command:<br>
> ><br>
> >  .. code-block:: none<br>
> ><br>
> > -    ./waf configure --rtems=$HOME/quick-start/rtems/5 --rtems-bsp=sparc/erc32<br>
> > +    ./waf configure --rtems=$HOME/quick-start/rtems/6 --rtems-bsp=sparc/erc32 --rtems-version=6<br>
> ><br>
> >  The output will be something close to:<br>
> ><br>
> >  .. code-block:: none<br>
> ><br>
> > -     Setting top to                           : $BASE/app/hello<br>
> > -     Setting out to                           : $BASE/app/hello/build<br>
> > -     RTEMS Version                            : 5<br>
> > -     Architectures                            : sparc-rtems5<br>
> > -     Board Support Package (BSP)              : sparc-rtems5-erc32<br>
> > -     Show commands                            : no<br>
> > -     Long commands                            : no<br>
> > -     Checking for program 'sparc-rtems5-gcc'  : $BASE/rtems/5/bin/sparc-rtems5-gcc<br>
> > -     Checking for program 'sparc-rtems5-g++'  : $BASE/rtems/5/bin/sparc-rtems5-g++<br>
> > -     Checking for program 'sparc-rtems5-gcc'  : $BASE/rtems/5/bin/sparc-rtems5-gcc<br>
> > -     Checking for program 'sparc-rtems5-ld'   : $BASE/rtems/5/bin/sparc-rtems5-ld<br>
> > -     Checking for program 'sparc-rtems5-ar'   : $BASE/rtems/5/bin/sparc-rtems5-ar<br>
> > -     Checking for program 'sparc-rtems5-nm'   : $BASE/rtems/5/bin/sparc-rtems5-nm<br>
> > -     Checking for program 'sparc-rtems5-objdump' : $BASE/rtems/5/bin/sparc-rtems5-objdump<br>
> > -     Checking for program 'sparc-rtems5-objcopy' : $BASE/rtems/5/bin/sparc-rtems5-objcopy<br>
> > -     Checking for program 'sparc-rtems5-readelf' : $BASE/rtems/5/bin/sparc-rtems5-readelf<br>
> > -     Checking for program 'sparc-rtems5-strip'   : $BASE/rtems/5/bin/sparc-rtems5-strip<br>
> > -     Checking for program 'sparc-rtems5-ranlib'  : $BASE/rtems/5/bin/sparc-rtems5-ranlib<br>
> > -     Checking for program 'rtems-ld'             : $BASE/rtems/5/bin/rtems-ld<br>
> > -     Checking for program 'rtems-tld'            : $BASE/rtems/5/bin/rtems-tld<br>
> > -     Checking for program 'rtems-syms'           : $BASE/rtems/5/bin/rtems-syms<br>
> > -     Checking for program 'rtems-bin2c'          : $BASE/rtems/5/bin/rtems-bin2c<br>
> > -     Checking for program 'tar'                  : /usr/bin/tar<br>
> > -     Checking for program 'gcc, cc'              : $BASE/rtems/5/bin/sparc-rtems5-gcc<br>
> > -     Checking for program 'ar'                   : $BASE/rtems/5/bin/sparc-rtems5-ar<br>
> > -     Checking for program 'g++, c++'             : $BASE/rtems/5/bin/sparc-rtems5-g++<br>
> > -     Checking for program 'ar'                   : $BASE/rtems/5/bin/sparc-rtems5-ar<br>
> > -     Checking for program 'gas, gcc'             : $BASE/rtems/5/bin/sparc-rtems5-gcc<br>
> > -     Checking for program 'ar'                   : $BASE/rtems/5/bin/sparc-rtems5-ar<br>
> > -     Checking for c flags '-MMD'                 : yes<br>
> > -     Checking for cxx flags '-MMD'               : yes<br>
> > -     Compiler version (sparc-rtems5-gcc)         : 7.5.0 20191114 (RTEMS 5, RSB 5.1.0, Newlib fbaa096)<br>
> > -     Checking for a valid RTEMS BSP installation : yes<br>
> > -     Checking for RTEMS_DEBUG                    : no<br>
> > -     Checking for RTEMS_MULTIPROCESSING          : no<br>
> > -     Checking for RTEMS_NEWLIB                   : yes<br>
> > -     Checking for RTEMS_POSIX_API                : yes<br>
> > -     Checking for RTEMS_SMP                      : no<br>
> > -     Checking for RTEMS_NETWORKING               : no<br>
> > -     'configure' finished successfully (0.686s)<br>
> > +    Setting top to                           : $BASE/app/hello<br>
> > +    Setting out to                           : $BASE/app/hello/build<br>
> > +    RTEMS Version                            : 6<br>
> > +    Architectures                            : sparc-rtems6<br>
> > +    Board Support Package (BSP)              : sparc-rtems6-erc32<br>
> > +    Show commands                            : no<br>
> > +    Long commands                            : no<br>
> > +    Checking for program 'sparc-rtems6-gcc'  : $BASE/rtems/6/bin/sparc-rtems6-gcc<br>
> > +    Checking for program 'sparc-rtems6-g++'  : $BASE/rtems/6/bin/sparc-rtems6-g++<br>
> > +    Checking for program 'sparc-rtems6-gcc'  : $BASE/rtems/6/bin/sparc-rtems6-gcc<br>
> > +    Checking for program 'sparc-rtems6-ld'   : $BASE/rtems/6/bin/sparc-rtems6-ld<br>
> > +    Checking for program 'sparc-rtems6-ar'   : $BASE/rtems/6/bin/sparc-rtems6-ar<br>
> > +    Checking for program 'sparc-rtems6-nm'   : $BASE/rtems/6/bin/sparc-rtems6-nm<br>
> > +    Checking for program 'sparc-rtems6-objdump' : $BASE/rtems/6/bin/sparc-rtems6-objdump<br>
> > +    Checking for program 'sparc-rtems6-objcopy' : $BASE/rtems/6/bin/sparc-rtems6-objcopy<br>
> > +    Checking for program 'sparc-rtems6-readelf' : $BASE/rtems/6/bin/sparc-rtems6-readelf<br>
> > +    Checking for program 'sparc-rtems6-strip'   : $BASE/rtems/6/bin/sparc-rtems6-strip<br>
> > +    Checking for program 'sparc-rtems6-ranlib'  : $BASE/rtems/6/bin/sparc-rtems6-ranlib<br>
> > +    Checking for program 'rtems-ld'             : $BASE/rtems/6/bin/rtems-ld<br>
> > +    Checking for program 'rtems-tld'            : $BASE/rtems/6/bin/rtems-tld<br>
> > +    Checking for program 'rtems-syms'           : $BASE/rtems/6/bin/rtems-syms<br>
> > +    Checking for program 'rtems-bin2c'          : $BASE/rtems/6/bin/rtems-bin2c<br>
> > +    Checking for program 'tar'                  : /usr/bin/tar<br>
> > +    Checking for program 'gcc, cc'              : $BASE/rtems/6/bin/sparc-rtems6-gcc<br>
> > +    Checking for program 'ar'                   : $BASE/rtems/6/bin/sparc-rtems6-ar<br>
> > +    Checking for program 'g++, c++'             : $BASE/rtems/6/bin/sparc-rtems6-g++<br>
> > +    Checking for program 'ar'                   : $BASE/rtems/6/bin/sparc-rtems6-ar<br>
> > +    Checking for program 'gas, gcc'             : $BASE/rtems/6/bin/sparc-rtems6-gcc<br>
> > +    Checking for program 'ar'                   : $BASE/rtems/6/bin/sparc-rtems6-ar<br>
> > +    Checking for c flags '-MMD'                 : yes<br>
> > +    Checking for cxx flags '-MMD'               : yes<br>
> > +    Compiler version (sparc-rtems6-gcc)         : 10.2.1 20210309 (RTEMS 6, RSB 5e449fb5c2cb6812a238f9f9764fd339cbbf05c2, Newlib d10d0d9)<br>
> > +    Checking for a valid RTEMS BSP installation : yes<br>
> > +    Checking for RTEMS_DEBUG                    : no<br>
> > +    Checking for RTEMS_MULTIPROCESSING          : no<br>
> > +    Checking for RTEMS_NEWLIB                   : yes<br>
> > +    Checking for RTEMS_POSIX_API                : no<br>
> > +    Checking for RTEMS_SMP                      : no<br>
> > +    Checking for RTEMS_NETWORKING               : no<br>
> > +    'configure' finished successfully (1.142s)<br>
> ><br>
> >  Build the application:<br>
> ><br>
> > @@ -199,24 +199,24 @@ The output will be something close to:<br>
> ><br>
> >  .. code-block:: none<br>
> ><br>
> > -    Waf: Entering directory `$BASE/app/hello/build/sparc-rtems5-erc32'<br>
> > +    Waf: Entering directory `$BASE/app/hello/build/sparc-rtems6-erc32'<br>
> >      [1/3] Compiling init.c<br>
> >      [2/3] Compiling hello.c<br>
> > -    [3/3] Linking build/sparc-rtems5-erc32/hello.exe<br>
> > -    Waf: Leaving directory `$BASE/app/hello/build/sparc-rtems5-erc32'<br>
> > -    'build-sparc-rtems5-erc32' finished successfully (0.183s)<br>
> > +    [3/3] Linking build/sparc-rtems6-erc32/hello.exe<br>
> > +    Waf: Leaving directory `$BASE/app/hello/build/sparc-rtems6-erc32'<br>
> > +    'build-sparc-rtems6-erc32' finished successfully (0.183s)<br>
> ><br>
> >  Run the executable:<br>
> ><br>
> >  .. code-block:: none<br>
> ><br>
> > -    $HOME/quick-start/rtems/5/bin/rtems-run --rtems-bsps=erc32-sis build/sparc-rtems5-erc32/hello.exe<br>
> > +    $HOME/quick-start/rtems/6/bin/rtems-run --rtems-bsps=erc32-sis build/sparc-rtems6-erc32/hello.exe<br>
> ><br>
> >  The output will be something close to:<br>
> ><br>
> >  .. code-block:: none<br>
> ><br>
> > -    RTEMS Testing - Run, 5.1.0<br>
> > +    RTEMS Testing - Run, 6<br>
> >       Command Line: $BASE/rtems/5/bin/rtems-run --rtems-bsps=erc32-sis build/sparc-rtems5-erc32/hello.exe<br>
> >       Host: FreeBSD hihi 12.1-RELEASE-p2 FreeBSD 12.1-RELEASE-p2 GENERIC amd64<br>
> >       Python: 3.7.6 (default, Jan 30 2020, 01:18:54) [Clang 6.0.1 (tags/RELEASE_601/final 335540)]<br>
> > @@ -232,10 +232,10 @@ The output will be something close to:<br>
> >      Hello World<br>
> ><br>
> >      *** FATAL ***<br>
> > -    fatal source: 5 (RTEMS_FATAL_SOURCE_EXIT)<br>
> > +    fatal source: 6 (RTEMS_FATAL_SOURCE_EXIT)<br>
> >      fatal code: 0 (0x00000000)<br>
> > -    RTEMS version: 5.1.0<br>
> > -    RTEMS tools: 7.5.0 20191114 (RTEMS 5, RSB 5.1.0, Newlib fbaa096)<br>
> > +    RTEMS version: 6<br>
> > +    RTEMS tools: 7.5.0 20191114 (RTEMS 6, RSB 6, Newlib fbaa096)<br>
> >      executing thread ID: 0x08a010001<br>
> >      executing thread name: UI1<br>
> >      cpu 0 in error mode (tt = 0x101)<br>
> > --<br>
> > 2.25.1<br>
> ><br>
> > _______________________________________________<br>
> > devel mailing list<br>
> > <a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
> > <a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a><br>
</blockquote></div>