X-Authentication-Warning: delorie.com: mail set sender to djgpp-workers-bounces using -f
Date: Thu, 12 May 2005 10:02:23 +0300
From: "Eli Zaretskii" <eliz AT gnu DOT org>
Sender: halo1 AT zahav DOT net DOT il
To: Ian Lance Taylor <ian AT airs DOT com>
Message-ID: <01c556c0$Blat.v2.4$b16011e0@zahav.net.il>
Content-Transfer-Encoding: 7BIT
Content-Type: text/plain; charset=ISO-8859-1
X-Mailer: emacs 22.0.50 (via feedmail 8 I) and Blat ver 2.4
CC: djgpp-workers AT delorie DOT com, gcc-patches AT gcc DOT gnu DOT org,
   gdb-patches AT sourceware DOT org
In-reply-to: <m38y2lqjaw.fsf@gossamer.airs.com> (message from Ian Lance Taylor
	on 11 May 2005 22:17:43 -0400)
Subject: Re: RFA: fix libiberty/pex-djgpp.c
References: <01c5565c$Blat.v2.4$082130a0 AT zahav DOT net DOT il>
	<m3y8alqzgx DOT fsf AT gossamer DOT airs DOT com>
	<01c55680$Blat.v2.4$9ebe4740 AT zahav DOT net DOT il> <m38y2lqjaw DOT fsf AT gossamer DOT airs DOT com>
Reply-To: djgpp-workers AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: djgpp-workers AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk

> Cc: djgpp-workers AT delorie DOT com, gcc-patches AT gcc DOT gnu DOT org,
>   gdb-patches AT sourceware DOT org
> From: Ian Lance Taylor <ian AT airs DOT com>
> Date: 11 May 2005 22:17:43 -0400
> 
> > It's not easy to figure out what is needed and in what conditions.  It
> > would be nice if this machinery were to be documented a bit more
> > methodically.  Right now, the information is scattered between
> > pex-common.h, include/libiberty.h and a few comments in pex-*.c files.
> 
> Don't forget pexecute.txh.

Yes, but what's missing from all of these places is the overview (or
an example) of how would one go about running a pipeline of processes
using these functions, and a guided walk through the orchestrated
operation of these functions during such a pipeline, which would
explain the importance of each one in the process.  The pieces are
there, but the glue is missing, and since there are so many pieces and
tiny details, one can easily get lost in them.