From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Xue Fuqiao Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] trunk r113909: Refine the documentation of `insert-buffer-substring'. Date: Sun, 18 Aug 2013 06:27:25 +0800 Message-ID: References: <838v02nona.fsf@gnu.org> <83d2pdmq84.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1376778451 27732 80.91.229.3 (17 Aug 2013 22:27:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 17 Aug 2013 22:27:31 +0000 (UTC) Cc: Stefan Monnier , emacs-devel To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Aug 18 00:27:33 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 1VAoy4-0000Pf-Rc for ged-emacs-devel@m.gmane.org; Sun, 18 Aug 2013 00:27:32 +0200 Original-Received: from localhost ([::1]:37133 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAoy4-0007AN-5Z for ged-emacs-devel@m.gmane.org; Sat, 17 Aug 2013 18:27:32 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51261) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAoy1-00076U-7o for emacs-devel@gnu.org; Sat, 17 Aug 2013 18:27:30 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VAoxz-0001gr-Vi for emacs-devel@gnu.org; Sat, 17 Aug 2013 18:27:29 -0400 Original-Received: from mail-ie0-x22f.google.com ([2607:f8b0:4001:c03::22f]:57829) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAoxy-0001gZ-L2; Sat, 17 Aug 2013 18:27:26 -0400 Original-Received: by mail-ie0-f175.google.com with SMTP id s9so5183052iec.6 for ; Sat, 17 Aug 2013 15:27:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=ZJjwa8khH1OnvMzTkBP2SW2EGRnIYlcayOPRf5GPjCw=; b=sj6mp23xjW5RpYdVUmh9RI4JqRkbvjHU343Yp9Kw7PiSv8ICfXTgfeTx6UCK4vRe71 UuGQmjEk43EZkQfbumrmVvUNXCMuDlqzk5R6+E062jzeYWSCRFxELNmu7KU6lqYw0iFo ls4mrEhcal4NaIIgWR0KlrMnWT4zpvOt5rvL9HI22lVCfNC8Uymne/hLruxCPMmdjZDl /VIZ4wNprlTBRfogkE+4MX0nskA2Ds5OQEPldIflFpxiUmLCbX5Af9lLzOlmRvaZr36c 1V3crGZOVR7W2WK0Zbi3kdbkuZ4q8CW+3XGhK4G/8sHNKdH5biaj7+OWadUBgonbML39 oyfg== X-Received: by 10.50.39.51 with SMTP id m19mr2294783igk.51.1376778445755; Sat, 17 Aug 2013 15:27:25 -0700 (PDT) Original-Received: by 10.43.152.207 with HTTP; Sat, 17 Aug 2013 15:27:25 -0700 (PDT) In-Reply-To: <83d2pdmq84.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2607:f8b0:4001:c03::22f 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:162853 Archived-At: 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").