[RTEMS Project] #4647: Enhancement: RSB: Improve documentation for --with/--without command line option

[RTEMS trac]

#4647: Enhancement: RSB: Improve documentation for --with/--without command line
option
-----------------------------+----------------------
  Reporter:  Frank Kuehndel  |      Owner:  (none)
      Type:  enhancement     |     Status:  assigned
  Priority:  lowest          |  Milestone:
 Component:  tool/rsb        |    Version:
  Severity:  trivial         |   Keywords:
Blocked By:                  |   Blocking:
-----------------------------+----------------------
 Currently, `sb-set-builder --help` does not list which
 `--with-*/--without-*` command line option exist. It only prints (git
 HEAD=`22e32ecc272353a9047d429358aee2d61687ccc7`):

 {{{
 source-builder/sb-set-builder --help
 [...]
 --with-<label>         : Add the --with-<label> to the build
 --without-<label>      : Add the --without-<label> to the build
 [...]
 }}}

 This ticket asks to list the actual existing variants of these options (or
 to document them somewhere). Solutions have been suggested in this email:

 https://lists.rtems.org/pipermail/devel/2022-May/071472.html

 ----

 Notes:

 These options are documented in ticket #4646 :

 {{{
 --with-rtems-dtc
 --with-rtems-expat
 --with-rtems-gmp
 --with-rtems-gdb
 --with-rtems-binutils
 --with-rtems-gcc
 --with-rtems-tools
 }}}

 Moreover, there exist the following (from `source-
 builder/config/checks.cfg`) options (among others):

 {{{
 #
 # Process the command line --with-/--without- options.
 #
 %{?with_cxx:%define enable_cxx 1}
 %{?without_cxx:%define enable_cxx 0}
 %{?with_ada:%define enable_ada 1}
 %{?without_ada:%define enable_ada 0}
 %{?with_fortran:%define enable_fortran 1}
 %{?without_fortran:%define enable_fortran 0}
 %{?with_java:%define enable_java 1}
 %{?without_java:%define enable_java 0}
 %{?with_objc:%define enable_objc 1}
 %{?without_objc:%define enable_objc 0}
 }}}

 (`--with-java` does not work. GCC configure does not known language
 "java". See https://gcc.gnu.org/install/configure.html option `--enable-
 languages`.)

 Furthermore, there is some documentation in the ''RTEMS User Manual'' sub-
 section ''14.6.3. Set Builder (sb-set-builder)'':
 https://docs.rtems.org/branches/master/user/rsb/commands.html#set-builder-
 sb-set-builder

--
Ticket URL: <http://devel.rtems.org/ticket/4647>
RTEMS Project <http://www.rtems.org/>
RTEMS Project