GNU bug report logs - #19033
Manual: (elisp) `Advising Named Functions' does not describe FUNCTION

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Severity: minor; Reported by: Drew Adams <drew.adams@HIDDEN>; dated Wed, 12 Nov 2014 17:13:01 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.
Changed bug title to 'Manual: (elisp) `Advising Named Functions' does not describe FUNCTION' from '25.0.50; (elisp) `Advising Named Functions' does not describe FUNCTION' Request was from npostavs@HIDDEN to control <at> debbugs.gnu.org. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 12 Nov 2014 17:12:26 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Nov 12 12:12:26 2014
Received: from localhost ([127.0.0.1]:58895 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1XobT0-0002RD-0p
	for submit <at> debbugs.gnu.org; Wed, 12 Nov 2014 12:12:26 -0500
Received: from eggs.gnu.org ([208.118.235.92]:37575)
 by debbugs.gnu.org with esmtp (Exim 4.80)
 (envelope-from <drew.adams@HIDDEN>) id 1XobSw-0002R4-JY
 for submit <at> debbugs.gnu.org; Wed, 12 Nov 2014 12:12:24 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <drew.adams@HIDDEN>) id 1XobSm-0006PH-BA
 for submit <at> debbugs.gnu.org; Wed, 12 Nov 2014 12:12:22 -0500
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled
 version=3.3.2
Received: from lists.gnu.org ([2001:4830:134:3::11]:49190)
 by eggs.gnu.org with esmtp (Exim 4.71)
 (envelope-from <drew.adams@HIDDEN>) id 1XobSm-0006PD-8s
 for submit <at> debbugs.gnu.org; Wed, 12 Nov 2014 12:12:12 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:39153)
 by lists.gnu.org with esmtp (Exim 4.71)
 (envelope-from <drew.adams@HIDDEN>) id 1XobSd-0003eP-HZ
 for bug-gnu-emacs@HIDDEN; Wed, 12 Nov 2014 12:12:12 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <drew.adams@HIDDEN>) id 1XobST-0006L1-79
 for bug-gnu-emacs@HIDDEN; Wed, 12 Nov 2014 12:12:03 -0500
Received: from aserp1040.oracle.com ([141.146.126.69]:27552)
 by eggs.gnu.org with esmtp (Exim 4.71)
 (envelope-from <drew.adams@HIDDEN>) id 1XobST-0006KZ-1i
 for bug-gnu-emacs@HIDDEN; Wed, 12 Nov 2014 12:11:53 -0500
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 <bug-gnu-emacs@HIDDEN>; Wed, 12 Nov 2014 17:11:50 GMT
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 <bug-gnu-emacs@HIDDEN>; Wed, 12 Nov 2014 17:11:49 GMT
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 <bug-gnu-emacs@HIDDEN>; Wed, 12 Nov 2014 17:11:48 GMT
MIME-Version: 1.0
Message-ID: <97aa8252-de9e-4a3d-9a79-4d080bc17aaa@default>
Date: Wed, 12 Nov 2014 09:11:47 -0800 (PST)
From: Drew Adams <drew.adams@HIDDEN>
To: bug-gnu-emacs@HIDDEN
Subject: 25.0.50; (elisp) `Advising Named Functions' does not describe FUNCTION
X-Priority: 3
X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2  (807160) [OL
 12.0.6691.5000 (x86)]
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
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-Received-From: 2001:4830:134:3::11
X-Spam-Score: -4.0 (----)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -4.0 (----)

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@HIDDEN
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1'




Acknowledgement sent to Drew Adams <drew.adams@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#19033; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Sun, 16 Jul 2017 14:15:01 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.