From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 4233 invoked by alias); 18 Mar 2011 07:40:00 -0000 Received: (qmail 4092 invoked by uid 22791); 18 Mar 2011 07:39:58 -0000 X-SWARE-Spam-Status: No, hits=-6.1 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_HI,SPF_HELO_PASS,T_RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Fri, 18 Mar 2011 07:39:50 +0000 Received: from int-mx09.intmail.prod.int.phx2.redhat.com (int-mx09.intmail.prod.int.phx2.redhat.com [10.5.11.22]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id p2I7dkeK017521 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 18 Mar 2011 03:39:46 -0400 Received: from localhost.localdomain (ovpn01.gateway.prod.ext.phx2.redhat.com [10.5.9.1]) by int-mx09.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id p2I7djPb019721; Fri, 18 Mar 2011 03:39:45 -0400 From: Phil Muldoon To: Eli Zaretskii Cc: gdb-patches@sourceware.org Subject: Re: [patch] PR python/12149 (stderr output directed to stdout) References: <83wrjxsgn0.fsf@gnu.org> Reply-to: pmuldoon@redhat.com X-URL: http://www.redhat.com Date: Fri, 18 Mar 2011 10:23:00 -0000 In-Reply-To: <83wrjxsgn0.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 17 Mar 2011 21:15:15 +0200") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2011-03/txt/msg00908.txt.bz2 Eli Zaretskii writes: >> +@item STDERR >> +@value{GDBN}'s error stream. > > "standard error", I think. Ok. >> +@item STDLOG >> +@value{GDBN}'s log stream. > > This may need a word or two of explanation, because it's not a > standard stream like stdout and stderr. It goes to where "set > logging" directs it, right? If so, how about a cross-reference to > where the logging facility is described? Ok. >> +Flush a @value{GDBN} paginated stream. The optional @var{stream} >> +determines the stream to flush. The default stream is @value{GDBN}'s >> +standard output stream. Possible stream values are: > > Are you sure the reader will know the effect of "flushing" a strem > without any explanations? New doc patch inline. What do you think? Cheers Phil -- Index: doc/gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.813 diff -u -r1.813 gdb.texinfo --- doc/gdb.texinfo 17 Mar 2011 09:36:16 -0000 1.813 +++ doc/gdb.texinfo 18 Mar 2011 07:37:17 -0000 @@ -20877,18 +20877,64 @@ @end smallexample @end defun -@findex gdb.write -@defun write string -Print a string to @value{GDBN}'s paginated standard output stream. +@findex gdb.write +@defun write string @r{[}stream{]} +Print a string to @value{GDBN}'s paginated output stream. The +optional @var{stream} determines the stream to print to. The default +stream is @value{GDBN}'s standard output stream. Possible stream +values are: + +@table @code +@findex STDOUT +@findex gdb.STDOUT +@item STDOUT +@value{GDBN}'s standard output stream. + +@findex STDERR +@findex gdb.STDERR +@item STDERR +@value{GDBN}'s standard error stream. + +@findex STDLOG +@findex gdb.STDLOG +@item STDLOG +@value{GDBN}'s log stream (@pxref{Logging Output}). +@end table + Writing to @code{sys.stdout} or @code{sys.stderr} will automatically -call this function. +call this function and will automatically direct the output to the +relevant stream. @end defun @findex gdb.flush @defun flush -Flush @value{GDBN}'s paginated standard output stream. Flushing -@code{sys.stdout} or @code{sys.stderr} will automatically call this -function. +Flush the buffer of a @value{GDBN} paginated stream so that the +contents are displayed immediately. @value{GDBN} will flush the +contents of a stream automatically when it encounters a newline in the +buffer. The optional @var{stream} determines the stream to flush. The +default stream is @value{GDBN}'s standard output stream. Possible +stream values are: + +@table @code +@findex STDOUT +@findex gdb.STDOUT +@item STDOUT +@value{GDBN}'s standard output stream. + +@findex STDERR +@findex gdb.STDERR +@item STDERR +@value{GDBN}'s standard error stream. + +@findex STDLOG +@findex gdb.STDLOG +@item STDLOG +@value{GDBN}'s log stream (@pxref{Logging Output}). + +@end table + +Flushing @code{sys.stdout} or @code{sys.stderr} will automatically +call this function for the relevant stream. @end defun @findex gdb.target_charset