GNU bug report logs - #30223
27.0.50; Arglist of advised but undefined functions missing

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: "Basil L. Contovounesios" <contovob@HIDDEN>; dated Tue, 23 Jan 2018 00:55:02 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

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


Received: (at 30223) by debbugs.gnu.org; 17 Apr 2018 20:17:03 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Apr 17 16:17:03 2018
Received: from localhost ([127.0.0.1]:57945 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1f8X2F-0000L5-Ef
	for submit <at> debbugs.gnu.org; Tue, 17 Apr 2018 16:17:03 -0400
Received: from hermes.netfonds.no ([80.91.224.195]:38432)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <larsi@HIDDEN>) id 1f8X2D-0000Ig-Dv
 for 30223 <at> debbugs.gnu.org; Tue, 17 Apr 2018 16:17:01 -0400
Received: from 46.67.12.60.tmi.telenormobil.no ([46.67.12.60] helo=corrigan)
 by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <larsi@HIDDEN>)
 id 1f8X2A-0005lW-H5; Tue, 17 Apr 2018 22:17:00 +0200
Received: from larsi by corrigan with local (Exim 4.89)
 (envelope-from <larsi@HIDDEN>)
 id 1f8X24-0002gk-Ie; Tue, 17 Apr 2018 22:16:52 +0200
From: Lars Ingebrigtsen <larsi@HIDDEN>
To: "Basil L. Contovounesios" <contovob@HIDDEN>
Subject: Re: bug#30223: 27.0.50;
 Arglist of advised but undefined functions missing
References: <874lndfl9d.fsf@HIDDEN>
Date: Tue, 17 Apr 2018 22:16:52 +0200
In-Reply-To: <874lndfl9d.fsf@HIDDEN> (Basil L. Contovounesios's message of
 "Tue, 23 Jan 2018 00:53:50 +0000")
Message-ID: <87sh7th9l7.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 30223
Cc: 30223 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://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: <https://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: -1.0 (-)

"Basil L. Contovounesios" <contovob@HIDDEN> writes:

> Steps to reproduce:
>
> 1. emacs -Q
> 2. (advice-add 'some-funbound-sym :override #'ignore)
> 3. C-h f some-funbound-sym RET
>
> This results in the *Help* buffer reporting:
>
> some-funbound-sym is .
>
> [Missing arglist.  Please make a bug report.]
>
> Not documented.
>
> [back]
>
> which I presume is at least partially due to
>
>   (get 'some-funbound-sym 'function-documentation)
>     => (advice--make-docstring 'some-funbound-sym)
>
> I wouldn't expect advised-but-undefined functions to have meaningful
> documentation, but IMO the suggestion to make a bug report is
> misleading, given that many users are likely to advise as-of-yet
> undefined functions in their user-init-file.

Yeah, this sounds like something that can happen commonly and there
shouldn't be a "make a bug report" here.

And describe-function should just say that it's a function that's not
defined, but that there's a advice for the symbol, I think?

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#30223; Package emacs. Full text available.

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


Received: (at submit) by debbugs.gnu.org; 23 Jan 2018 00:54:07 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Jan 22 19:54:07 2018
Received: from localhost ([127.0.0.1]:38787 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1edmql-0005JI-0S
	for submit <at> debbugs.gnu.org; Mon, 22 Jan 2018 19:54:07 -0500
Received: from eggs.gnu.org ([208.118.235.92]:39296)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <contovob@HIDDEN>) id 1edmqk-0005Io-22
 for submit <at> debbugs.gnu.org; Mon, 22 Jan 2018 19:54:06 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <contovob@HIDDEN>) id 1edmqe-0002G1-7l
 for submit <at> debbugs.gnu.org; Mon, 22 Jan 2018 19:54:01 -0500
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_DKIM_INVALID
 autolearn=disabled version=3.3.2
Received: from lists.gnu.org ([2001:4830:134:3::11]:52359)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
 (Exim 4.71) (envelope-from <contovob@HIDDEN>) id 1edmqe-0002Fk-4S
 for submit <at> debbugs.gnu.org; Mon, 22 Jan 2018 19:54:00 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:58498)
 by lists.gnu.org with esmtp (Exim 4.71)
 (envelope-from <contovob@HIDDEN>) id 1edmqc-0005E0-T9
 for bug-gnu-emacs@HIDDEN; Mon, 22 Jan 2018 19:53:59 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <contovob@HIDDEN>) id 1edmqc-0002DO-19
 for bug-gnu-emacs@HIDDEN; Mon, 22 Jan 2018 19:53:58 -0500
Received: from mail-wm0-x236.google.com ([2a00:1450:400c:c09::236]:37994)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <contovob@HIDDEN>) id 1edmqb-0002As-Na
 for bug-gnu-emacs@HIDDEN; Mon, 22 Jan 2018 19:53:57 -0500
Received: by mail-wm0-x236.google.com with SMTP id 141so20220730wme.3
 for <bug-gnu-emacs@HIDDEN>; Mon, 22 Jan 2018 16:53:57 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=tcd-ie.20150623.gappssmtp.com; s=20150623;
 h=from:to:subject:date:message-id:mime-version;
 bh=dx8Hz8DYVFVhtqp59Zy8DNWsOokos4AA85qkyGfBU2Q=;
 b=Zw3zBcchKeCfoRy5o30g2pNRMr3luFDGuYF7Qot9rdqWc3i3IExVRyWk16F3oFs/0K
 fH3eIARyv65N7vrbo7S8hNQSayuCVHq8FQc2czXlicdXdbXVkrCCIS774Fdy6cjXUemE
 D4T2Msm7mJ7oziWewM2YXMOsYkaB+XcE0qyJfXvp/Ad0+xm4zMjNsbFAqwPbwcQrJ1PI
 5VbzZdIRfwfIGEq0bn7ots7GRpdB9TQ4IIe64IcR2iJ6juhoKf+5orWYIClRBZ7hQK9u
 KxB/0TR+4xQAT2Vv8cpfQyUIU9SgfZ3pwAL7mxvcAou4FbYZlMuAKK6PQ/efU5j1fc2y
 JmTw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:from:to:subject:date:message-id:mime-version;
 bh=dx8Hz8DYVFVhtqp59Zy8DNWsOokos4AA85qkyGfBU2Q=;
 b=MOqlOEL8AwDGI3BKkkLw1XllSqXPFBzTODA1iNizuRkni6kav0sBdkDvzerkVUqegJ
 2iIaYnwQ1clKt3wdcEWlxMoClby2xAFD41xjZIaEMyAdFHURTJosAZ0WGQlsoJ5vc35i
 56BHjBzLBWbhz+1WZvkrk8Yu199HvmAYR5Znerp6G1qAQg65AL1IzHpqzIx+Ca8SGwUz
 +0Eo7g3FQ29INOBTXUmPmRYS4rNkjaJ9TDbGaxOuPOgen3C3EGBww138s8R+3okaq0Fk
 zcidGKdw55kNi1uXCdq2eI/R5EHc5rcuacMksEZLYj85uAcKEglM5vtPCbu/vQ/N1PZy
 Ip/Q==
X-Gm-Message-State: AKwxytehu9q/PumMUYTuwSHVaYfPWqRn21InonPnmq71x9DesSCJ0SuQ
 0XP80DPUlh3J5DRN7dpR+STzxORb
X-Google-Smtp-Source: AH8x226EFrWKVP+rbbNvQW5XyOqZloc574aSK8wQKUmY5/3zzI6owXX5VTF/oArr5OVveNwN3IwLJQ==
X-Received: by 10.80.175.162 with SMTP id h31mr16440746edd.48.1516668835724;
 Mon, 22 Jan 2018 16:53:55 -0800 (PST)
Received: from localhost ([2a02:8084:4f41:8c80:9929:5bdb:4629:fab8])
 by smtp.gmail.com with ESMTPSA id a16sm13091474edd.19.2018.01.22.16.53.54
 for <bug-gnu-emacs@HIDDEN>
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Mon, 22 Jan 2018 16:53:54 -0800 (PST)
From: "Basil L. Contovounesios" <contovob@HIDDEN>
To: bug-gnu-emacs@HIDDEN
Subject: 27.0.50; Arglist of advised but undefined functions missing
Date: Tue, 23 Jan 2018 00:53:50 +0000
Message-ID: <874lndfl9d.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
 recognized.
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 2001:4830:134:3::11
X-Spam-Score: -5.0 (-----)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://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: <https://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: -5.0 (-----)

Steps to reproduce:

1. emacs -Q
2. (advice-add 'some-funbound-sym :override #'ignore)
3. C-h f some-funbound-sym RET

This results in the *Help* buffer reporting:

--8<---------------cut here---------------start------------->8---
some-funbound-sym is .

[Missing arglist.  Please make a bug report.]

Not documented.

[back]
--8<---------------cut here---------------end--------------->8---

which I presume is at least partially due to

  (get 'some-funbound-sym 'function-documentation)
    => (advice--make-docstring 'some-funbound-sym)

I wouldn't expect advised-but-undefined functions to have meaningful
documentation, but IMO the suggestion to make a bug report is
misleading, given that many users are likely to advise as-of-yet
undefined functions in their user-init-file.

-- 
Basil

In GNU Emacs 27.0.50 (build 25, x86_64-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2018-01-22 built on thunk
Repository revision: c42959cc206bcb52baffd45f892da1b767f0f8c1
Windowing system distributor 'The X.Org Foundation', version 11.0.11905000
System Description: Debian GNU/Linux testing (buster)




Acknowledgement sent to "Basil L. Contovounesios" <contovob@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#30223; 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: Tue, 17 Apr 2018 20:30:02 UTC

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