Mirror of the gdb-patches mailing list
 help / color / mirror / Atom feed
From: Eli Zaretskii <eliz@gnu.org>
To: Daniel Jacobowitz <drow@false.org>
Cc: gdb-patches@sourceware.org
Subject: Re: [RFC] Changes to signed char and unsigned char handling
Date: Fri, 06 Jul 2007 10:33:00 -0000	[thread overview]
Message-ID: <ufy41ddor.fsf@gnu.org> (raw)
In-Reply-To: <20070705135402.GA4300@caradoc.them.org> (message from Daniel 	Jacobowitz on Thu, 5 Jul 2007 09:54:02 -0400)

> Date: Thu, 5 Jul 2007 09:54:02 -0400
> From: Daniel Jacobowitz <drow@false.org>
> 
>  3.  Treat "char" as a character, but "unsigned char" and "signed char"
>  as numbers

Didn't RMS object to this change?

> Then I updated NEWS, the manual, and the testsuite to match.  What do
> you think - is this an appropriate resolution for GDB 6.7?  All
> comments welcome.

The change for NEWS is okay with me.

The changes for the manual are also okay, but I have a few
comments/requests:

> +@item s
> +@cindex printing strings

Please add here a @cindex entry for something like ``printing byte
arrays''.

> +as strings.  @code{unsigned char} and @code{signed char} are displayed as

Please include multi-word @code-marked-up text in @w.

> @@ -5932,8 +5946,7 @@ displays you request manually using @cod
>  specify the output format you prefer; in fact, @code{display} decides
>  whether to use @code{print} or @code{x} depending on how elaborate your
>  format specification is---it uses @code{x} if you specify a unit size,
> -or one of the two formats (@samp{i} and @samp{s}) that are only
> -supported by @code{x}; otherwise it uses @code{print}.
> +the @samp{i} format, or the @samp{s} format; otherwise it uses @code{print}.

This change produces a sentence that is hard to parse:

  in fact, @code{display} decides
  whether to use @code{print} or @code{x} depending on how elaborate your
  format specification is---it uses @code{x} if you specify a unit size,
  the @samp{i} format, or the @samp{s} format; otherwise it uses @code{print}.

The conditions under which `x' is used are described, but the
conditions under which we use `i' or `s' are left unspecified.

The old text was a bit better, I think, but only a bit:

  in fact, @code{display} decides
  whether to use @code{print} or @code{x} depending on how elaborate your
  format specification is---it uses @code{x} if you specify a unit size,
  or one of the two formats (@samp{i} and @samp{s}) that are only
  supported by @code{x}; otherwise it uses @code{print}.

In addition, the beginning of the sentence promises some relation
between the format used and how elaborate is the format specification,
but that relation is left somewhat unclear (this was unclear in the
old text as well).  I'm guessing that the only relation is whether the
unit size is or is not specified, but if that's indeed the only
relation, we should make the text less general and talk explicitly
about unit size specification.

Thanks.


  reply	other threads:[~2007-07-06 10:33 UTC|newest]

Thread overview: 13+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2007-07-05 13:54 Daniel Jacobowitz
2007-07-06 10:33 ` Eli Zaretskii [this message]
2007-07-06 21:34   ` Daniel Jacobowitz
2007-07-07 10:04     ` Eli Zaretskii
2007-07-07 17:06       ` Daniel Jacobowitz
2007-07-06 23:26   ` Nick Roberts
2007-07-06 23:46     ` Daniel Jacobowitz
2007-08-25  1:18 ` Daniel Jacobowitz
2007-08-25 10:19   ` Eli Zaretskii
2007-09-03 17:53   ` Daniel Jacobowitz
2007-09-04 13:58     ` Joel Brobecker
2007-09-04 22:40     ` Mark Kettenis
2007-09-05  0:51       ` Daniel Jacobowitz

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=ufy41ddor.fsf@gnu.org \
    --to=eliz@gnu.org \
    --cc=drow@false.org \
    --cc=gdb-patches@sourceware.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox