[PATCH] user: Update rsb-packages to reflect RTEMS 6 changes

Joel Sherrill joel at rtems.org
Mon Aug 9 15:17:56 UTC 2021 

On Mon, Aug 9, 2021 at 10:07 AM Gedare Bloom <gedare at rtems.org> wrote:
>
> I have to think about this. The approach taken here just replaces 5.1
> -> 6, it isn't updating the screengrabs. This means the tutorial isn't
> "real" but that might be fine.

He can replace the screenshots but that is not worth the trouble at
this point IMO.

> The other issue is that when we release, then this has to become 6 ->
> 6.1 in the release, and 6 -> 7 in the master. How we manage this
> becomes part of the release overhead.

As Andrei pointed out, these sections trick you into thinking that
you can ftp "releases" from the master. But they aren't right for the
master if they say 5 or 6. I'm prone to have these type of sections
have prominent warnings that they only apply to releases and not
to fetching from git. At least that keeps the sections and flags them.

But it doesn't do anything about the burden of the release cycle.

--joel

> On Fri, Aug 6, 2021 at 3:27 PM Ray Garza <raymond.garza at oarcorp.com> wrote:
> >
> > This updates all references and examples in the rtems docs: user/start/rsb-packages.rst to RTEMS 6
> >
> > ---
> >  user/start/rsb-packages.rst | 68 ++++++++++++++++++-------------------
> >  1 file changed, 34 insertions(+), 34 deletions(-)
> >
> > diff --git a/user/start/rsb-packages.rst b/user/start/rsb-packages.rst
> > index 3119318..891ea6a 100644
> > --- a/user/start/rsb-packages.rst
> > +++ b/user/start/rsb-packages.rst
> > @@ -19,8 +19,8 @@ Return to here once you have completed these steps.
> >
> >  You have chosen an installation prefix, the BSP to build, the tool's
> >  architecure and prepared the source for the RSB in the previous sections.  We
> > -have chosen :file:`$HOME/quick-start/rtems/5` as the installation prefix, the
> > -``erc32`` BSP and the SPARC architecture name of ``sparc-rtems5``, and unpacked
> > +have chosen :file:`$HOME/quick-start/rtems/6` as the installation prefix, the
> > +``erc32`` BSP and the SPARC architecture name of ``sparc-rtems6``, and unpacked
> >  the RSB source in :file:`$HOME/quick-start/src`.
> >
> >  You are now able to build :ref:`BSP Packages` or 3rd party libraries of code if you
> > @@ -72,36 +72,36 @@ BSP.
> >  .. code-block:: none
> >
> >      cd $HOME/quick-start/src/rsb/rtems
> > -    ../source-builder/sb-set-builder --prefix=$HOME/quick-start/rtems/5 \
> > +    ../source-builder/sb-set-builder --prefix=$HOME/quick-start/rtems/6 \
> >          --with-rtems-tests=yes bsps/erc32
> >
> >  This command should output something like this:
> >
> >  .. code-block:: none
> >
> > -    RTEMS Source Builder - Set Builder, 5.1.0
> > +    RTEMS Source Builder - Set Builder, 6 (4e6dc6431435)
> >      Build Set: bsps/erc32
> > -    Build Set: 5/rtems-sparc.bset
> > -    Build Set: 5/rtems-autotools.bset
> > -    Build Set: 5/rtems-autotools-internal.bset
> > +    Build Set: 6/rtems-sparc.bset
> > +    Build Set: 6/rtems-autotools.bset
> > +    Build Set: 6/rtems-autotools-internal.bset
> >      config: tools/rtems-autoconf-2.69-1.cfg
> >      package: autoconf-2.69-x86_64-freebsd12.1-1
> >      building: autoconf-2.69-x86_64-freebsd12.1-1
> >      sizes: autoconf-2.69-x86_64-freebsd12.1-1: 7.505MB (installed: 0.000B)
> >      ...
> > -    building: protobuf-2.6.1-sparc-rtems5-1
> > -    sizes: protobuf-2.6.1-sparc-rtems5-1: 228.079MB (installed: 84.408MB)
> > -    cleaning: protobuf-2.6.1-sparc-rtems5-1
> > -    reporting: net/protobuf-2.6.1-1.cfg -> protobuf-2.6.1-sparc-rtems5-1.txt
> > -    reporting: net/protobuf-2.6.1-1.cfg -> protobuf-2.6.1-sparc-rtems5-1.xml
> > -    staging: protobuf-2.6.1-sparc-rtems5-1 -> $HOME/quick-start/src/rsb/rtems/build/tmp/sb-500-staging
> > -    cleaning: protobuf-2.6.1-sparc-rtems5-1
> > -    Build Set: Time 0:00:23.564992
> > -    Build Set: Time 0:02:27.380299
> > +    building: protobuf-2.6.1-sparc-rtems6
> > +    sizes: protobuf-2.6.1-sparc-rtems6: 228.079MB (installed: 84.408MB)
> > +    cleaning: protobuf-2.6.1-sparc-rtems6
> > +    reporting: net/protobuf-2.6.1-1.cfg -> protobuf-2.6.1-sparc-rtems6.txt
> > +    reporting: net/protobuf-2.6.1-1.cfg -> protobuf-2.6.1-sparc-rtems6.xml
> > +    staging: protobuf-2.6.1-sparc-rtems6 -> $HOME/quick-start/src/rsb/rtems/build/tmp/sb-500-staging
> > +    cleaning: protobuf-2.6.1-sparc-rtems6
> > +    Build Set: Time 0:00:27.784056
> > +    Build Set: Time 0:02:32.697406
> >      installing: bsps/erc32 -> $HOME/quick-start/rtems/
> >      clean staging: bsps/erc32
> > -    Staging Size: 1.372GB
> > -    Build Set: Time 0:24:17.83979
> > +    Staging Size: 1.401GB
> > +    Build Set: Time 0:25:08.37754
> >
> >  The RSB BSP build can be customised with following RSB command line options:
> >
> > @@ -147,10 +147,10 @@ be a list of build sets. To view the avaliable build sets run this command:
> >  RTEMS package naming is based on the naming FreeBSD uses in its ports
> >  collection.
> >
> > -This Quick Start Guide will build the BSD Library or :file:`5/rtems-libbsd`.
> > +This Quick Start Guide will build the BSD Library or :file:`6/rtems-libbsd`.
> >
> >  An RTEMS package is hosted on RTEMS so the tool suite name needs to be supplied
> > -using the ``--host`` option, e.g. ``--host=sparc-rtem5``. The BSP needs to be
> > +using the ``--host`` option, e.g. ``--host=sparc-rtem6``. The BSP needs to be
> >  provided using the ``--with-rtems-bsp`` option,
> >  e.g. ``--with-rtems-bsp=erc32``. The commands to build ``libbsd`` for the
> >  ``erc32`` BSP are:
> > @@ -158,25 +158,25 @@ e.g. ``--with-rtems-bsp=erc32``. The commands to build ``libbsd`` for the
> >  .. code-block:: none
> >
> >      cd $HOME/quick-start/src/rsb/rtems
> > -    ../source-builder/sb-set-builder --prefix=$HOME/quick-start/rtems/5 \
> > -      --host=sparc-rtems5 --with-rtems-bsp=erc32 5/rtems-libbsd
> > +    ../source-builder/sb-set-builder --prefix=$HOME/quick-start/rtems/6 \
> > +      --host=sparc-rtems6 --with-rtems-bsp=erc32 6/rtems-libbsd
> >
> >  This command should output something like this:
> >
> >  .. code-block:: none
> >
> > -    RTEMS Source Builder - Set Builder, 5.1.0
> > -    Build Set: 5/rtems-libbsd
> > -    config: tools/rtems-libbsd-5.cfg
> > -    package: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1
> > -    building: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1
> > -    sizes: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1: 1.199GB (installed: 116.541MB)
> > -    cleaning: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1
> > -    reporting: tools/rtems-libbsd-5.cfg -> rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1.txt
> > -    reporting: tools/rtems-libbsd-5.cfg -> rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1.xml
> > -    installing: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1 -> $HOME/quick-start/rtems/5
> > -    cleaning: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1
> > -    Build Set: Time 0:00:51.898231
> > +    RTEMS Source Builder - Set Builder, 6 (4e6dc6431435)
> > +    Build Set: 6/rtems-libbsd
> > +    config: tools/rtems-libbsd-6.cfg
> > +    package: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6
> > +    building: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6
> > +    sizes: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6: 1.199GB (installed: 116.541MB)
> > +    cleaning: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6
> > +    reporting: tools/rtems-libbsd-6.cfg -> rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6.txt
> > +    reporting: tools/rtems-libbsd-6.cfg -> rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6.xml
> > +    installing: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6 -> $HOME/quick-start/rtems/6
> > +    cleaning: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6
> > +    Build Set: Time 0:00:55.045735
> >
> >  .. note::
> >
> > --
> > 2.27.0
> >
> > _______________________________________________
> > devel mailing list
> > devel at rtems.org
> > http://lists.rtems.org/mailman/listinfo/devel
> _______________________________________________
> devel mailing list
> devel at rtems.org
> http://lists.rtems.org/mailman/listinfo/devel

More information about the devel mailing list