From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] trunk r113909: Refine the documentation of `insert-buffer-substring'. Date: Sun, 18 Aug 2013 22:30:22 +0300 Message-ID: <83k3jilru9.fsf@gnu.org> References: <838v02nona.fsf@gnu.org> <83d2pdmq84.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1376854215 6182 80.91.229.3 (18 Aug 2013 19:30:15 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 18 Aug 2013 19:30:15 +0000 (UTC) Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Xue Fuqiao Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Aug 18 21:30:17 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 1VB8g3-00020a-Fz for ged-emacs-devel@m.gmane.org; Sun, 18 Aug 2013 21:30:15 +0200 Original-Received: from localhost ([::1]:39811 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VB8g2-0007Sa-QZ for ged-emacs-devel@m.gmane.org; Sun, 18 Aug 2013 15:30:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51154) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VB8ft-0007Ks-FH for emacs-devel@gnu.org; Sun, 18 Aug 2013 15:30:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VB8fm-0006ew-Oi for emacs-devel@gnu.org; Sun, 18 Aug 2013 15:30:05 -0400 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:37960) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VB8fm-0006ej-HE for emacs-devel@gnu.org; Sun, 18 Aug 2013 15:29:58 -0400 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0MRQ00G00RBQEW00@a-mtaout22.012.net.il> for emacs-devel@gnu.org; Sun, 18 Aug 2013 22:29:43 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MRQ00G3VRHJC920@a-mtaout22.012.net.il>; Sun, 18 Aug 2013 22:29:43 +0300 (IDT) In-reply-to: X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.172 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:162861 Archived-At: > Date: Sun, 18 Aug 2013 06:27:25 +0800 > From: Xue Fuqiao > Cc: Stefan Monnier , emacs-devel > > This rule applies to all functions that use the region. More generally, > it applies all functions that use BEG and END if they are buffer positions. > > Since there are too many functions, IMO a better approach is remove them > ("inclusive" and "exclusive") from their own documentation and add a > blurb like Stefan said in a node like (info "(elisp) The Region"). Like I said, I don't see anything wrong with "inclusive" and "exclusive". But if you want a good place to add such a blurb, do that in the preamble in the node "Text", which already tries to say something along these lines. By contrast, "The Region" is only about the region between mark and point, which is not entirely relevant to the functions that accept BEG and END as arguments, because these arguments don't have to come from the region limits. Btw, this rule applies to string positions as well, I think.