From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#33168: 26; Doc string of `region-bounds' Date: Fri, 26 Oct 2018 08:48:17 -0700 (PDT) Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1540570375 19594 195.159.176.226 (26 Oct 2018 16:12:55 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 26 Oct 2018 16:12:55 +0000 (UTC) To: 33168@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Oct 26 18:12:51 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gG4jA-0004tf-AD for geb-bug-gnu-emacs@m.gmane.org; Fri, 26 Oct 2018 18:12:48 +0200 Original-Received: from localhost ([::1]:60926 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gG4lG-0004NE-IB for geb-bug-gnu-emacs@m.gmane.org; Fri, 26 Oct 2018 12:14:58 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52271) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gG4MD-0007rv-9I for bug-gnu-emacs@gnu.org; Fri, 26 Oct 2018 11:49:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gG4MA-0006XH-2f for bug-gnu-emacs@gnu.org; Fri, 26 Oct 2018 11:49:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:40007) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gG4M9-0006X6-SM for bug-gnu-emacs@gnu.org; Fri, 26 Oct 2018 11:49:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gG4M9-0005o0-Q9 for bug-gnu-emacs@gnu.org; Fri, 26 Oct 2018 11:49:01 -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, 26 Oct 2018 15:49:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 33168 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.154056892722293 (code B ref -1); Fri, 26 Oct 2018 15:49:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 26 Oct 2018 15:48:47 +0000 Original-Received: from localhost ([127.0.0.1]:44265 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gG4Lv-0005nV-Ha for submit@debbugs.gnu.org; Fri, 26 Oct 2018 11:48:47 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:42508) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gG4Lt-0005nG-JL for submit@debbugs.gnu.org; Fri, 26 Oct 2018 11:48:46 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gG4Ll-0006Al-7b for submit@debbugs.gnu.org; Fri, 26 Oct 2018 11:48:40 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:60596) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gG4Lf-00063D-KU for submit@debbugs.gnu.org; Fri, 26 Oct 2018 11:48:34 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52091) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gG4Le-00073n-RW for bug-gnu-emacs@gnu.org; Fri, 26 Oct 2018 11:48:31 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gG4LZ-0005wT-QZ for bug-gnu-emacs@gnu.org; Fri, 26 Oct 2018 11:48:30 -0400 Original-Received: from userp2120.oracle.com ([156.151.31.85]:59340) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gG4LY-0005nt-IA for bug-gnu-emacs@gnu.org; Fri, 26 Oct 2018 11:48:25 -0400 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w9QFiFTk137691 for ; Fri, 26 Oct 2018 15:48:20 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=xObu3bmCVh4GLa+hxHeeRp4d5dWKkPfXXqxufkIkipY=; b=XD+VACzGfITP/CHBO0NYqwq18VuwomFrz/7zD0emJ+U+TQ0D0dz7biQCYHj6qCMmLzeE NZt1kHMdMZ87zuVLx65EkPRhpHhcYYSi17Y0swawHA9bAMXtat4M1ymqKWQ7Xn1C+bLu So1TG8r+/SE3zQnmrHTkdL0lzkpJN2w4jlXiNJHlndtzs3nKtzBb83nJDfAuCFNxasUl qNCYDRbrUxsW4SVw68nzNsPiwRv3VqVWjGZiIgfWGXMlUIOsBv5jnqoAXD2TMccFtrbt tFyfd2ci0c0NsT3fUBTUfy7fs5T76yeSuRDk3v8KyoTCM8ttzZ+ce1pt+gbeKi+OGkB0 JQ== Original-Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp2120.oracle.com with ESMTP id 2n7w0r80jf-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 26 Oct 2018 15:48:20 +0000 Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w9QFmKaW014628 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 26 Oct 2018 15:48:20 GMT Original-Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id w9QFmJxS024279 for ; Fri, 26 Oct 2018 15:48:19 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4756.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9057 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=803 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1810260132 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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" Xref: news.gmane.org gmane.emacs.bugs:151647 Archived-At: Doc string: Return the boundaries of the region as a pair of positions. Value is a list of cons cells of the form (START . END). Those two sentences are incompatible. The first says that it returns a _single pair_ of positions: (START END) or (START . END). (It doesn't say what it means by "pair". If it means a cons then it should say so.) The second says that it returns a _list of such pairs_, that is, a list of conses of the form (START . END), where START and END are buffer positions. Further, assuming that the second sentence is correct, something needs to be said about what it means to be a boundary of the region. Presumably, in the case of a contiguous region the return value is ((BEG . END)), where BEG is the start of the region and END is the END. But what if the region is noncontiguous? Something should be said about what each (BEG . END) pair corresponds to (means). In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-05-30 Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea Windowing system distributor `Microsoft Corp.', version 10.0.16299 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''