From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 8251 invoked by alias); 3 Nov 2007 18:43:50 -0000 Received: (qmail 8239 invoked by uid 22791); 3 Nov 2007 18:43:49 -0000 X-Spam-Check-By: sourceware.org Received: from heller.inter.net.il (HELO heller.inter.net.il) (213.8.233.23) by sourceware.org (qpsmtpd/0.31) with ESMTP; Sat, 03 Nov 2007 18:43:43 +0000 Received: from HOME-C4E4A596F7 (IGLD-84-228-244-58.inter.net.il [84.228.244.58]) by heller.inter.net.il (MOS 3.7.3a-GA) with ESMTP id EAO84816 (AUTH halo1); Sat, 3 Nov 2007 20:43:28 +0200 (IST) Date: Sat, 03 Nov 2007 18:43:00 -0000 Message-Id: From: Eli Zaretskii To: Daniel Jacobowitz CC: gdb-patches@sourceware.org, ukleinek@informatik.uni-freiburg.de In-reply-to: <20071103161956.GA7885@caradoc.them.org> (message from Daniel Jacobowitz on Sat, 3 Nov 2007 12:19:56 -0400) Subject: Re: [rfa] Clarify remote protocol RLE example Reply-to: Eli Zaretskii References: <20071103161956.GA7885@caradoc.them.org> 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: 2007-11/txt/msg00030.txt.bz2 > Date: Sat, 3 Nov 2007 12:19:56 -0400 > From: Daniel Jacobowitz > Cc: Eli Zaretskii , ukleinek@informatik.uni-freiburg.de > > Uwe pointed out that the example in the GDB manual for run-length > encoding is a bit confusing. It suggests that "0* " should expand > to 000, but in fact it expands to 0000, because the initial zero > is counted separately. > > Is this version clearer? OK to commit? Well, I still needed to read the text 2 or 3 times before I understood what it tries to say. How about this version instead: Response @var{data} can be run-length encoded to save space. Run-length encoding replaces runs of identical characters > Response @var{data} can be run-length encoded to save space. A @samp{*} > means that the next character is an @sc{ascii} encoding giving a repeat count > -which stands for that many repetitions of the character preceding the > +which stands for that many additional repetitions of the character preceding the > @samp{*}. The encoding is @code{n+29}, yielding a printable character > where @code{n >=3} (which is where rle starts to win). The printable > characters @samp{$}, @samp{#}, @samp{+} and @samp{-} or with a numeric > value greater than 126 should not be used. > > So: > @smallexample > "@code{0* }" > @end smallexample > @noindent > -means the same as "0000". > +means the same as "0000". The initial @code{0} contributes one zero, > +and the space (@sc{ascii} 32) contributes a repeat count of three > +additional zeros. > > The error response returned for some packets includes a two character > error number. That number is not well defined. > > @cindex empty response, for unsupported packets >