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#14130: 24.3.50; doc/help for advice and advised functions Date: Wed, 3 Apr 2013 08:13:57 -0700 Message-ID: <5BF8E36FD3EF4D1BBE8A1E79A0DCC421@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1365002105 13319 80.91.229.3 (3 Apr 2013 15:15:05 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 3 Apr 2013 15:15:05 +0000 (UTC) To: 14130@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Apr 03 17:15:32 2013 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 1UNPPN-0004xK-Ie for geb-bug-gnu-emacs@m.gmane.org; Wed, 03 Apr 2013 17:15:29 +0200 Original-Received: from localhost ([::1]:53720 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UNPOy-0008PR-HK for geb-bug-gnu-emacs@m.gmane.org; Wed, 03 Apr 2013 11:15:04 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:36973) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UNPOt-0008Jf-RX for bug-gnu-emacs@gnu.org; Wed, 03 Apr 2013 11:15:01 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UNPOs-0006wV-KG for bug-gnu-emacs@gnu.org; Wed, 03 Apr 2013 11:14:59 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:56077) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UNPOs-0006wO-H8 for bug-gnu-emacs@gnu.org; Wed, 03 Apr 2013 11:14:58 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1UNPRq-0002u6-2h for bug-gnu-emacs@gnu.org; Wed, 03 Apr 2013 11:18:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 03 Apr 2013 15:18:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 14130 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.136500223611102 (code B ref -1); Wed, 03 Apr 2013 15:18:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 3 Apr 2013 15:17:16 +0000 Original-Received: from localhost ([127.0.0.1]:60184 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1UNPR4-0002t0-UT for submit@debbugs.gnu.org; Wed, 03 Apr 2013 11:17:15 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:53692) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1UNPR1-0002sp-Qb for submit@debbugs.gnu.org; Wed, 03 Apr 2013 11:17:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UNPO0-0006WF-VS for submit@debbugs.gnu.org; Wed, 03 Apr 2013 11:14:06 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:35042) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UNPO0-0006WA-Sp for submit@debbugs.gnu.org; Wed, 03 Apr 2013 11:14:04 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:36812) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UNPNy-0007WQ-O7 for bug-gnu-emacs@gnu.org; Wed, 03 Apr 2013 11:14:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UNPNx-0006VR-JK for bug-gnu-emacs@gnu.org; Wed, 03 Apr 2013 11:14:02 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:42738) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UNPNx-0006VK-Ck for bug-gnu-emacs@gnu.org; Wed, 03 Apr 2013 11:14:01 -0400 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r33FDxFi022544 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 3 Apr 2013 15:14:00 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r33FDw3U013713 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 3 Apr 2013 15:13:59 GMT Original-Received: from abhmt120.oracle.com (abhmt120.oracle.com [141.146.116.72]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id r33FDwbb027128 for ; Wed, 3 Apr 2013 10:13:58 -0500 Original-Received: from dradamslap1 (/130.35.178.8) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 03 Apr 2013 08:13:58 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac4wfdy930R4na8WQOSntaGqcY4Kkw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 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: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.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:73108 Archived-At: Mostly an enhancement request, I guess, but partly a bug report. 1. (elisp) `Advising Functions' Says "Note that enabling a piece of advice and activating advice for a function are not the same thing." But it does not say clearly what the difference is. It says only this: a. A piece of advice can be "enabled"/"disabled". It does not explain what this means. b. Advice takes effect only if both enabled and activated. That's pretty incomplete. The difference between these two things (enabling, activating) is presumably important, and it is not made clear. It is not enough to tell users not to confuse the two, without telling them clearly what the difference is. Start with this question: What is the purpose of each of them (enabling, activating)? 2. The definition of "forward advice", and the *important* fact that you can advise a function without the function being defined yet, should be moved from (elisp) `Defining Advice' to (elisp) `Advising Functions'. It is not a detail concerning just the keyword `activate'. (Note too that there is zero use of or reference to "forward advice" in the manual.) 3. If these concepts apply also to the new advice facility written by Stefan, then please keep this request in mind in that context: document each of the various states of a piece of advice (enabled but not activated etc.) etc. (And where is the doc for that new facility?) In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600) of 2013-03-28 on ODIEONE Bzr revision: 112173 monnier@iro.umontreal.ca-20130328163306-419khox8aneaoaxv Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -IC:/Devel/emacs/build/include --ldflags -LC:/Devel/emacs/build/lib'