From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-17262-listarch-gdb-patches=sourceware.cygnus.com@sources.redhat.com>
Received: (qmail 22191 invoked by alias); 1 Aug 2002 19:16:34 -0000
Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:gdb-patches-subscribe@sources.redhat.com>
List-Archive: <http://sources.redhat.com/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sources.redhat.com>
List-Help: <mailto:gdb-patches-help@sources.redhat.com>, <http://sources.redhat.com/ml/#faqs>
Sender: gdb-patches-owner@sources.redhat.com
Received: (qmail 22173 invoked from network); 1 Aug 2002 19:16:31 -0000
Received: from unknown (HELO jackfruit.Stanford.EDU) (171.64.38.136)
  by sources.redhat.com with SMTP; 1 Aug 2002 19:16:31 -0000
Received: (from carlton@localhost)
	by jackfruit.Stanford.EDU (8.11.6/8.11.6) id g71JGUK04983;
	Thu, 1 Aug 2002 12:16:30 -0700
From: david carlton <carlton@math.Stanford.EDU>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Message-ID: <15689.35085.998410.672452@jackfruit.Stanford.EDU>
Date: Thu, 01 Aug 2002 12:16:00 -0000
To: Daniel Jacobowitz <drow@mvista.com>
Cc: david carlton <carlton@math.Stanford.EDU>,
   Andrew Cagney <ac131313@ges.redhat.com>, gdb-patches@sources.redhat.com
Subject: Re: RFA: >, >>, and "tee" operators
In-Reply-To: <20020801190348.GA4426@nevyn.them.org>
References: <20020725031026.GA20117@nevyn.them.org>
	<3D401D50.4030009@ges.redhat.com>
	<20020725161749.GA10862@nevyn.them.org>
	<3D40371D.6070603@ges.redhat.com>
	<20020730191825.GA17620@nevyn.them.org>
	<3D4758A5.8050605@ges.redhat.com>
	<15688.4371.193070.843000@jackfruit.Stanford.EDU>
	<20020731163628.GA5436@nevyn.them.org>
	<3D494E38.3080106@ges.redhat.com>
	<15689.28390.400986.70448@jackfruit.Stanford.EDU>
	<20020801190348.GA4426@nevyn.them.org>
Cc: carlton@math.Stanford.EDU
X-SW-Source: 2002-08/txt/msg00012.txt.bz2

On Thu, 1 Aug 2002 15:03:48 -0400, Daniel Jacobowitz <drow@mvista.com> said:

> +@table @code
> +@kindex redirect
> +@item redirect [-a] [@var{file} [@var{command}]]
> +Redirect all output to @var{file}.
> +@kindex log
> +@item log [-a] [@var{file} [@var{command}]]
> +Copy output to both the screen and @var{file}.
> +@end table
> +
> +Both @code{redirect} and @code{log} default to overwriting the log file,
> +unless @code{-a} is specified.

Personally, I'd say

  Both @code{redirect} and @code{log} default to overwriting
  $var{file} unless @code{-a} is specified, in which case they append
  to $var{file}.

So two changes: replace "the log file" with "$var{file}" (after all,
is it really a log file if you're using redirect instead of log?), and
make it a bit more explicit what the alternate behaviour is, just in
case the person reading the documentation hasn't gotten much sleep
recently.  (And I guess I deleted a comma as well, for better or for
worse: I like the comma in your version but don't like once the bit
about appending is added.)

Incidentally, I hope I'm not being out-of-place in making comments
like this or my earlier ones about syntax; I realize that I'm new to
this list and have comparatively little experience with GDB.  I
certainly wouldn't comment on matters internal to GDB without more
experience than I have now.

David Carlton
carlton@math.stanford.edu