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:02:45 +0200 Message-ID: References: <969BF38D66A0450F88923BFF8942AC68@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 X-Trace: dough.gmane.org 1277648968 28350 80.91.229.12 (27 Jun 2010 14:29:28 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 27 Jun 2010 14:29:28 +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:29:26 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 1OSsrM-0006jT-I8 for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 Jun 2010 16:29:24 +0200 Original-Received: from localhost ([127.0.0.1]:34526 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OSsrL-0007TZ-QA for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 Jun 2010 10:29:23 -0400 Original-Received: from [140.186.70.92] (port=33742 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OSsrE-0007TJ-Vb for bug-gnu-emacs@gnu.org; Sun, 27 Jun 2010 10:29:18 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OSsrD-0006aq-Sd for bug-gnu-emacs@gnu.org; Sun, 27 Jun 2010 10:29:16 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:58014) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OSsrD-0006aj-PT for bug-gnu-emacs@gnu.org; Sun, 27 Jun 2010 10:29:15 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1OSsSo-00051u-8o; Sun, 27 Jun 2010 10:04:02 -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:04:02 +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.127764740319326 (code B ref 6493); Sun, 27 Jun 2010 14:04:02 +0000 Original-Received: (at 6493) by debbugs.gnu.org; 27 Jun 2010 14:03:23 +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 1OSsSA-00051f-GK for submit@debbugs.gnu.org; Sun, 27 Jun 2010 10:03:22 -0400 Original-Received: from mail-fx0-f44.google.com ([209.85.161.44]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OSsS8-00051a-TV for 6493@debbugs.gnu.org; Sun, 27 Jun 2010 10:03:21 -0400 Original-Received: by fxm1 with SMTP id 1so115341fxm.3 for <6493@debbugs.gnu.org>; Sun, 27 Jun 2010 07:03:15 -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; bh=I1N8nmjxq8rhFKLJ9naCEsZbWvd9A0+6bXYB2kY7DGo=; b=K+JLDg6flRaEBllKW2FgZj/f3bXKoJYSbeLhsl1HDEqG38mAoAt/zh65sTrivESQmr 5eLa9r5jlMti62vRZvGIWHMwi5WP4JQIDdQ677sMlbOzMlWoZFued8Upd3f20+Dr08M3 4IB+3b60gSgXZdOMUgn7/83bBtcPy3wBWsP60= 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; b=OLUG1ZJ2A+Xagx3pS/JDOVUcH6a4fu/eFyMql5hdvqmLZmQ6f0vreQdYpIAZ7xKMZV AAVLXZ8dmjdjWiFDcHO9PSBoaz9lYvuCQQJvJ+OPG8t3g59HbtWUgHcSNfgl/M9KYCZj utonz7S1VEenow405OHu8pXZCVatN+bXCBC1M= Original-Received: by 10.239.145.74 with SMTP id r10mr224615hba.191.1277647395176; Sun, 27 Jun 2010 07:03:15 -0700 (PDT) Original-Received: by 10.239.135.207 with HTTP; Sun, 27 Jun 2010 07:02:45 -0700 (PDT) In-Reply-To: X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sun, 27 Jun 2010 10:04:02 -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:38050 Archived-At: 2010/6/27 Drew Adams : >> How about this? (See attached patch.) > > 1. Thanks for working on this. > > 2. Please cc the bug submitter, and please put the bug subject line in the > Subject line. It was only by searching old mails for "6493" that I sent that I > was able to find that this was a bug I submitted. Now I must search similarly > for the other bugs you replied to with no Subject line other than the bug #. > Multiply my experience by that of others. > Sorry about this, it just wasn't clear to me how people are supposed to use the bug tracker. I'm not used to accessing bug trackers by e-mail. > 3. What's important about these functions is the return value. The doc string > needs to be explicit about what is _returned_. There is no need to repeat info > that follows from definitions (e.g. that point and mark are the region limits). > > Example: > > "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." ...and likewise for region-beginning. -- Deniz Dogan