From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 17390 invoked by alias); 23 May 2009 13:24:55 -0000 Received: (qmail 17379 invoked by uid 22791); 23 May 2009 13:24:53 -0000 X-SWARE-Spam-Status: No, hits=-1.7 required=5.0 tests=AWL,BAYES_00,SPF_SOFTFAIL X-Spam-Check-By: sourceware.org Received: from mtaout4.012.net.il (HELO mtaout3.012.net.il) (84.95.2.10) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Sat, 23 May 2009 13:24:46 +0000 Received: from conversion-daemon.i_mtaout3.012.net.il by i_mtaout3.012.net.il (HyperSendmail v2004.12) id <0KK300900M75WW00@i_mtaout3.012.net.il> for gdb-patches@sourceware.org; Sat, 23 May 2009 16:24:42 +0300 (IDT) Received: from HOME-C4E4A596F7 ([84.228.115.215]) by i_mtaout3.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0KK3007POML6PM30@i_mtaout3.012.net.il>; Sat, 23 May 2009 16:24:42 +0300 (IDT) Date: Sat, 23 May 2009 13:24:00 -0000 From: Eli Zaretskii Subject: Re: [GDB] Add missing configure options to README... In-reply-to: <20090508211636.GL659@adacore.com> To: Joel Brobecker Cc: gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83eiugt0it.fsf@gnu.org> References: <20090508211636.GL659@adacore.com> X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2009-05/txt/msg00510.txt.bz2 > Date: Fri, 8 May 2009 14:16:36 -0700 > From: Joel Brobecker > > Is it ok that I put your name down as the person responsible for helping > this get done (either by doing it yourself, or helping someone else > do it)? I just committed the following patch in fulfillment of this action item. Any comments, corrections, suggestions, etc. are welcome. 2009-05-23 Eli Zaretskii * README (`configure' options): Document GDB-specific options to `configure'. Index: README =================================================================== RCS file: /cvs/src/src/gdb/README,v retrieving revision 1.43 diff -u -r1.43 README --- README 23 Apr 2009 21:28:16 -0000 1.43 +++ README 23 May 2009 13:17:15 -0000 @@ -398,6 +398,16 @@ directories under the working directory in parallel to the source directories below PATH. +`--host=HOST' + Configure GDB to run on the specified HOST. + + There is no convenient way to generate a list of all available + hosts. + +`HOST ...' + Same as `--host=HOST'. If you omit this, GDB will guess; it's + quite accurate. + `--norecursion' Configure only the directory level where `configure' is executed; do not propagate configuration to subdirectories. @@ -418,6 +428,11 @@ -Wparentheses -Wpointer-arith +`--enable-werror' + Treat compiler warnings as werrors. Use this only with GCC. It + adds the -Werror flag to the compiler, which will fail the + compilation if the compiler outputs any warning messages. + `--target=TARGET' Configure GDB for cross-debugging programs running on the specified TARGET. Without this option, GDB is configured to debug programs @@ -426,21 +441,96 @@ There is no convenient way to generate a list of all available targets. -`--host=HOST' - Configure GDB to run on the specified HOST. - - There is no convenient way to generate a list of all available - hosts. - -`HOST ...' - Same as `--host=HOST'. If you omit this, GDB will guess; it's - quite accurate. - `--with-gdb-datadir=PATH' Set the GDB-specific data directory. GDB will look here for certain supporting files or scripts. This defaults to the `gdb' subdirectory of `datadir' (which can be set using `--datadir'). +`--with-relocated-sources=DIR' + Sets up the default source path substitution rule so that + directory names recorded in debug information will be + automatically adjusted for any directory under DIR. DIR should + be a subdirectory of GDB's configured prefix, the one mentioned + in the `--prefix' or `--exec-prefix' options to configure. This + option is useful if GDB is supposed to be moved to a different + place after it is built. + +`--enable-64-bit-bfd' + Enable 64-bit support in BFD on 32-bit hosts. + +`--disable-gdbmi' + Build GDB without the GDB/MI machine interface. + +`--enable-tui' + Build GDB with the text-mode full-screen user interface (TUI). + Requires a curses library (ncurses and cursesX are also + supported). + +`--enable-gdbtk' + Build GDB with the gdbtk GUI interface. Requires TCL/Tk to be + installed. + +`--with-libunwind' + Use the libunwind library for unwinding function call stack. See + http://www.nongnu.org/libunwind/index.html fro details. + Supported only on some platforms. + +`--with-curses' + Use the curses library instead of the termcap library, for + text-mode terminal operations. + +`--enable-profiling' Enable profiling of GDB itself. Necessary if you + want to use the "maint set profile" command for profiling GDB. + Requires the functions `monstartup' and `_mcleanup' to be present + in the standard C library used to build GDB, and also requires a + compiler that supports the `-pg' option. + +`--with-system-readline' + Use the readline library installed on the host, rather than the + library supplied as part of GDB tarball. + +`--with-expat' + Build GDB with the libexpat library. (Done by default if + libexpat is installed and found at configure time.) This library + is used to read XML files supplied with GDB. If it is + unavailable, some features, such as remote protocol memory maps, + target descriptions, and shared library lists, that are based on + XML files, will not be available in GDB. If your host does not + have libexpat installed, you can get the latest version from + http://expat.sourceforge.net. + +`--with-python[=PATH]' + Build GDB with Python scripting support. (Done by default if + libpython is present and found at configure time.) Python makes + GDB scripting much more powerful than the restricted CLI + scripting language. If your host does not have Python installed, + you can find it on http://www.python.org/download/. The oldest + version of Python supported by GDB is 2.4. The optional argument + PATH says where to find the Python headers and libraries; the + configure script will look in PATH/include for headers and in + PATH/lib for the libraries. + +`--without-included-regex' + Don't use the regex library included with GDB (as part of the + libiberty library). This is the default on hosts with version 2 + of the GNU C library. + +`--with-sysroot=DIR' + Use DIR as the default system root directory for libraries whose + file names begin with `/lib' or `/usr/lib'. (The value of DIR + can be modified at run time by using the "set sysroot" command.) + If DIR is under the GDB configured prefix (set with `--prefix' or + `--exec-prefix' options), the default system root will be + automatically adjusted if and when GDB is moved to a different + location. + +`--with-system-gdbinit=FILE' + Configure GDB to automatically load a system-wide init file. + FILE should be an absolute file name. If FILE is in a directory + under the configured prefix, and GDB is moved to another location + after being built, the location of the system-wide init file will + be adjusted accordingly. + `configure' accepts other options, for compatibility with configuring other GNU tools recursively; but these are the only options that affect GDB or its supporting libraries.