emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Docstring of `decode-coding-string' a bit misleading about insertion


From: Kenichi Handa
Subject: Re: Docstring of `decode-coding-string' a bit misleading about insertion in buffer
Date: Mon, 20 Oct 2008 16:04:29 +0900
User-agent: SEMI/1.14.3 (Ushinoya) FLIM/1.14.2 (Yagi-Nishiguchi) APEL/10.2 Emacs/23.0.60 (i686-pc-linux-gnu) MULE/6.0 (HANACHIRUSATO)

In article <address@hidden>, "Juanma Barranquero" <address@hidden> writes:

> That's not a bug, I think, because decode-coding-string's docstring
> says nothing about the point:

>  Optional fourth arg buffer non-nil means that the decoded text is
>  inserted in buffer instead of returned as a string.  In this case,
>  the return value is the length of the decoded text.

> And I can see how decode-coding-string parallels decode-coding-region,
> where the decoded text replaces the original text without moving the
> point.

> However, the use of "inserted" in the docstring is a bit misleading,
> as `insert' does move the point. I know that "inserted" here does not
> mean that `insert' is used, but still it led me astray for a while.

How about adding "(after point and markers)" after "inserted
in buffer"?

---
Kenichi Handa
address@hidden




reply via email to

[Prev in Thread] Current Thread [Next in Thread]