From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Deniz Dogan Newsgroups: gmane.emacs.bugs Subject: bug#6493: Date: Sun, 27 Jun 2010 16:29:13 +0200 Message-ID: References: <969BF38D66A0450F88923BFF8942AC68@us.oracle.com> <6B20ABD762564DE2AEBA810B54EB46FD@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1277650783 812 80.91.229.12 (27 Jun 2010 14:59:43 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 27 Jun 2010 14:59:43 +0000 (UTC) Cc: 6493@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jun 27 16:59:40 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 1OStKd-0006pn-OR for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 Jun 2010 16:59:40 +0200 Original-Received: from localhost ([127.0.0.1]:58356 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OStKd-0003iX-6x for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 Jun 2010 10:59:39 -0400 Original-Received: from [140.186.70.92] (port=54911 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OStKL-0003eJ-GV for bug-gnu-emacs@gnu.org; Sun, 27 Jun 2010 10:59:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OStKF-0002Z5-US for bug-gnu-emacs@gnu.org; Sun, 27 Jun 2010 10:59:21 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:39864) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OStKF-0002Z1-RI for bug-gnu-emacs@gnu.org; Sun, 27 Jun 2010 10:59:15 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1OSsrz-0005Ci-PG; Sun, 27 Jun 2010 10:30:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Deniz Dogan 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:30: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.127764899119980 (code B ref 6493); Sun, 27 Jun 2010 14:30:03 +0000 Original-Received: (at 6493) by debbugs.gnu.org; 27 Jun 2010 14:29:51 +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 1OSsrn-0005CD-0r for submit@debbugs.gnu.org; Sun, 27 Jun 2010 10:29:51 -0400 Original-Received: from fg-out-1718.google.com ([72.14.220.155]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OSsrk-0005C8-U1 for 6493@debbugs.gnu.org; Sun, 27 Jun 2010 10:29:49 -0400 Original-Received: by fg-out-1718.google.com with SMTP id l26so8859fgb.15 for <6493@debbugs.gnu.org>; Sun, 27 Jun 2010 07:29:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:mime-version:received:in-reply-to :references:from:date:message-id:subject:to:cc:content-type :content-transfer-encoding; bh=Q0Nd1l4teXZPKSfGJ2+76oaXh+EbYe6lXHG2lTBY7ws=; b=w+zb74cG3d9ILX0qrNUbP8HyqIQvX5GavPlqIRh0vhVNbmUL6ROxb0rzjVsdHPHTFQ GdlY5KlIir/x/8lMy1/JJHEcnoZ0mInI4hOSR8EhQoJA1jYnxGc9mwKit7hyElizY7t3 znO4PtvrhvTe3nKxxzBWJByzmSyf936mp5Grk= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type:content-transfer-encoding; b=J7W3d2R9J2VvfOQFJ5GkFsqYdTuKnBO28aeklPNmnzFXgVLSUhvM1YY6xsAmBzeNSP VoVHSoIrDEgG9zys+HsDpfhCsufZmpKsDAkZupskfaV7N6narVzbjF3hWKEjm51DTxGr ZNLVTgBk3I1mRw3Wv7smCc2l5DQLrkm2+mfXM= Original-Received: by 10.239.154.204 with SMTP id f12mr251084hbc.31.1277648983124; Sun, 27 Jun 2010 07:29:43 -0700 (PDT) Original-Received: by 10.239.135.207 with HTTP; Sun, 27 Jun 2010 07:29:13 -0700 (PDT) In-Reply-To: <6B20ABD762564DE2AEBA810B54EB46FD@us.oracle.com> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sun, 27 Jun 2010 10:30: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:38054 Archived-At: 2010/6/27 Drew Adams : >> > "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 po= sition > of the end of the region. > > We don't really need to say that a number is returned, as opposed to a ma= rker. > "Point" is a position, which is a number (natnump). "Mark" is more ambigu= ous - > it is sometimes referred to as a marker and sometimes as the position of = that > marker. =A0So it's probably good to mention that a number is returned, ev= en 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". > > I'm all for your suggestion. So now we have: "Returns the larger of point or mark, as a nonnegative integer. Raises an error if the mark is not set." Agreed? --=20 Deniz Dogan