Re: [rfc] README, doc/gdb.texinfo: warn against '.../configure/gdb-N.N/gdb/configure'

["Eli Zaretskii" <eliz@is.elta.co.il>]

> Date: Wed, 15 Jan 2003 12:43:40 -0600
> From: Michael Elizabeth Chastain <mec@shout.net>
> 
> Here is the first draft of some new doco about the difference
> between '.../gdb-5.3/configure' and '.../gdb-5.3/gdb/configure'.

Thanks.

> I don't expect this to get approved on the first round, although
> that would be nice.

This is approved, with the following comments/requests:

> +You should run the @code{configure} script from the top directory in
> +the source tree, the @file{gdb-@var{version-number}} directory.  If you
> +run @code{configure} from one of the subordinate directories, you will
> +configure only that directory.

I sugegst to use ``subdirectory'' instead of ``subordinate
directory'', like this:

  You should run the @code{configure} script from the top directory in
  the source tree, the @file{gdb-@var{version-number}} directory.  If you
  run @code{configure} from one of its subdirectories, you will
  configure only that subdirectory.

> +In particular, if you run the first @code{configure} from the
> +@file{gdb} subordinate directory of the @file{gdb-@var{version-number}}
> +directory, you will omit the configuration of @file{bfd},
> +@file{readline}, and other subordinate directories.

Here, I suggest to use ``sibling directories'' as the collective term
for `bfd', `readline' and other subdirectories of gdb-VERSION.

It would also be nice to have some index entry for this text.  For
example:

  @cindex configuring @value{GDBN}, and source tree subdirectories