From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#20421: 25.0.50; doc string of `insert-buffer-substring' Date: Fri, 24 Apr 2015 16:19:28 -0700 (PDT) Message-ID: <72ff228c-ad59-4fcc-a9d1-9109c0bb13ec@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1429917629 2885 80.91.229.3 (24 Apr 2015 23:20:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 24 Apr 2015 23:20:29 +0000 (UTC) To: 20421@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Apr 25 01:20:15 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1YlmtJ-0003Do-LH for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Apr 2015 01:20:13 +0200 Original-Received: from localhost ([::1]:46821 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YlmtI-0006nX-LX for geb-bug-gnu-emacs@m.gmane.org; Fri, 24 Apr 2015 19:20:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39586) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YlmtF-0006n9-3H for bug-gnu-emacs@gnu.org; Fri, 24 Apr 2015 19:20:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ylmt9-000489-W6 for bug-gnu-emacs@gnu.org; Fri, 24 Apr 2015 19:20:09 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:49279) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ylmt9-00047u-TL for bug-gnu-emacs@gnu.org; Fri, 24 Apr 2015 19:20:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Ylmt9-00044P-9M for bug-gnu-emacs@gnu.org; Fri, 24 Apr 2015 19:20:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 24 Apr 2015 23:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 20421 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.142991758715616 (code B ref -1); Fri, 24 Apr 2015 23:20:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 24 Apr 2015 23:19:47 +0000 Original-Received: from localhost ([127.0.0.1]:39055 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ylmss-00043n-Sl for submit@debbugs.gnu.org; Fri, 24 Apr 2015 19:19:47 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:54212) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ylmsq-00043a-2y for submit@debbugs.gnu.org; Fri, 24 Apr 2015 19:19:44 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ylmsk-0003zk-2L for submit@debbugs.gnu.org; Fri, 24 Apr 2015 19:19:38 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:43348) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ylmsj-0003zg-VB for submit@debbugs.gnu.org; Fri, 24 Apr 2015 19:19:37 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39484) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ylmsj-0006ga-0O for bug-gnu-emacs@gnu.org; Fri, 24 Apr 2015 19:19:37 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ylmsd-0003yj-Rh for bug-gnu-emacs@gnu.org; Fri, 24 Apr 2015 19:19:36 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:37896) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ylmsd-0003ye-LV for bug-gnu-emacs@gnu.org; Fri, 24 Apr 2015 19:19:31 -0400 Original-Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t3ONJUlx024547 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 24 Apr 2015 23:19:30 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t3ONJT2m031505 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Fri, 24 Apr 2015 23:19:29 GMT Original-Received: from abhmp0001.oracle.com (abhmp0001.oracle.com [141.146.116.7]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t3ONJTFJ011452 for ; Fri, 24 Apr 2015 23:19:29 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: userv0022.oracle.com [156.151.31.74] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:102009 Archived-At: Unlike the doc string of `insert', this doc string does not explicitly say the following: Point and before-insertion markers move forward to end up after the inserted text. Any other markers at the point of insertion remain before the text. It should. Here is an example where a reader did not understand some code, partly because, it seems, this doc string is not explicit about this. http://emacs.stackexchange.com/q/10904/105 In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2014-10-20 on LEG570 Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1'