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#19033: 25.0.50; (elisp) `Advising Named Functions' does not describe FUNCTION Date: Wed, 12 Nov 2014 09:11:47 -0800 (PST) Message-ID: <97aa8252-de9e-4a3d-9a79-4d080bc17aaa@default> 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 1415812413 13919 80.91.229.3 (12 Nov 2014 17:13:33 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 12 Nov 2014 17:13:33 +0000 (UTC) To: 19033@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Nov 12 18:13:26 2014 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 1XobTx-0004qy-UB for geb-bug-gnu-emacs@m.gmane.org; Wed, 12 Nov 2014 18:13:26 +0100 Original-Received: from localhost ([::1]:56022 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XobTx-0004tI-GB for geb-bug-gnu-emacs@m.gmane.org; Wed, 12 Nov 2014 12:13:25 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39650) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XobTk-0004p9-Jm for bug-gnu-emacs@gnu.org; Wed, 12 Nov 2014 12:13:22 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XobTa-0006mB-AL for bug-gnu-emacs@gnu.org; Wed, 12 Nov 2014 12:13:12 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:33449) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XobTa-0006m5-7u for bug-gnu-emacs@gnu.org; Wed, 12 Nov 2014 12:13:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1XobTZ-0002SG-UM for bug-gnu-emacs@gnu.org; Wed, 12 Nov 2014 12:13:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 12 Nov 2014 17:13:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 19033 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.14158123469379 (code B ref -1); Wed, 12 Nov 2014 17:13:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 12 Nov 2014 17:12:26 +0000 Original-Received: from localhost ([127.0.0.1]:58895 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XobT0-0002RD-0p for submit@debbugs.gnu.org; Wed, 12 Nov 2014 12:12:26 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:37575) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XobSw-0002R4-JY for submit@debbugs.gnu.org; Wed, 12 Nov 2014 12:12:24 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XobSm-0006PH-BA for submit@debbugs.gnu.org; Wed, 12 Nov 2014 12:12:22 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:49190) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XobSm-0006PD-8s for submit@debbugs.gnu.org; Wed, 12 Nov 2014 12:12:12 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39153) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XobSd-0003eP-HZ for bug-gnu-emacs@gnu.org; Wed, 12 Nov 2014 12:12:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XobST-0006L1-79 for bug-gnu-emacs@gnu.org; Wed, 12 Nov 2014 12:12:03 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:27552) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XobST-0006KZ-1i for bug-gnu-emacs@gnu.org; Wed, 12 Nov 2014 12:11:53 -0500 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id sACHBnKJ008045 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 12 Nov 2014 17:11:50 GMT Original-Received: from userz7022.oracle.com (userz7022.oracle.com [156.151.31.86]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id sACHBnrj029042 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 12 Nov 2014 17:11:49 GMT Original-Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by userz7022.oracle.com (8.14.5+Sun/8.14.4) with ESMTP id sACHBmKA029010 for ; Wed, 12 Nov 2014 17:11:48 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.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:95908 This node sends you off to node `Core Advising Primitives' for information about parameters WHERE and PROPS. That's bad enough, since `Advising Named Functions' is intended as the MAIN entry point for advising functions: "But you should use `advice-add' and `advice-remove' for that instead." But `Advising Named Functions' tells you nothing about FUNCTION. In particular, it does not tell you what its signature must be or must fit. Worse still, neither does node `Core Advising Primitives' tell you anything about the signature of FUNCTION! So it would not even be enough to send readers to that node for information about FUNCTION, as we do now for WHERE and PROPS. What must FUNCTION accept as argument(s)? What must it return? If there are no restrictions on its signature, then say so. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2014-10-20 on LEG570 Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1'