From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 5959 invoked by alias); 15 Jan 2003 19:42:52 -0000 Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sources.redhat.com Received: (qmail 5940 invoked from network); 15 Jan 2003 19:42:51 -0000 Received: from unknown (HELO duracef.shout.net) (204.253.184.12) by sources.redhat.com with SMTP; 15 Jan 2003 19:42:51 -0000 Received: (from mec@localhost) by duracef.shout.net (8.11.6/8.11.6) id h0FJgjb29499; Wed, 15 Jan 2003 13:42:45 -0600 Date: Wed, 15 Jan 2003 19:42:00 -0000 From: Michael Elizabeth Chastain Message-Id: <200301151942.h0FJgjb29499@duracef.shout.net> To: eliz@is.elta.co.il Subject: Re: [rfc] README, doc/gdb.texinfo: warn against '.../configure/gdb-N.N/gdb/configure' Cc: gdb-patches@sources.redhat.com X-SW-Source: 2003-01/txt/msg00577.txt.bz2 Hi Eli, > I sugegst to use ``subdirectory'' instead of ``subordinate > directory'', like this: Done. I had a ``subordinate'' lying around somewhere in my brain's L1 cache. mec> +In particular, if you run the first @code{configure} from the mec> +@file{gdb} subordinate directory of the @file{gdb-@var{version-number}} mec> +directory, you will omit the configuration of @file{bfd}, mec> +@file{readline}, and other subordinate directories. eli> Here, I suggest to use ``sibling directories'' as the collective term eli> for `bfd', `readline' and other subdirectories of gdb-VERSION. I don't want to do this. Documentation is for humans, not other computer programs. Humans learn by example. When I write `bfd' and `readline', it's clear what I'm talking about. If I write `sibling directories', then the readers will be confused. Talking about `siblings of gdb' does not help because the directory name `gdb' is already overloaded. The whole section already talks about `gdb-VERSION' and its subdirectories, including `gdb', but people still run `configure' in the wrong directory and then come to us for help. And I think there is no problem with getting specific about `bfd' and `readline' because this section already specifically mentions these names as 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 Done. The CVS repository is not responding right now, so I can't make another diff yet. Michael C