From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#19421: 25.0.50; doc string of `browse-url' must describe parameter ARGS Date: Sun, 27 Dec 2015 18:06:08 +0200 Message-ID: <83h9j3ho5r.fsf@gnu.org> 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> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1451232397 5731 80.91.229.3 (27 Dec 2015 16:06:37 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 27 Dec 2015 16:06:37 +0000 (UTC) Cc: larsi@gnus.org, 19421@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Dec 27 17:06:25 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 1aDDpw-0008GR-L9 for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 Dec 2015 17:06:24 +0100 Original-Received: from localhost ([::1]:41970 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aDDpw-0008VG-5W for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 Dec 2015 11:06:24 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41552) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aDDpg-000884-8f for bug-gnu-emacs@gnu.org; Sun, 27 Dec 2015 11:06:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aDDpb-0006s6-BH for bug-gnu-emacs@gnu.org; Sun, 27 Dec 2015 11:06:07 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:36939) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aDDpb-0006s1-8L for bug-gnu-emacs@gnu.org; Sun, 27 Dec 2015 11:06:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aDDpb-0006iE-36 for bug-gnu-emacs@gnu.org; Sun, 27 Dec 2015 11:06:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 Dec 2015 16:06:03 +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.145123233825733 (code B ref 19421); Sun, 27 Dec 2015 16:06:03 +0000 Original-Received: (at 19421) by debbugs.gnu.org; 27 Dec 2015 16:05:38 +0000 Original-Received: from localhost ([127.0.0.1]:44533 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aDDp9-0006gt-7F for submit@debbugs.gnu.org; Sun, 27 Dec 2015 11:05:38 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:50453) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aDDp4-0006gP-AQ for 19421@debbugs.gnu.org; Sun, 27 Dec 2015 11:05:33 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aDDov-0006et-Bh for 19421@debbugs.gnu.org; Sun, 27 Dec 2015 11:05:24 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:42834) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aDDov-0006ep-8Y; Sun, 27 Dec 2015 11:05:21 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2270 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aDDou-0003Qm-IH; Sun, 27 Dec 2015 11:05:20 -0500 In-reply-to: <10972dc0-33fa-4ff0-974e-96156500da7f@default> (message from Drew Adams on Sat, 26 Dec 2015 14:19:05 -0800 (PST)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:110786 Archived-At: > Date: Sat, 26 Dec 2015 14:19:05 -0800 (PST) > From: Drew Adams > Cc: larsi@gnus.org, 19421@debbugs.gnu.org > > > When called interactively, if variable `browse-url-new-window-flag' is > > non-nil, load the document in a new window, if possible, otherwise use > > a random existing one. A non-nil interactive prefix argument reverses > > the effect of `browse-url-new-window-flag'. > > > > So this part was already okay (in other functions as well). > > Sorry; I do not understand. The doc string speaks about behavior > for when it is called interactively and when it is called > non-interactively. > > I fail to see how it is called interactively, since it is not a > command - it has no `interactive' spec. It describes what will happen with the functions it calls, depending on the platform. Those functions do have an interactive spec. > 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. Please look at the current sources, you are talking about stuff I changed already.