From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Kenichi Handa Newsgroups: gmane.emacs.devel Subject: Re: Docstring of `decode-coding-string' a bit misleading about insertion in buffer Date: Mon, 20 Oct 2008 16:04:29 +0900 Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 (generated by SEMI 1.14.3 - "Ushinoya") Content-Type: text/plain; charset=US-ASCII X-Trace: ger.gmane.org 1224512149 17857 80.91.229.12 (20 Oct 2008 14:15:49 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 20 Oct 2008 14:15:49 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Juanma Barranquero" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Oct 20 16:16:48 2008 connect(): Connection refused Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1Kropo-0002lN-Vj for ged-emacs-devel@m.gmane.org; Mon, 20 Oct 2008 09:05:57 +0200 Original-Received: from localhost ([127.0.0.1]:45026 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Krooj-0004Ba-Ak for ged-emacs-devel@m.gmane.org; Mon, 20 Oct 2008 03:04:41 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Kroof-0004BS-Mz for emacs-devel@gnu.org; Mon, 20 Oct 2008 03:04:37 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Krooe-0004BB-4D for emacs-devel@gnu.org; Mon, 20 Oct 2008 03:04:37 -0400 Original-Received: from [199.232.76.173] (port=44314 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Krooe-0004B8-0V for emacs-devel@gnu.org; Mon, 20 Oct 2008 03:04:36 -0400 Original-Received: from mx20.gnu.org ([199.232.41.8]:5581) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Krood-0001z1-Di for emacs-devel@gnu.org; Mon, 20 Oct 2008 03:04:35 -0400 Original-Received: from mx1.aist.go.jp ([150.29.246.133]) by mx20.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Krooc-0007dH-2r for emacs-devel@gnu.org; Mon, 20 Oct 2008 03:04:34 -0400 Original-Received: from rqsmtp1.aist.go.jp (rqsmtp1.aist.go.jp [150.29.254.115]) by mx1.aist.go.jp with ESMTP id m9K74Udj023719; Mon, 20 Oct 2008 16:04:30 +0900 (JST) env-from (handa@m17n.org) Original-Received: from smtp3.aist.go.jp by rqsmtp1.aist.go.jp with ESMTP id m9K74UQR023931; Mon, 20 Oct 2008 16:04:30 +0900 (JST) env-from (handa@m17n.org) Original-Received: by smtp3.aist.go.jp with ESMTP id m9K74Tmx016934; Mon, 20 Oct 2008 16:04:29 +0900 (JST) env-from (handa@m17n.org) Original-Received: from handa by etlken.m17n.org with local (Exim 4.69) (envelope-from ) id 1KrooX-0005t7-PR; Mon, 20 Oct 2008 16:04:29 +0900 In-reply-to: (lekktu@gmail.com) 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) X-detected-kernel: by mx20.gnu.org: Solaris 9 X-detected-operating-system: by monty-python.gnu.org: Genre and OS details not recognized. X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:104665 Archived-At: In article , "Juanma Barranquero" 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 handa@ni.aist.go.jp