(and sometimes confusing) to the casual installer
--disable-dependency-tracking speeds up one-time build
--enable-dependency-tracking do not reject slow dependency extractors
- --enable-targets alternative target configurations
+ --enable-targets=TARGETS
+ alternative target configurations
--enable-64-bit-bfd 64-bit support (on hosts with narrower word sizes)
--disable-gdbcli disable command-line interface (CLI)
--disable-gdbmi disable machine-interface (MI)
--enable-gdbtk enable gdbtk graphical user interface (GUI)
--enable-profiling enable profiling of GDB
--disable-rpath do not hardcode runtime library paths
- --enable-werror treat compile warnings as errors
+ --enable-werror treat compile warnings as errors
--enable-build-warnings Enable build-time compiler warnings if gcc is used
- --enable-gdb-build-warnings Enable GDB specific build-time compiler warnings if gcc is used
+ --enable-gdb-build-warnings
+ Enable GDB specific build-time compiler warnings if
+ gcc is used
--enable-sim Link gdb with simulator
--enable-multi-ice build the multi-ice-gdb-server
Optional Packages:
--with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
--without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no)
- --with-separate-debug-dir=path Look for global separate debug info in this path LIBDIR/debug
+ --with-separate-debug-dir=PATH
+ Look for global separate debug info in this path
+ LIBDIR/debug
--with-relocated-sources=PATH
Automatically relocate this path for source files
- --with-libunwind Use libunwind frame unwinding support
+ --with-libunwind Use libunwind frame unwinding support
--with-curses use the curses library instead of the termcap
library
--with-pkgversion=PKG Use PKG in the version string in place of "GDB"
--with-bugurl=URL Direct users to URL to report a bug
- --with-libiconv-prefix=DIR search for libiconv in DIR/include and DIR/lib
+ --with-libiconv-prefix=DIR
+ search for libiconv in DIR/include and DIR/lib
--with-system-readline use installed readline library
--with-expat include expat support (auto/yes/no)
--with-gnu-ld assume the C compiler uses GNU ld default=no
--with-libexpat-prefix[=DIR] search for libexpat in DIR/include and DIR/lib
--without-libexpat-prefix don't search for libexpat in includedir and libdir
--with-python include python support (auto/yes/no/<path>)
- --without-included-regex don't use included regex; this is the default
- on systems with version 2 of the GNU C library
- (use with caution on other system)
- --with-sysroot=DIR Search for usr/lib et al within DIR.
- --with-system-gdbinit=file Automatically load a system-wide gdbinit file
+ --without-included-regex
+ don't use included regex; this is the default on
+ systems with version 2 of the GNU C library (use
+ with caution on other system)
+ --with-sysroot=DIR Search for usr/lib et al within DIR.
+ --with-system-gdbinit=FILE
+ Automatically load a system-wide gdbinit file
--with-tcl directory containing tcl configuration (tclConfig.sh)
--with-tk directory containing tk configuration (tkConfig.sh)
--with-x use the X Window System
debugdir=${libdir}/debug
AC_ARG_WITH(separate-debug-dir,
-[ --with-separate-debug-dir=path Look for global separate debug info in this path [LIBDIR/debug]],
+AC_HELP_STRING([--with-separate-debug-dir=PATH], [Look for global separate debug info in this path [LIBDIR/debug]]),
[debugdir="${withval}"])
AC_DEFINE_DIR(DEBUGDIR, debugdir,
# Check whether to support alternative target configurations
AC_ARG_ENABLE(targets,
-[ --enable-targets alternative target configurations],
+AC_HELP_STRING([--enable-targets=TARGETS], [alternative target configurations]),
[case "${enableval}" in
yes | "") AC_ERROR(enable-targets option must specify target names or 'all')
;;
# Check whether to enable 64-bit support on 32-bit hosts
AC_ARG_ENABLE(64-bit-bfd,
-[ --enable-64-bit-bfd 64-bit support (on hosts with narrower word sizes)],
+AC_HELP_STRING([--enable-64-bit-bfd], [64-bit support (on hosts with narrower word sizes)]),
[case "${enableval}" in
yes) want64=true ;;
no) want64=false ;;
# Enable CLI.
AC_ARG_ENABLE(gdbcli,
-[ --disable-gdbcli disable command-line interface (CLI)],
+AC_HELP_STRING([--disable-gdbcli], [disable command-line interface (CLI)]),
[case $enableval in
yes)
;;
# Enable MI.
AC_ARG_ENABLE(gdbmi,
-[ --disable-gdbmi disable machine-interface (MI)],
+AC_HELP_STRING([--disable-gdbmi], [disable machine-interface (MI)]),
[case $enableval in
yes | no)
;;
# Enable TUI.
AC_ARG_ENABLE(tui,
-[ --enable-tui enable full-screen terminal user interface (TUI)],
+AC_HELP_STRING([--enable-tui], [enable full-screen terminal user interface (TUI)]),
[case $enableval in
yes | no | auto)
;;
# Enable gdbtk.
AC_ARG_ENABLE(gdbtk,
-[ --enable-gdbtk enable gdbtk graphical user interface (GUI)],
+AC_HELP_STRING([--enable-gdbtk], [enable gdbtk graphical user interface (GUI)]),
[case $enableval in
yes | no)
;;
# Libunwind support.
AC_ARG_WITH(libunwind,
-[ --with-libunwind Use libunwind frame unwinding support],
+AC_HELP_STRING([--with-libunwind], [Use libunwind frame unwinding support]),
[case "${withval}" in
yes) enable_libunwind=yes ;;
no) enable_libunwind=no ;;
# Profiling support.
AC_ARG_ENABLE(profiling,
-[ --enable-profiling enable profiling of GDB],
+AC_HELP_STRING([--enable-profiling], [enable profiling of GDB]),
[case $enableval in
yes | no)
;;
fi
AC_ARG_WITH(included-regex,
- [ --without-included-regex don't use included regex; this is the default
- on systems with version 2 of the GNU C library
- (use with caution on other system)],
+ AC_HELP_STRING([--without-included-regex], [don't use included regex; this is the default on systems with version 2 of the GNU C library (use with caution on other system)]),
gdb_with_regex=$withval,
gdb_with_regex=$gdb_use_included_regex)
if test "$gdb_with_regex" = yes; then
dnl Handle optional features that can be enabled.
AC_ARG_WITH(sysroot,
-[ --with-sysroot[=DIR] Search for usr/lib et al within DIR.],
+AC_HELP_STRING([--with-sysroot[=DIR]], [Search for usr/lib et al within DIR.]),
[
case ${with_sysroot} in
yes) TARGET_SYSTEM_ROOT='${exec_prefix}/${target_alias}/sys-root' ;;
system_gdbinit=
AC_ARG_WITH(system-gdbinit,
-[ --with-system-gdbinit=file Automatically load a system-wide gdbinit file],
+AC_HELP_STRING([--with-system-gdbinit=FILE], [Automatically load a system-wide gdbinit file]),
[system_gdbinit=${withval}])
AC_DEFINE_DIR(SYSTEM_GDBINIT, system_gdbinit,
esac
AC_ARG_ENABLE(werror,
- [ --enable-werror treat compile warnings as errors],
+ AC_HELP_STRING([--enable-werror], [treat compile warnings as errors]),
[case "${enableval}" in
yes | y) ERROR_ON_WARNING="yes" ;;
no | n) ERROR_ON_WARNING="no" ;;
esac
AC_ARG_ENABLE(build-warnings,
-[ --enable-build-warnings Enable build-time compiler warnings if gcc is used],
+AC_HELP_STRING([--enable-build-warnings], [Enable build-time compiler warnings if gcc is used]),
[case "${enableval}" in
yes) ;;
no) build_warnings="-w";;
echo "Setting compiler warning flags = $build_warnings" 6>&1
fi])dnl
AC_ARG_ENABLE(gdb-build-warnings,
-[ --enable-gdb-build-warnings Enable GDB specific build-time compiler warnings if gcc is used],
+AC_HELP_STRING([--enable-gdb-build-warnings], [Enable GDB specific build-time compiler warnings if gcc is used]),
[case "${enableval}" in
yes) ;;
no) build_warnings="-w";;
# not part of the source tree.
#
AC_ARG_ENABLE(sim,
-[ --enable-sim Link gdb with simulator],
+AC_HELP_STRING([--enable-sim], [Link gdb with simulator]),
[echo "enable_sim = $enable_sim";
echo "enableval = ${enableval}";
case "${enableval}" in
# Enable multi-ice-gdb-server.
AC_ARG_ENABLE(multi-ice,
-[ --enable-multi-ice build the multi-ice-gdb-server],
+AC_HELP_STRING([--enable-multi-ice], [build the multi-ice-gdb-server]),
[case $enableval in
yes | no)
;;