Re: RFA: >, >>, and "tee" operators

david carlton
2002-08-01T19:16:34Z

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