From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#36478: 26.2; Doc strings with "This function has a compiler macro..." and "This function does not change global state" Date: Wed, 02 Feb 2022 19:55:47 +0100 Message-ID: <87o83pp07g.fsf@gnus.org> References: <13f5f7df-9017-45a0-986f-8b1a4ee0e9bd@default> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="17174"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: 36478@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Feb 02 20:39:35 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nFLTb-0004Hw-56 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 02 Feb 2022 20:39:35 +0100 Original-Received: from localhost ([::1]:50146 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nFLTZ-0003c3-Jj for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 02 Feb 2022 14:39:33 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:46040) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nFKnS-0000hN-R8 for bug-gnu-emacs@gnu.org; Wed, 02 Feb 2022 13:56:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:59699) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nFKnS-0007ft-Hd for bug-gnu-emacs@gnu.org; Wed, 02 Feb 2022 13:56:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nFKnS-00006B-HD for bug-gnu-emacs@gnu.org; Wed, 02 Feb 2022 13:56:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 02 Feb 2022 18:56:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 36478 X-GNU-PR-Package: emacs Original-Received: via spool by 36478-submit@debbugs.gnu.org id=B36478.1643828160371 (code B ref 36478); Wed, 02 Feb 2022 18:56:02 +0000 Original-Received: (at 36478) by debbugs.gnu.org; 2 Feb 2022 18:56:00 +0000 Original-Received: from localhost ([127.0.0.1]:53595 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nFKnP-00005v-Sg for submit@debbugs.gnu.org; Wed, 02 Feb 2022 13:56:00 -0500 Original-Received: from quimby.gnus.org ([95.216.78.240]:42892) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nFKnO-00005b-A6 for 36478@debbugs.gnu.org; Wed, 02 Feb 2022 13:55:58 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=JKrq34yVGzBtS7Zmm7Bs6usUC1aLaiQKIIPrDFPshdQ=; b=ZeXWjAmlr1DY5VHysGquKLj4Ah bLiE/cIoMmQgp4HdUvWRskpfzwCf3Q63SnElS79+TH71XnJtC0A1+A1kf0fkLdOW7EIGI8fAr+Mbu aWGMyHcSaCxB1tBSVCdb5iwD+oTR+mp4Y3TWWzQeUkm4v77mrTeh6aSwaJVoOy72+WxA=; Original-Received: from [84.212.220.105] (helo=giant) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nFKnD-00079O-O7; Wed, 02 Feb 2022 19:55:50 +0100 X-Now-Playing: Brian Eno, Jah Wobble's _Spinner_: "Steam" In-Reply-To: <13f5f7df-9017-45a0-986f-8b1a4ee0e9bd@default> (Drew Adams's message of "Tue, 2 Jul 2019 11:05:18 -0700 (PDT)") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:225817 Archived-At: Drew Adams writes: > `C-h f zerop' tells you this: > > zerop is a compiled Lisp function in 'subr.el'. > > (zerop NUMBER) > > This function has a compiler macro 'zerop--anon-cmacro'. > > Return t if NUMBER is zero. > This function does not change global state, including the match data. > > Why on earth would we put that info about the function having a compiler > macro before the first doc string line? In Emacs 29 these details have been moved to the end of the help buffer. I've now also added some indexing to the manual so that it's easier to find out what a "compiler macro" is. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no