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#19421: 25.0.50; doc string of `browse-url' must describe parameter ARGS Date: Sun, 27 Dec 2015 08:55:18 -0800 (PST) Message-ID: <9b7eea53-ecf4-47f8-b153-9d80ac3557a0@default> References: <<< <87mvsywduo.fsf@gnus.org>>>> <<<<8db0a3c8-08b4-40c3-93a8-23ec9fcd8174@default>>>> <<<<83bn9dk208.fsf@gnu.org>>>> <<<41cee0e8-d5b7-4b6d-8f5b-314c01142f3a@default>>> <<<8337uphwi4.fsf@gnu.org>>> <<10972dc0-33fa-4ff0-974e-96156500da7f@default>> <<83h9j3ho5r.fsf@gnu.org>> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1451235386 15934 80.91.229.3 (27 Dec 2015 16:56:26 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 27 Dec 2015 16:56:26 +0000 (UTC) Cc: larsi@gnus.org, 19421@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Dec 27 17:56:12 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1aDEc7-0007YT-Tz for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 Dec 2015 17:56:12 +0100 Original-Received: from localhost ([::1]:42099 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aDEc7-0001z4-9Q for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 Dec 2015 11:56:11 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50793) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aDEc3-0001yz-U7 for bug-gnu-emacs@gnu.org; Sun, 27 Dec 2015 11:56:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aDEby-0000nr-VN for bug-gnu-emacs@gnu.org; Sun, 27 Dec 2015 11:56:07 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:37003) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aDEby-0000nm-RU for bug-gnu-emacs@gnu.org; Sun, 27 Dec 2015 11:56:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aDEbx-0007xW-JU for bug-gnu-emacs@gnu.org; Sun, 27 Dec 2015 11:56:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 Dec 2015 16:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19421 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 19421-submit@debbugs.gnu.org id=B19421.145123532930553 (code B ref 19421); Sun, 27 Dec 2015 16:56:01 +0000 Original-Received: (at 19421) by debbugs.gnu.org; 27 Dec 2015 16:55:29 +0000 Original-Received: from localhost ([127.0.0.1]:44605 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aDEbR-0007wj-2W for submit@debbugs.gnu.org; Sun, 27 Dec 2015 11:55:29 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:22738) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aDEbP-0007wU-KU for 19421@debbugs.gnu.org; Sun, 27 Dec 2015 11:55:27 -0500 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id tBRGtK4g022350 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sun, 27 Dec 2015 16:55:21 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id tBRGtJTC018290 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sun, 27 Dec 2015 16:55:20 GMT Original-Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id tBRGtJJ6024449; Sun, 27 Dec 2015 16:55:19 GMT In-Reply-To: <<83h9j3ho5r.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] 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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:110797 Archived-At: >> > I fail to see how it is called interactively, since it is not a > > command - it has no `interactive' spec. >=20 > It describes what will happen with the functions it calls, depending > on the platform. Those functions do have an interactive spec. That is something entirely different from "when called interactively". Such language is quite misleading. At least it misled and confused me. And is this doc string really the place to describe that? (I don't say that it is not, but certainly such info is secondary to describing this function and its own arguments.) > > And it refers to an "optional second argument NEW-WINDOW", but > > the lambda list is (URL &rest ARGS), and the doc string in no > > way introduces NEW WINDOW in terms of those parameters. >=20 > Please look at the current sources, you are talking about stuff I > changed already. OK great. Please ignore any such ignorance. I was referring to the state before your changes, which I have not seen.