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 19:43:12 +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 1224515690 30258 80.91.229.12 (20 Oct 2008 15:14:50 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 20 Oct 2008 15:14:50 +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 17:14:49 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 1KrsG5-0002LL-6G for ged-emacs-devel@m.gmane.org; Mon, 20 Oct 2008 12:45:09 +0200 Original-Received: from localhost ([127.0.0.1]:40118 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KrsEz-0007BN-VZ for ged-emacs-devel@m.gmane.org; Mon, 20 Oct 2008 06:44:02 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KrsEM-0006xI-L4 for emacs-devel@gnu.org; Mon, 20 Oct 2008 06:43:22 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KrsEK-0006wA-BB for emacs-devel@gnu.org; Mon, 20 Oct 2008 06:43:21 -0400 Original-Received: from [199.232.76.173] (port=50108 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KrsEK-0006vz-23 for emacs-devel@gnu.org; Mon, 20 Oct 2008 06:43:20 -0400 Original-Received: from mx1.aist.go.jp ([150.29.246.133]:60771) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1KrsEJ-0008QZ-Ch for emacs-devel@gnu.org; Mon, 20 Oct 2008 06:43:19 -0400 Original-Received: from rqsmtp1.aist.go.jp (rqsmtp1.aist.go.jp [150.29.254.115]) by mx1.aist.go.jp with ESMTP id m9KAhFpi024809; Mon, 20 Oct 2008 19:43:15 +0900 (JST) env-from (handa@m17n.org) Original-Received: from smtp3.aist.go.jp by rqsmtp1.aist.go.jp with ESMTP id m9KAhFbR010706; Mon, 20 Oct 2008 19:43:15 +0900 (JST) env-from (handa@m17n.org) Original-Received: by smtp3.aist.go.jp with ESMTP id m9KAhCkj016950; Mon, 20 Oct 2008 19:43:12 +0900 (JST) env-from (handa@m17n.org) Original-Received: from handa by etlken.m17n.org with local (Exim 4.69) (envelope-from ) id 1KrsEC-0007Fr-RG; Mon, 20 Oct 2008 19:43:12 +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-operating-system: by monty-python.gnu.org: Solaris 9 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:104668 Archived-At: In article , "Juanma Barranquero" writes: > On Mon, Oct 20, 2008 at 10:12, Kenichi Handa wrote: > > Anyway, if we > > write "inserted in buffer (after point and markers)", I > > think it means the text is inserted without moving point and > > markers. > I'm sure it means that. I think I would still have missed it, because > I misread the "inserted" as related to `insert', which moves the > point. > I would just add "The point does not move." or somesuch. But I'm not > good writing docs. Me neither. Could someone please improve these docstrings? encode-coding-region decode-coding-region encode-coding-string decode-coding-string --- Kenichi Handa handa@ni.aist.go.jp