-===================
-
- Here is a summary of all the `configure' options and arguments that
-you might use for building GDB:
-
- configure [+destdir=DIR] [+subdirs]
- [+objdir=ALTROOT] [+norecursion] [+rm]
- [+target=TARGET...] HOST...
-
-You may introduce options with the character `-' rather than `+' if
-you prefer; but you may abbreviate option names if you use `+'.
-
-`+destdir=DIR'
- DIR is an installation directory *path prefix*. After you
- configure with this option, `make install' will install GDB as
- `DIR/bin/gdb', and the libraries in `DIR/lib'. If you specify
- `+destdir=/usr/local', for example, `make install' creates
- `/usr/local/bin/gdb'.
-
-`+subdirs'
- Write configuration specific files in subdirectories of the form
-
- H-HOST/T-TARGET
-
- (and configure the `Makefile' to generate object code in
- subdirectories of this form as well). Without this option, if you
- specify only one configuration for GDB, `configure' will use the
- same directory for source, configured files, and binaries. This
- option is used automatically if you specify more than one HOST or
- more than one `+target=TARGET' option on the `configure' command
- line.
-
-`+norecursion'
- Configure only the directory where `configure' is executed; do not
- propagate configuration to subdirectories.
-
-`+objdir=ALTROOT'
- ALTROOT is an alternative directory used as the root for
- configured files. `configure' will create directories under
- ALTROOT in parallel to the source directories. If you use
- `+objdir=ALTROOT' with `+subdirs', `configure' also builds the
- `H-HOST/T-TARGET' subdirectories in the directory tree rooted in
- ALTROOT.
-
-`+rm'
+====================
+
+ Here is a summary of the `configure' options and arguments that are
+most often useful for building GDB. `configure' also has several other
+options not listed here. *note : (configure.info)What Configure Does,
+for a full explanation of `configure'.
+
+ configure [--help]
+ [--prefix=DIR]
+ [--srcdir=PATH]
+ [--norecursion] [--rm]
+ [--target=TARGET] HOST
+
+You may introduce options with a single `-' rather than `--' if you
+prefer; but you may abbreviate option names if you use `--'.
+
+`--help'
+ Display a quick summary of how to invoke `configure'.
+
+`-prefix=DIR'
+ Configure the source to install programs and files under directory
+ `DIR'.
+
+`--srcdir=PATH'
+ *Warning: using this option requires GNU `make', or another `make'
+ that implements the `VPATH' feature.*
+ Use this option to make configurations in directories separate
+ from the GDB source directories. Among other things, you can use
+ this to build (or maintain) several configurations simultaneously,
+ in separate directories. `configure' writes configuration
+ specific files in the current directory, but arranges for them to
+ use the source in the directory PATH. `configure' will create
+ directories under the working directory in parallel to the source
+ directories below PATH.
+
+`--norecursion'
+ Configure only the directory level where `configure' is executed;
+ do not propagate configuration to subdirectories.
+
+`--rm'