all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#6576: documentation `string-to-char' is incorrect
@ 2010-07-06 21:34 MON KEY
  2010-07-07  7:12 ` Eli Zaretskii
  0 siblings, 1 reply; 20+ messages in thread
From: MON KEY @ 2010-07-06 21:34 UTC (permalink / raw)
  To: 6576

First sentence of doc string for `string-to-char' is incorrect.

,---- (documentation 'string-to-char )
| "Convert arg STRING to a character, the first character of that
| string.  A multibyte character is handled correctly.
|
| (fn STRING)"
`----

Should be something more like:

  "Return decimal integer value of first character in STRING."

The rationale for the proposed docstring change are:

- The second clause of sentence doesn't parse;

- The arg string (nor its 1st char) are _not_ converted, e.g.:

  (let ((not-cnvrtd "bubba"))
    (string-to-char not-cnvrtd)
    not-cnvrtd) ;; <- value of not-cnvrtd is a string not a char.

- It is more in keeping with what the manual says:

  ,---- (info "(elisp)Basic Char Syntax")
  | Since characters are really integers, the printed representation
  | of a character is a decimal number.
  `----

Affliced docstring appears in GNU Emacs 23.2.1 and current through
Bzr-100633

--
/s_P\





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2010-07-06 21:34 bug#6576: documentation `string-to-char' is incorrect MON KEY
@ 2010-07-07  7:12 ` Eli Zaretskii
  2010-07-07  8:40   ` Andreas Schwab
  0 siblings, 1 reply; 20+ messages in thread
From: Eli Zaretskii @ 2010-07-07  7:12 UTC (permalink / raw)
  To: MON KEY; +Cc: 6576

> Date: Tue, 6 Jul 2010 17:34:41 -0400
> From: MON KEY <monkey@sandpframing.com>
> Cc: 
> 
> First sentence of doc string for `string-to-char' is incorrect.
> 
> ,---- (documentation 'string-to-char )
> | "Convert arg STRING to a character, the first character of that
> | string.  A multibyte character is handled correctly.
> |
> | (fn STRING)"
> `----
> 
> Should be something more like:
> 
>   "Return decimal integer value of first character in STRING."

The "decimal" thing has no place here, because we are not talking
about the printed representation of that integer.

I would suggest the following, which also takes care of the second
sentence in the current doc string:

  "Return the Unicode codepoint of the first character of STRING.
  Note: eight-bit characters are returned as single-byte values in the
  range 160 to 255, inclusive."





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2010-07-07  7:12 ` Eli Zaretskii
@ 2010-07-07  8:40   ` Andreas Schwab
  2010-07-07 10:31     ` Eli Zaretskii
  0 siblings, 1 reply; 20+ messages in thread
From: Andreas Schwab @ 2010-07-07  8:40 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: MON KEY, 6576

Eli Zaretskii <eliz@gnu.org> writes:

>   "Return the Unicode codepoint of the first character of STRING.

This is not correct.  The value is just the internal encoding of the
character.  It's identical to (aref STRING 0) except that it returns 0
for the empty string.

>   Note: eight-bit characters are returned as single-byte values in the
>   range 160 to 255, inclusive."

That depends on the multibyteness of the string.

Andreas.

-- 
Andreas Schwab, schwab@linux-m68k.org
GPG Key fingerprint = 58CA 54C7 6D53 942B 1756  01D3 44D5 214B 8276 4ED5
"And now for something completely different."





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2010-07-07  8:40   ` Andreas Schwab
@ 2010-07-07 10:31     ` Eli Zaretskii
  2010-07-07 12:16       ` Andreas Schwab
  0 siblings, 1 reply; 20+ messages in thread
From: Eli Zaretskii @ 2010-07-07 10:31 UTC (permalink / raw)
  To: Andreas Schwab; +Cc: monkey, 6576

> From: Andreas Schwab <schwab@linux-m68k.org>
> Cc: MON KEY <monkey@sandpframing.com>,  6576@debbugs.gnu.org
> Date: Wed, 07 Jul 2010 10:40:00 +0200
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> >   "Return the Unicode codepoint of the first character of STRING.
> 
> This is not correct.  The value is just the internal encoding of the
> character.

Which is Unicode, AFAIK.  The note takes care of the extension that
is specific to Emacs.  If there are other extensions that I forgot, we
can add more notes.

> It's identical to (aref STRING 0)

I don't think talking about `(aref STRING 0)' in a doc string is a
good idea.  Only people who know quite a lot about the internal
representation and what aref does in this case will understand such a
documentation.

> except that it returns 0 for the empty string

This fact should probably be mentioned in the doc string.

> >   Note: eight-bit characters are returned as single-byte values in the
> >   range 160 to 255, inclusive."
> 
> That depends on the multibyteness of the string.

Eight-bit characters are defined as such only in multibyte strings.

But I think the note is correct for unibyte strings as well, because
they by definition include raw bytes.





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2010-07-07 10:31     ` Eli Zaretskii
@ 2010-07-07 12:16       ` Andreas Schwab
  2010-07-07 14:23         ` Eli Zaretskii
  0 siblings, 1 reply; 20+ messages in thread
From: Andreas Schwab @ 2010-07-07 12:16 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: monkey, 6576

Eli Zaretskii <eliz@gnu.org> writes:

>> From: Andreas Schwab <schwab@linux-m68k.org>
>> Cc: MON KEY <monkey@sandpframing.com>,  6576@debbugs.gnu.org
>> Date: Wed, 07 Jul 2010 10:40:00 +0200
>> 
>> Eli Zaretskii <eliz@gnu.org> writes:
>> 
>> >   "Return the Unicode codepoint of the first character of STRING.
>> 
>> This is not correct.  The value is just the internal encoding of the
>> character.
>
> Which is Unicode, AFAIK.

No, it is an extension of Unicode.  Eight-bit characters, for example,
are not part of Unicode.

>> >   Note: eight-bit characters are returned as single-byte values in the
>> >   range 160 to 255, inclusive."
>> 
>> That depends on the multibyteness of the string.
>
> Eight-bit characters are defined as such only in multibyte strings.

That makes it even more incorrect.  For multibyte strings you'll get the
internal encoding, which is not in the range 160 to 255.

Andreas.

-- 
Andreas Schwab, schwab@linux-m68k.org
GPG Key fingerprint = 58CA 54C7 6D53 942B 1756  01D3 44D5 214B 8276 4ED5
"And now for something completely different."





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2010-07-07 12:16       ` Andreas Schwab
@ 2010-07-07 14:23         ` Eli Zaretskii
  2010-07-07 15:46           ` Eli Zaretskii
  0 siblings, 1 reply; 20+ messages in thread
From: Eli Zaretskii @ 2010-07-07 14:23 UTC (permalink / raw)
  To: Andreas Schwab; +Cc: monkey, 6576

> From: Andreas Schwab <schwab@linux-m68k.org>
> Cc: monkey@sandpframing.com,  6576@debbugs.gnu.org
> Date: Wed, 07 Jul 2010 14:16:28 +0200
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> >> From: Andreas Schwab <schwab@linux-m68k.org>
> >> Cc: MON KEY <monkey@sandpframing.com>,  6576@debbugs.gnu.org
> >> Date: Wed, 07 Jul 2010 10:40:00 +0200
> >> 
> >> Eli Zaretskii <eliz@gnu.org> writes:
> >> 
> >> >   "Return the Unicode codepoint of the first character of STRING.
> >> 
> >> This is not correct.  The value is just the internal encoding of the
> >> character.
> >
> > Which is Unicode, AFAIK.
> 
> No, it is an extension of Unicode.  Eight-bit characters, for example,
> are not part of Unicode.

And that's why there's this note:

> >> >   Note: eight-bit characters are returned as single-byte values in the
> >> >   range 160 to 255, inclusive."
> >> 
> >> That depends on the multibyteness of the string.
> >
> > Eight-bit characters are defined as such only in multibyte strings.
> 
> That makes it even more incorrect.  For multibyte strings you'll get the
> internal encoding, which is not in the range 160 to 255.

Sounds like a bug, assuming it's true.





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2010-07-07 14:23         ` Eli Zaretskii
@ 2010-07-07 15:46           ` Eli Zaretskii
  2011-07-13 23:50             ` Lars Magne Ingebrigtsen
  0 siblings, 1 reply; 20+ messages in thread
From: Eli Zaretskii @ 2010-07-07 15:46 UTC (permalink / raw)
  To: schwab, monkey; +Cc: 6576

> Date: Wed, 07 Jul 2010 17:23:40 +0300
> From: Eli Zaretskii <eliz@gnu.org>
> Cc: monkey@sandpframing.com, 6576@debbugs.gnu.org
> 
> > >> >   Note: eight-bit characters are returned as single-byte values in the
> > >> >   range 160 to 255, inclusive."
> > >> 
> > >> That depends on the multibyteness of the string.
> > >
> > > Eight-bit characters are defined as such only in multibyte strings.
> > 
> > That makes it even more incorrect.  For multibyte strings you'll get the
> > internal encoding, which is not in the range 160 to 255.
> 
> Sounds like a bug, assuming it's true.

Actually, there's no way we could return the eight-bit characters in
the 160 to 255 range, since that range is already taken by Unicode
codepoints of Latin characters.  So how about

  "Return the codepoint of the first character of STRING.

  Value is the Unicode codepoint, if it is below #x110000 (in hex).
  Codepoints beyond that are Emacs extensions of Unicode.  In
  particular, eight-bit characters are returned as codepoints in
  the range #x3FFF80 through #x3FFFFF, inclusive."





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2010-07-07 15:46           ` Eli Zaretskii
@ 2011-07-13 23:50             ` Lars Magne Ingebrigtsen
  2011-07-14  2:13               ` Chong Yidong
  2011-07-14  3:06               ` Eli Zaretskii
  0 siblings, 2 replies; 20+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-13 23:50 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: monkey, schwab, 6576

Eli Zaretskii <eliz@gnu.org> writes:

> Actually, there's no way we could return the eight-bit characters in
> the 160 to 255 range, since that range is already taken by Unicode
> codepoints of Latin characters.  So how about
>
>   "Return the codepoint of the first character of STRING.
>
>   Value is the Unicode codepoint, if it is below #x110000 (in hex).
>   Codepoints beyond that are Emacs extensions of Unicode.  In
>   particular, eight-bit characters are returned as codepoints in
>   the range #x3FFF80 through #x3FFFFF, inclusive."

I've now installed a slight variation on this in Emacs 24.

But after checking it in, I started wondering whether this doc string
really makes sense.  The function returns an Emacs character, and it
would be rather weird if all functions that take or return an Emacs
character goes through that entire explanation.

Is there a specific reason this particular function deserves this
detailed explanation?

If not, I'd rather just revert the change I just checked in...

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-13 23:50             ` Lars Magne Ingebrigtsen
@ 2011-07-14  2:13               ` Chong Yidong
  2011-07-14 13:02                 ` Lars Magne Ingebrigtsen
  2011-07-14  3:06               ` Eli Zaretskii
  1 sibling, 1 reply; 20+ messages in thread
From: Chong Yidong @ 2011-07-14  2:13 UTC (permalink / raw)
  To: Lars Magne Ingebrigtsen; +Cc: monkey, schwab, 6576

Lars Magne Ingebrigtsen <larsi@gnus.org> writes:

> I've now installed a slight variation on this in Emacs 24.
>
> But after checking it in, I started wondering whether this doc string
> really makes sense.  The function returns an Emacs character, and it
> would be rather weird if all functions that take or return an Emacs
> character goes through that entire explanation.
>
> Is there a specific reason this particular function deserves this
> detailed explanation?

How bout linking to the `String and Character Basics' node in the Elisp
manual instead?





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-13 23:50             ` Lars Magne Ingebrigtsen
  2011-07-14  2:13               ` Chong Yidong
@ 2011-07-14  3:06               ` Eli Zaretskii
  2011-07-14 13:00                 ` Lars Magne Ingebrigtsen
  1 sibling, 1 reply; 20+ messages in thread
From: Eli Zaretskii @ 2011-07-14  3:06 UTC (permalink / raw)
  To: Lars Magne Ingebrigtsen; +Cc: monkey, schwab, 6576

> From: Lars Magne Ingebrigtsen <larsi@gnus.org>
> Cc: schwab@linux-m68k.org,  monkey@sandpframing.com,  6576@debbugs.gnu.org
> Date: Thu, 14 Jul 2011 01:50:59 +0200
> 
> >   "Return the codepoint of the first character of STRING.
> >
> >   Value is the Unicode codepoint, if it is below #x110000 (in hex).
> >   Codepoints beyond that are Emacs extensions of Unicode.  In
> >   particular, eight-bit characters are returned as codepoints in
> >   the range #x3FFF80 through #x3FFFFF, inclusive."
> 
> I've now installed a slight variation on this in Emacs 24.
> 
> But after checking it in, I started wondering whether this doc string
> really makes sense.  The function returns an Emacs character, and it
> would be rather weird if all functions that take or return an Emacs
> character goes through that entire explanation.

Which other functions would need this?

> Is there a specific reason this particular function deserves this
> detailed explanation?

If you can suggest a better one that takes care of the original bug
report, please show your suggestion.





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-14  3:06               ` Eli Zaretskii
@ 2011-07-14 13:00                 ` Lars Magne Ingebrigtsen
  2011-07-14 13:34                   ` Eli Zaretskii
  0 siblings, 1 reply; 20+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-14 13:00 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: monkey, schwab, 6576

Eli Zaretskii <eliz@gnu.org> writes:

>> But after checking it in, I started wondering whether this doc string
>> really makes sense.  The function returns an Emacs character, and it
>> would be rather weird if all functions that take or return an Emacs
>> character goes through that entire explanation.
>
> Which other functions would need this?

`char-after', `aref' on a string, `following-char'...  Basically
anything that returns a character.

>> Is there a specific reason this particular function deserves this
>> detailed explanation?
>
> If you can suggest a better one that takes care of the original bug
> report, please show your suggestion.

I think "close, notabug" would have taken care of the bug report.  :-)

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-14  2:13               ` Chong Yidong
@ 2011-07-14 13:02                 ` Lars Magne Ingebrigtsen
  0 siblings, 0 replies; 20+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-14 13:02 UTC (permalink / raw)
  To: Chong Yidong; +Cc: monkey, schwab, 6576

Chong Yidong <cyd@stupidchicken.com> writes:

> How bout linking to the `String and Character Basics' node in the Elisp
> manual instead?

I can do that if you want, but wouldn't it be better just to leave it as

--
Return the first character in STRING.
A multibyte character is handled correctly.
--

If somebody then wonders (and they shouldn't) "hm, what's a character,
then?", they probably already know that a manual exists.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-14 13:00                 ` Lars Magne Ingebrigtsen
@ 2011-07-14 13:34                   ` Eli Zaretskii
  2011-07-14 14:06                     ` Lars Magne Ingebrigtsen
  0 siblings, 1 reply; 20+ messages in thread
From: Eli Zaretskii @ 2011-07-14 13:34 UTC (permalink / raw)
  To: Lars Magne Ingebrigtsen; +Cc: monkey, schwab, 6576

> From: Lars Magne Ingebrigtsen <larsi@gnus.org>
> Cc: schwab@linux-m68k.org,  monkey@sandpframing.com,  6576@debbugs.gnu.org
> Date: Thu, 14 Jul 2011 15:00:17 +0200
> 
> > Which other functions would need this?
> 
> `char-after', `aref' on a string, `following-char'...  Basically
> anything that returns a character.
> 
> >> Is there a specific reason this particular function deserves this
> >> detailed explanation?
> >
> > If you can suggest a better one that takes care of the original bug
> > report, please show your suggestion.
> 
> I think "close, notabug" would have taken care of the bug report.  :-)

The original problem which triggered the report was this part, and
this part only:

    A multibyte character is handled correctly.

To make a decent job for this bug, we need, as a minimum, to do
something with this unparsable sentence.  I admit that my suggestion
went well beyond that, but if we want to take a step back, please
suggest what to say instead.  I hope you agree that this sentence
cannot be left as-is.

(To know what is meant by this sentence, look at the source of the
function.)





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-14 13:34                   ` Eli Zaretskii
@ 2011-07-14 14:06                     ` Lars Magne Ingebrigtsen
  2011-07-14 15:59                       ` Eli Zaretskii
  0 siblings, 1 reply; 20+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-14 14:06 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: monkey, schwab, 6576

Eli Zaretskii <eliz@gnu.org> writes:

> The original problem which triggered the report was this part, and
> this part only:
>
>     A multibyte character is handled correctly.

I understand why it is there, because (presumably) in the olden times,
this wasn't always true?

But I think that line can be deleted, too.  If the function returns the
first character, then it returns the first character...

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-14 14:06                     ` Lars Magne Ingebrigtsen
@ 2011-07-14 15:59                       ` Eli Zaretskii
  2011-07-14 16:12                         ` Lars Magne Ingebrigtsen
  0 siblings, 1 reply; 20+ messages in thread
From: Eli Zaretskii @ 2011-07-14 15:59 UTC (permalink / raw)
  To: Lars Magne Ingebrigtsen; +Cc: monkey, schwab, 6576

> From: Lars Magne Ingebrigtsen <larsi@gnus.org>
> Cc: schwab@linux-m68k.org,  monkey@sandpframing.com,  6576@debbugs.gnu.org
> Date: Thu, 14 Jul 2011 16:06:34 +0200
> 
> >     A multibyte character is handled correctly.
> 
> I understand why it is there, because (presumably) in the olden times,
> this wasn't always true?
> 
> But I think that line can be deleted, too.

If you delete it, how would users know what does this function do with
unibyte strings?  What numerical value will it return when passed a
unibyte string?





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-14 15:59                       ` Eli Zaretskii
@ 2011-07-14 16:12                         ` Lars Magne Ingebrigtsen
  2011-07-14 19:37                           ` Eli Zaretskii
  0 siblings, 1 reply; 20+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-14 16:12 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: monkey, schwab, 6576

Eli Zaretskii <eliz@gnu.org> writes:

> If you delete it, how would users know what does this function do with
> unibyte strings?  What numerical value will it return when passed a
> unibyte string?

Isn't the same the case with `char-after' in a unibyte buffer, for
instance? 

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-14 16:12                         ` Lars Magne Ingebrigtsen
@ 2011-07-14 19:37                           ` Eli Zaretskii
  2011-07-14 19:39                             ` Lars Magne Ingebrigtsen
  0 siblings, 1 reply; 20+ messages in thread
From: Eli Zaretskii @ 2011-07-14 19:37 UTC (permalink / raw)
  To: Lars Magne Ingebrigtsen; +Cc: monkey, schwab, 6576

> From: Lars Magne Ingebrigtsen <larsi@gnus.org>
> Cc: schwab@linux-m68k.org,  monkey@sandpframing.com,  6576@debbugs.gnu.org
> Date: Thu, 14 Jul 2011 18:12:24 +0200
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> > If you delete it, how would users know what does this function do with
> > unibyte strings?  What numerical value will it return when passed a
> > unibyte string?
> 
> Isn't the same the case with `char-after' in a unibyte buffer, for
> instance? 

Yes, but so what?  Are you sure users know what that does?





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-14 19:37                           ` Eli Zaretskii
@ 2011-07-14 19:39                             ` Lars Magne Ingebrigtsen
  2011-07-15 19:06                               ` MON KEY
  0 siblings, 1 reply; 20+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-14 19:39 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: monkey, schwab, 6576

Eli Zaretskii <eliz@gnu.org> writes:

> Yes, but so what?  Are you sure users know what that does?

No, not really.  :-)  I think these functions should say that they
return a character, and if that's not sufficient, they should refer you
to the manual to explain what Emacs means by a character.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-14 19:39                             ` Lars Magne Ingebrigtsen
@ 2011-07-15 19:06                               ` MON KEY
  2011-07-21 18:38                                 ` Chong Yidong
  0 siblings, 1 reply; 20+ messages in thread
From: MON KEY @ 2011-07-15 19:06 UTC (permalink / raw)
  To: Lars Magne Ingebrigtsen; +Cc: schwab, 6576

On Thu, Jul 14, 2011 at 3:39 PM, Lars Magne Ingebrigtsen <larsi@gnus.org> wrote:

> No, not really.  :-)  I think these functions should say that they
> return a character, and if that's not sufficient, they should refer you
> to the manual to explain what Emacs means by a character.

If it doesn't do what it says or then a pointer into the manual won't
help clarify the underlying issue and only glosses over it.


--
/s_P\





^ permalink raw reply	[flat|nested] 20+ messages in thread

* bug#6576: documentation `string-to-char' is incorrect
  2011-07-15 19:06                               ` MON KEY
@ 2011-07-21 18:38                                 ` Chong Yidong
  0 siblings, 0 replies; 20+ messages in thread
From: Chong Yidong @ 2011-07-21 18:38 UTC (permalink / raw)
  To: MON KEY; +Cc: Lars Magne Ingebrigtsen, schwab, 6576

MON KEY <monkey@sandpframing.com> writes:

>> I think these functions should say that they return a character, and
>> if that's not sufficient, they should refer you to the manual to
>> explain what Emacs means by a character.
>
> If it doesn't do what it says or then a pointer into the manual won't
> help clarify the underlying issue and only glosses over it.

I removed the explanation of what a character is; there's no need to do
that here, or in all the other character-related functions like
char-after.





^ permalink raw reply	[flat|nested] 20+ messages in thread

end of thread, other threads:[~2011-07-21 18:38 UTC | newest]

Thread overview: 20+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2010-07-06 21:34 bug#6576: documentation `string-to-char' is incorrect MON KEY
2010-07-07  7:12 ` Eli Zaretskii
2010-07-07  8:40   ` Andreas Schwab
2010-07-07 10:31     ` Eli Zaretskii
2010-07-07 12:16       ` Andreas Schwab
2010-07-07 14:23         ` Eli Zaretskii
2010-07-07 15:46           ` Eli Zaretskii
2011-07-13 23:50             ` Lars Magne Ingebrigtsen
2011-07-14  2:13               ` Chong Yidong
2011-07-14 13:02                 ` Lars Magne Ingebrigtsen
2011-07-14  3:06               ` Eli Zaretskii
2011-07-14 13:00                 ` Lars Magne Ingebrigtsen
2011-07-14 13:34                   ` Eli Zaretskii
2011-07-14 14:06                     ` Lars Magne Ingebrigtsen
2011-07-14 15:59                       ` Eli Zaretskii
2011-07-14 16:12                         ` Lars Magne Ingebrigtsen
2011-07-14 19:37                           ` Eli Zaretskii
2011-07-14 19:39                             ` Lars Magne Ingebrigtsen
2011-07-15 19:06                               ` MON KEY
2011-07-21 18:38                                 ` Chong Yidong

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.