From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 20353 invoked by alias); 16 Jan 2003 05:57:51 -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 20345 invoked from network); 16 Jan 2003 05:57:49 -0000 Received: from unknown (HELO is.elta.co.il) (199.203.121.2) by sources.redhat.com with SMTP; 16 Jan 2003 05:57:49 -0000 Received: from is (is [199.203.121.2]) by is.elta.co.il (8.9.3/8.8.8) with SMTP id HAA24622; Thu, 16 Jan 2003 07:57:24 +0200 (IST) Date: Thu, 16 Jan 2003 05:57:00 -0000 From: Eli Zaretskii X-Sender: eliz@is To: Michael Elizabeth Chastain cc: gdb-patches@sources.redhat.com Subject: Re: [rfc] README, doc/gdb.texinfo: warn against '.../configure/gdb-N.N/gdb/configure' In-Reply-To: <200301151942.h0FJgjb29499@duracef.shout.net> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-SW-Source: 2003-01/txt/msg00595.txt.bz2 On Wed, 15 Jan 2003, Michael Elizabeth Chastain wrote: > 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'. I think I didn't explain myself clearly, because I didn't mean to ask to remove the names `bfd' and `readline'. I was just suggesting to say something like this: [...] you will omit the configuration of @file{bfd}, @file{readline}, and other sibling directories of the `gdb' subdirectory. Thanks.