From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: master f9e354e: Spelling and wording fixes Date: Tue, 17 Mar 2015 21:00:53 -0700 Organization: UCLA Computer Science Department Message-ID: <5508F875.7050407@cs.ucla.edu> References: <20150318001119.1234.13177@vcs.savannah.gnu.org> <6vr3snw2km.fsf@fencepost.gnu.org> <5508CC68.6030304@cs.ucla.edu> <87bnjrrofq.fsf@uwakimon.sk.tsukuba.ac.jp> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------050802010009040301010504" X-Trace: ger.gmane.org 1426651288 8446 80.91.229.3 (18 Mar 2015 04:01:28 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 18 Mar 2015 04:01:28 +0000 (UTC) Cc: Glenn Morris , emacs-devel@gnu.org To: "Stephen J. Turnbull" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Mar 18 05:01:21 2015 Return-path: Envelope-to: ged-emacs-devel@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 1YY5AV-0004ox-Bf for ged-emacs-devel@m.gmane.org; Wed, 18 Mar 2015 05:01:19 +0100 Original-Received: from localhost ([::1]:58798 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YY5AU-00057o-Ev for ged-emacs-devel@m.gmane.org; Wed, 18 Mar 2015 00:01:18 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41565) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YY5AH-000552-D4 for emacs-devel@gnu.org; Wed, 18 Mar 2015 00:01:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YY5AD-0008K8-EO for emacs-devel@gnu.org; Wed, 18 Mar 2015 00:01:05 -0400 Original-Received: from smtp.cs.ucla.edu ([131.179.128.62]:57418) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YY5AD-0008K2-65; Wed, 18 Mar 2015 00:01:01 -0400 Original-Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id E61AAA6001D; Tue, 17 Mar 2015 21:00:59 -0700 (PDT) X-Virus-Scanned: amavisd-new at smtp.cs.ucla.edu Original-Received: from smtp.cs.ucla.edu ([127.0.0.1]) by localhost (smtp.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id mX+9RcAFnFtc; Tue, 17 Mar 2015 21:00:59 -0700 (PDT) Original-Received: from [192.168.1.9] (pool-100-32-155-148.lsanca.fios.verizon.net [100.32.155.148]) by smtp.cs.ucla.edu (Postfix) with ESMTPSA id 5E791A60005; Tue, 17 Mar 2015 21:00:59 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.5.0 In-Reply-To: <87bnjrrofq.fsf@uwakimon.sk.tsukuba.ac.jp> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 131.179.128.62 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:183981 Archived-At: This is a multi-part message in MIME format. --------------050802010009040301010504 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Stephen J. Turnbull wrote: > semantically your phrasing seems quite awkward to me True. Let's omit that sentence. First, the point doesn't appear to be that important. Second, it's typically more confusing to document a procedure *doesn't* do than to document what the procedure *does* do. So I installed the attached. Undoubtedly this could be further improved. --------------050802010009040301010504 Content-Type: text/x-patch; name="0001-lisp-net-browse-url.el-Omit-confusing-documentation.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename*0="0001-lisp-net-browse-url.el-Omit-confusing-documentation.pat"; filename*1="ch" >From 94a90c867853f83d5f833dfd910919af9209c71b Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Tue, 17 Mar 2015 20:55:02 -0700 Subject: [PATCH] * lisp/net/browse-url.el: Omit confusing documentation. --- lisp/net/browse-url.el | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/lisp/net/browse-url.el b/lisp/net/browse-url.el index dff587e..b44bb71 100644 --- a/lisp/net/browse-url.el +++ b/lisp/net/browse-url.el @@ -862,8 +862,7 @@ first, if that exists." ;;;###autoload (defun browse-url-at-point (&optional arg) "Ask a WWW browser to load the URL at or before point. -Don't let you edit the URL like `browse-url'. Variable -`browse-url-browser-function' says which browser to use." +Variable `browse-url-browser-function' says which browser to use." (interactive "P") (let ((url (browse-url-url-at-point))) (if url @@ -876,9 +875,8 @@ Don't let you edit the URL like `browse-url'. Variable (defun browse-url-at-mouse (event) "Ask a WWW browser to load a URL clicked with the mouse. The URL is the one around or before the position of the mouse click -but point is not changed. Don't let you edit the URL like -`browse-url'. Variable `browse-url-browser-function' says which browser -to use." +but point is not changed. Variable `browse-url-browser-function' +says which browser to use." (interactive "e") (save-excursion (mouse-set-point event) -- 2.1.0 --------------050802010009040301010504--