From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] trunk r113909: Refine the documentation of `insert-buffer-substring'. Date: Fri, 16 Aug 2013 12:20:02 -0400 Message-ID: References: <838v02nona.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1376670025 30793 80.91.229.3 (16 Aug 2013 16:20:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 16 Aug 2013 16:20:25 +0000 (UTC) Cc: xfq.free@gmail.com, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Aug 16 18:20:26 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1VAMlF-0001RE-L9 for ged-emacs-devel@m.gmane.org; Fri, 16 Aug 2013 18:20:25 +0200 Original-Received: from localhost ([::1]:60102 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAMlF-0007CX-6L for ged-emacs-devel@m.gmane.org; Fri, 16 Aug 2013 12:20:25 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44253) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAMl5-0007BD-5d for emacs-devel@gnu.org; Fri, 16 Aug 2013 12:20:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VAMku-0005uq-Qe for emacs-devel@gnu.org; Fri, 16 Aug 2013 12:20:15 -0400 Original-Received: from chene.dit.umontreal.ca ([132.204.246.20]:37385) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAMku-0005t4-NE; Fri, 16 Aug 2013 12:20:04 -0400 Original-Received: from faina.iro.umontreal.ca (lechon.iro.umontreal.ca [132.204.27.242]) by chene.dit.umontreal.ca (8.14.1/8.14.1) with ESMTP id r7GGK3wN022073; Fri, 16 Aug 2013 12:20:03 -0400 Original-Received: by faina.iro.umontreal.ca (Postfix, from userid 20848) id 2B477B44A4; Fri, 16 Aug 2013 12:20:03 -0400 (EDT) In-Reply-To: <838v02nona.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 16 Aug 2013 09:19:37 +0300") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) X-NAI-Spam-Flag: NO X-NAI-Spam-Threshold: 5 X-NAI-Spam-Score: 0 X-NAI-Spam-Rules: 1 Rules triggered RV4672=0 X-NAI-Spam-Version: 2.3.0.9362 : core <4672> : streams <1020693> : uri <1508491> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 132.204.246.20 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:162819 Archived-At: > Are you saying that characters don't have positions? Obviously not. > We say "character at POSITION", and we mean that. We do say that at times, but note that the functions we provide have names like `char-after' and `char-before'. The naming was sometimes poorly chosen (e.g. `text-properties-at'), so we're not completely consistent here. > What is misleading here? That saying explicitly "inclusive" and "exclusive" means that using "at" is not just an abuse of language but is really how things should be understood. If we want to be more explicit, then rather than using "inclusive" and "exclusive", I'd rather we add a blurb like "Remember that positions are /between/ characters, so the char right \"at\" END will not be included". Stefan