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#6493: Date: Sun, 27 Jun 2010 07:18:57 -0700 Message-ID: <6B20ABD762564DE2AEBA810B54EB46FD@us.oracle.com> References: <969BF38D66A0450F88923BFF8942AC68@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1277648973 28367 80.91.229.12 (27 Jun 2010 14:29:33 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 27 Jun 2010 14:29:33 +0000 (UTC) Cc: 6493@debbugs.gnu.org To: "'Deniz Dogan'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jun 27 16:29:32 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OSsrS-0006mp-Nj for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 Jun 2010 16:29:31 +0200 Original-Received: from localhost ([127.0.0.1]:34571 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OSsrS-0007VW-0K for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 Jun 2010 10:29:30 -0400 Original-Received: from [140.186.70.92] (port=33770 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OSsrI-0007Tx-Ju for bug-gnu-emacs@gnu.org; Sun, 27 Jun 2010 10:29:21 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OSsrH-0006be-En for bug-gnu-emacs@gnu.org; Sun, 27 Jun 2010 10:29:20 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:58019) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OSsrH-0006bY-CI for bug-gnu-emacs@gnu.org; Sun, 27 Jun 2010 10:29:19 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1OSsiJ-00058M-Ac; Sun, 27 Jun 2010 10:20:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 Jun 2010 14:20:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6493 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 6493-submit@debbugs.gnu.org id=B6493.127764837219723 (code B ref 6493); Sun, 27 Jun 2010 14:20:03 +0000 Original-Received: (at 6493) by debbugs.gnu.org; 27 Jun 2010 14:19:32 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OSsho-000584-3X for submit@debbugs.gnu.org; Sun, 27 Jun 2010 10:19:32 -0400 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OSshl-00057x-TT for 6493@debbugs.gnu.org; Sun, 27 Jun 2010 10:19:30 -0400 Original-Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id o5REJMSK004917 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 27 Jun 2010 14:19:24 GMT Original-Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155]) by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o5REJLUH025570; Sun, 27 Jun 2010 14:19:21 GMT Original-Received: from abhmt001.oracle.com by acsmt354.oracle.com with ESMTP id 377266951277648333; Sun, 27 Jun 2010 07:18:53 -0700 Original-Received: from dradamslap1 (/141.144.88.51) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 27 Jun 2010 07:18:52 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: AcsWAX7mdN54cFbQS0GdLKUJ6rClzQAALNQg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5931 X-Source-IP: acsmt355.oracle.com [141.146.40.155] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090201.4C275DEA.01B4:SCFMA4539814,ss=1,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sun, 27 Jun 2010 10:20:03 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:38052 Archived-At: > > "Returns point or mark, whichever is larger." > > How about this (for region-end): > > "Returns point or mark, whichever is larger. > The returned value is the position of the end of the region > as an integer." The end of the region is always a position, so no need to speak of the position of the end of the region. We don't really need to say that a number is returned, as opposed to a marker. "Point" is a position, which is a number (natnump). "Mark" is more ambiguous - it is sometimes referred to as a marker and sometimes as the position of that marker. So it's probably good to mention that a number is returned, even if not really necessary. (We also need not specify what kind of number, since it is a position, but that doesn't hurt either.) "Returns the larger of point or mark, as a nonnegative integer." We can add that the function "raises an error if the mark is not set".