From unknown Sat Sep 06 03:34:17 2025 X-Loop: help-debbugs@gnu.org Subject: bug#59014: 29.0.50; single string in function body should act as doc string Resent-From: Nicolas Graner Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 04 Nov 2022 12:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 59014 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 59014@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.166756479426969 (code B ref -1); Fri, 04 Nov 2022 12:27:01 +0000 Received: (at submit) by debbugs.gnu.org; 4 Nov 2022 12:26:34 +0000 Received: from localhost ([127.0.0.1]:52020 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqvmL-00070u-Nh for submit@debbugs.gnu.org; Fri, 04 Nov 2022 08:26:34 -0400 Received: from lists.gnu.org ([209.51.188.17]:41798) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqvmI-00070j-MS for submit@debbugs.gnu.org; Fri, 04 Nov 2022 08:26:33 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oqvmI-00012x-HP for bug-gnu-emacs@gnu.org; Fri, 04 Nov 2022 08:26:30 -0400 Received: from smtp-out-63.di.u-psud.fr ([129.175.213.63]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oqvmG-0007cv-Dk for bug-gnu-emacs@gnu.org; Fri, 04 Nov 2022 08:26:30 -0400 Received: from smtp-out-1.di.u-psud.fr (localhost [127.0.0.1]) by smtp-out-1.di.u-psud.fr (UPS-MTA-OUT) with ESMTP id 4N3fxW2sZ0zbl7m for ; Fri, 4 Nov 2022 13:26:23 +0100 (CET) Received: from pmx1.di.u-psud.fr (pmx1.di.u-psud.fr [129.175.212.152]) by smtp-out-1.di.u-psud.fr (UPS-MTA-OUT) with ESMTP id 4N3fxW2kpyz1FPHf for ; Fri, 4 Nov 2022 13:26:23 +0100 (CET) Received: from smtp-in-1.di.u-psud.fr (localhost [127.0.0.1]) by localhost (UPS-PMX) with SMTP id 4N3fxW2cz4zdn7 for ; Fri, 4 Nov 2022 13:26:23 +0100 (CET) Received: from hypra-graner (ngnm.sciences.u-psud.fr [129.175.141.37]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp-in-1.di.u-psud.fr (UPS-MTA) with ESMTPS id 4N3fxW0k4Nz7J for ; Fri, 4 Nov 2022 13:26:23 +0100 (CET) Authentication-Results: smtp-in-1.di.u-psud.fr; none From: Nicolas Graner Date: Fri, 04 Nov 2022 13:26:22 +0100 Message-ID: <86fseyewi9.fsf@graner.name> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Rspamd-Queue-Id: 4N3fxW0k4Nz7J X-Rspamd-Action: no action Received-SPF: pass client-ip=129.175.213.63; envelope-from=SRS0=tmAQMLzU=3E=graner.name=nicolas@universite-paris-saclay.fr; helo=smtp-out-63.di.u-psud.fr X-Spam_score_int: -39 X-Spam_score: -4.0 X-Spam_bar: ---- X-Spam_report: (-4.0 / 5.0 requ) BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.1 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.1 (--) According to the Emacs lisp manual, node "Documentation Strings of Function= s": You may wonder how the documentation string could be optional, since there are required components of the function that follow it (the body). Since evaluation of a string returns that string, without any side effects, it has no effect if it is not the last form in the body. Thus, in practice, there is no confusion between the first form of the body and the documentation string; if the only body form is a string then it serves both as the return value and as the documentation. This last sentence is no longer true in 29.0.50, the single string is not used as doc string: (defun f () "foo") =E2=87=92 f (f) =E2=87=92 "foo" (documentation 'f) =E2=87=92 nil (emacs-version) =E2=87=92 "GNU Emacs 29.0.50 (build 3, x86_64-pc-linux-gnu, GTK+ Version 3.= 24.5, cairo version 1.16.0) of 2022-11-03" Hope this helps, Nicolas From unknown Sat Sep 06 03:34:17 2025 X-Loop: help-debbugs@gnu.org Subject: bug#59014: 29.0.50; single string in function body should act as doc string Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 04 Nov 2022 12:57:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 59014 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Nicolas Graner , Stefan Monnier Cc: 59014@debbugs.gnu.org Received: via spool by 59014-submit@debbugs.gnu.org id=B59014.166756657630099 (code B ref 59014); Fri, 04 Nov 2022 12:57:01 +0000 Received: (at 59014) by debbugs.gnu.org; 4 Nov 2022 12:56:16 +0000 Received: from localhost ([127.0.0.1]:52057 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqwF5-0007pP-Ks for submit@debbugs.gnu.org; Fri, 04 Nov 2022 08:56:15 -0400 Received: from eggs.gnu.org ([209.51.188.92]:38248) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqwF4-0007pD-1T for 59014@debbugs.gnu.org; Fri, 04 Nov 2022 08:56:14 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oqwEv-0004FH-Ja; Fri, 04 Nov 2022 08:56:05 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=182lv0k0QKZ2GHeYMKADw1WnnQ+pa1dJ3F319/8fVgM=; b=UGVQAUQXsDVILJBr5H7g gF5Z40Ts56pNWY1HJv3qZh899mcN7euv7SnUe9cx55PBqy0tpg/4i9dkTyTeAhwSXrapQ0sOQnV6o K9Z0kshY9YcnuBb8myawGHvGuubaI5EWsaSjnyHNdW7aNs5cb4XQAuMHxu/JE+DTGHkfdqhgwXSra /YAZORHMZl/z+8OASqQQS69r2MhwblqUwGDBMuECkyLVptMC3Iv/B7VbCdye+AHZAwZ8kA0kwGtP8 nL/O5+WUKCpbAWM00+u/ihB9BGVu9FbpmoFlu5dXeKRLQ+avGf3nx0LG1liCVxDuW6VqwZwhAsscf vbmaw7MxJe8CBg==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oqwEp-0000SY-UR; Fri, 04 Nov 2022 08:56:05 -0400 Date: Fri, 04 Nov 2022 14:55:54 +0200 Message-Id: <838rkq6fqd.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <86fseyewi9.fsf@graner.name> (message from Nicolas Graner on Fri, 04 Nov 2022 13:26:22 +0100) References: <86fseyewi9.fsf@graner.name> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Nicolas Graner > Date: Fri, 04 Nov 2022 13:26:22 +0100 > > According to the Emacs lisp manual, node "Documentation Strings of Functions": > > You may wonder how the documentation string could be optional, since > there are required components of the function that follow it (the > body). Since evaluation of a string returns that string, without any > side effects, it has no effect if it is not the last form in the > body. Thus, in practice, there is no confusion between the first > form of the body and the documentation string; if the only body form > is a string then it serves both as the return value and as the > documentation. > > This last sentence is no longer true in 29.0.50, the single string is > not used as doc string: > > (defun f () "foo") > ⇒ f > (f) > ⇒ "foo" > (documentation 'f) > ⇒ nil > (emacs-version) > ⇒ "GNU Emacs 29.0.50 (build 3, x86_64-pc-linux-gnu, GTK+ Version 3.24.5, cairo version 1.16.0) > of 2022-11-03" Thanks. Stefan, this seems to be due to your changes in commit 39e8fd357dd0a1f3776c05eee2cc5be451686712. Specifically, the new function-documentation returns nil in this case. Could you please take a look at this? From unknown Sat Sep 06 03:34:17 2025 X-Loop: help-debbugs@gnu.org Subject: bug#59014: 29.0.50; single string in function body should act as doc string Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 04 Nov 2022 15:16:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 59014 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 59014@debbugs.gnu.org, Nicolas Graner Received: via spool by 59014-submit@debbugs.gnu.org id=B59014.166757490930652 (code B ref 59014); Fri, 04 Nov 2022 15:16:01 +0000 Received: (at 59014) by debbugs.gnu.org; 4 Nov 2022 15:15:09 +0000 Received: from localhost ([127.0.0.1]:54564 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqyPV-0007yH-4n for submit@debbugs.gnu.org; Fri, 04 Nov 2022 11:15:09 -0400 Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:45834) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqyPQ-0007xS-TL for 59014@debbugs.gnu.org; Fri, 04 Nov 2022 11:15:06 -0400 Received: from pmg1.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 521FA100197; Fri, 4 Nov 2022 11:14:59 -0400 (EDT) Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id A15231000FB; Fri, 4 Nov 2022 11:14:57 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1667574897; bh=GBsEPj5y/aRTCQ5Wy2bwC5cq/vxLz+9HTQe40GqPFS0=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=l9OFJmlHioe9Mnb7E2luEHZe8FK6UxTyuBm9ovMFQ7/ei7Tei9dyHQjcUclLiUYl2 aTdN2LDghdTa6PUJk9guNOHbgxIKPUzaBdyizCO9DuMAcyS3foBaDWOpnQwCIrNxCh vPxIG2rpZn1o1Ic0YwBIbmrqdCtsQVFzil3SDR9F1srnK7FtBECk/3GdpwOMpJf+aQ 8zIq+nRBmEvhWpUoRs1DTKTGditIqiaj4BGAkvpHB8dtEbzrfvwNlRZp5xEMb8AEd5 EnOCdu1KtFeZf3BxUaEaJI7+epDbCVNiHQKbV+op9ik7//4/TaBaKuVc+hihKnmWwq x23GTvYZQrTpg== Received: from alfajor (unknown [45.44.229.252]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 6C28412102D; Fri, 4 Nov 2022 11:14:57 -0400 (EDT) From: Stefan Monnier In-Reply-To: <838rkq6fqd.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 04 Nov 2022 14:55:54 +0200") Message-ID: References: <86fseyewi9.fsf@graner.name> <838rkq6fqd.fsf@gnu.org> Date: Fri, 04 Nov 2022 11:14:55 -0400 User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-SPAM-INFO: Spam detection results: 0 ALL_TRUSTED -1 Passed through trusted hosts only via SMTP AWL -0.153 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DKIM_SIGNED 0.1 Message has a DKIM or DK signature, not necessarily valid DKIM_VALID -0.1 Message has at least one valid DKIM or DK signature DKIM_VALID_AU -0.1 Message has a valid DKIM or DK signature from author's domain X-SPAM-LEVEL: X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) >> From: Nicolas Graner >> Date: Fri, 04 Nov 2022 13:26:22 +0100 >> >> According to the Emacs lisp manual, node "Documentation Strings of Functions": >> >> You may wonder how the documentation string could be optional, since >> there are required components of the function that follow it (the >> body). Since evaluation of a string returns that string, without any >> side effects, it has no effect if it is not the last form in the >> body. Thus, in practice, there is no confusion between the first >> form of the body and the documentation string; if the only body form >> is a string then it serves both as the return value and as the >> documentation. Boy, I should (re)read this manual more regularly. I was convinced the intended behavior was to treat (defun f () "foo") as a function with no docstring (as witnessed in the resulting behavior I implemented). > Stefan, this seems to be due to your changes in commit > 39e8fd357dd0a1f3776c05eee2cc5be451686712. Specifically, the new > function-documentation returns nil in this case. Could you please > take a look at this? Will do, Stefan From unknown Sat Sep 06 03:34:17 2025 X-Loop: help-debbugs@gnu.org Subject: bug#59014: 29.0.50; single string in function body should act as doc string Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 04 Nov 2022 16:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 59014 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 59014@debbugs.gnu.org, Nicolas Graner Received: via spool by 59014-submit@debbugs.gnu.org id=B59014.166757763910176 (code B ref 59014); Fri, 04 Nov 2022 16:01:02 +0000 Received: (at 59014) by debbugs.gnu.org; 4 Nov 2022 16:00:39 +0000 Received: from localhost ([127.0.0.1]:54637 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqz7X-0002dU-1S for submit@debbugs.gnu.org; Fri, 04 Nov 2022 12:00:39 -0400 Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:18191) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqz7U-0002KP-73 for 59014@debbugs.gnu.org; Fri, 04 Nov 2022 12:00:38 -0400 Received: from pmg1.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 75EBB100197; Fri, 4 Nov 2022 12:00:30 -0400 (EDT) Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 0627B1000FB; Fri, 4 Nov 2022 12:00:29 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1667577629; bh=ziSMfqIONgBK2WPn4HSR0y4eydxJYiQEBYLVrcUwJk4=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=N8EgmOaCdwKl+ogRrPfod/UAIwNXRHOzOxeelOBYDuPP8xmLgtXzhMv3Kt35pCeeq 1OZbDNkJxzPe/V7G73pf/DPUj0SEbzA34mRMZQB24YhnUaf4SPuJ/0XkIQcoyjGhje vAO3qa/xd8HOx+qWxmDdKnbVNFDi2mnQJ5wgQx0vF2kO8/BPT7b9A9RUen1N7tRjza 8GDXUw0eB60ALqGoW2vsjuxYD23WqtPQJhMrUd/zb1LWtlz0y/UUK3ZX5DKV/5IIs/ b1mlpPlMVLLRQFSLxrDpgwceIobhPX6+MKTD4FOWsyiv/5LHJ55+JdJuhcv70kr1gk H4bi47TzWmv6A== Received: from alfajor (unknown [45.44.229.252]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id D30B01208E8; Fri, 4 Nov 2022 12:00:28 -0400 (EDT) From: Stefan Monnier In-Reply-To: (Stefan Monnier's message of "Fri, 04 Nov 2022 11:14:55 -0400") Message-ID: References: <86fseyewi9.fsf@graner.name> <838rkq6fqd.fsf@gnu.org> Date: Fri, 04 Nov 2022 12:00:24 -0400 User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-SPAM-INFO: Spam detection results: 0 ALL_TRUSTED -1 Passed through trusted hosts only via SMTP AWL -0.188 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DKIM_SIGNED 0.1 Message has a DKIM or DK signature, not necessarily valid DKIM_VALID -0.1 Message has at least one valid DKIM or DK signature DKIM_VALID_AU -0.1 Message has a valid DKIM or DK signature from author's domain X-SPAM-LEVEL: X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) >> Stefan, this seems to be due to your changes in commit >> 39e8fd357dd0a1f3776c05eee2cc5be451686712. Specifically, the new >> function-documentation returns nil in this case. Could you please >> take a look at this? Should be fixed now, Stefan From unknown Sat Sep 06 03:34:17 2025 X-Loop: help-debbugs@gnu.org Subject: bug#59014: 29.0.50; single string in function body should act as doc string References: <86fseyewi9.fsf@graner.name> Resent-From: Nicolas Graner Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 04 Nov 2022 16:31:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 59014 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stefan Monnier Cc: eliz@gnu.org, 59014@debbugs.gnu.org Received: via spool by 59014-submit@debbugs.gnu.org id=B59014.166757942414215 (code B ref 59014); Fri, 04 Nov 2022 16:31:02 +0000 Received: (at 59014) by debbugs.gnu.org; 4 Nov 2022 16:30:24 +0000 Received: from localhost ([127.0.0.1]:54658 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqzaJ-0003hC-Po for submit@debbugs.gnu.org; Fri, 04 Nov 2022 12:30:24 -0400 Received: from smtp-out-68.di.u-psud.fr ([129.175.213.68]:48596) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqzaH-0003gu-Bt for 59014@debbugs.gnu.org; Fri, 04 Nov 2022 12:30:22 -0400 Received: from smtp-out-2.di.u-psud.fr (localhost [127.0.0.1]) by smtp-out-2.di.u-psud.fr (UPS-MTA-OUT) with ESMTP id 4N3mLt67kJz1gHC; Fri, 4 Nov 2022 17:30:14 +0100 (CET) Received: from pmx2.di.u-psud.fr (pmx2.di.u-psud.fr [129.175.212.153]) by smtp-out-2.di.u-psud.fr (UPS-MTA-OUT) with ESMTP id 4N3mLt64XyzbbcP; Fri, 4 Nov 2022 17:30:14 +0100 (CET) Received: from smtp-in-2.di.u-psud.fr (localhost [127.0.0.1]) by localhost (UPS-PMX) with SMTP id 4N3mLt60WHz1r4Gy; Fri, 4 Nov 2022 17:30:14 +0100 (CET) Received: from hypra-graner (ngnm.sciences.u-psud.fr [129.175.141.37]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp-in-2.di.u-psud.fr (UPS-MTA) with ESMTPS id 4N3mLt2y6Zz2f; Fri, 4 Nov 2022 17:30:14 +0100 (CET) Authentication-Results: smtp-in-2.di.u-psud.fr; none From: Nicolas Graner In-Reply-To: (message from Stefan Monnier on Fri, 04 Nov 2022 12:00:24 -0400) Date: Fri, 04 Nov 2022 17:30:14 +0100 Message-ID: <86edui8yy1.fsf@graner.name> MIME-Version: 1.0 Content-Type: text/plain X-Rspamd-Queue-Id: 4N3mLt2y6Zz2f X-Rspamd-Action: no action X-Spam-Score: -2.0 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.0 (---) Stefan Monnier wrote on 2022-11-04 12:00: >>> Stefan, this seems to be due to your changes in commit >>> 39e8fd357dd0a1f3776c05eee2cc5be451686712. Specifically, the new >>> function-documentation returns nil in this case. Could you please >>> take a look at this? > > Should be fixed now, Thanks. Nicolas From unknown Sat Sep 06 03:34:17 2025 X-Loop: help-debbugs@gnu.org Subject: bug#59014: 29.0.50; single string in function body should act as doc string Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 04 Nov 2022 16:53:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 59014 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stefan Monnier Cc: 59014@debbugs.gnu.org, nicolas@graner.name Received: via spool by 59014-submit@debbugs.gnu.org id=B59014.166758077116506 (code B ref 59014); Fri, 04 Nov 2022 16:53:01 +0000 Received: (at 59014) by debbugs.gnu.org; 4 Nov 2022 16:52:51 +0000 Received: from localhost ([127.0.0.1]:54690 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqzw2-0004IA-N9 for submit@debbugs.gnu.org; Fri, 04 Nov 2022 12:52:50 -0400 Received: from eggs.gnu.org ([209.51.188.92]:46194) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqzvz-0004Ht-VX for 59014@debbugs.gnu.org; Fri, 04 Nov 2022 12:52:48 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oqzvq-0005mS-IZ; Fri, 04 Nov 2022 12:52:40 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=9tdtLN+zH8qlEhM8l3aVebWKmugV4hhO3MW+yhSCN5A=; b=Qv6MJZ+QaxPa ZLAxnHf+qfHQsc7SeZnMbWpBRLqHzgvjomqnGAGleEFECpjFjyfG9grVGsO97sVADwEIaXSSjcgID /2teuW7ZgtyTUX05zYHmOLas7dxs6OEAtNj5E+LvsRwuQPAVTvthrU3I5ZmDW2EeI6zvzsQGQ8Hzb IVID/uZPOpE+CK/oWSSWiVcKmFdqN//kEZPrgH8FoBoYLHMJn3c0C/U1NeWC3M1qKTTx2m8UeXD6S 17/c4FvT83D5Wc8rilzVGR2LO0+GdN2ibpd6wbBvk64XfQXonlveX+NFXLzVbM7U4wfEPwGQTu6n+ 5Oxw+yT4+nKoha8b5uAy8A==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oqzvp-0004FL-VW; Fri, 04 Nov 2022 12:52:38 -0400 Date: Fri, 04 Nov 2022 18:52:31 +0200 Message-Id: <83wn8a4q7k.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: (message from Stefan Monnier on Fri, 04 Nov 2022 12:00:24 -0400) References: <86fseyewi9.fsf@graner.name> <838rkq6fqd.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Stefan Monnier > Cc: Nicolas Graner , 59014@debbugs.gnu.org > Date: Fri, 04 Nov 2022 12:00:24 -0400 > > >> Stefan, this seems to be due to your changes in commit > >> 39e8fd357dd0a1f3776c05eee2cc5be451686712. Specifically, the new > >> function-documentation returns nil in this case. Could you please > >> take a look at this? > > Should be fixed now, Thanks, works now. From unknown Sat Sep 06 03:34:17 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Nicolas Graner Subject: bug#59014: closed (Re: bug#59014: 29.0.50; single string in function body should act as doc string) Message-ID: References: <86fseyewi9.fsf@graner.name> X-Gnu-PR-Message: they-closed 59014 X-Gnu-PR-Package: emacs Reply-To: 59014@debbugs.gnu.org Date: Fri, 04 Nov 2022 17:45:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1667583902-21500-1" This is a multi-part message in MIME format... ------------=_1667583902-21500-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #59014: 29.0.50; single string in function body should act as doc string which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 59014@debbugs.gnu.org. --=20 59014: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D59014 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1667583902-21500-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 59014-done) by debbugs.gnu.org; 4 Nov 2022 17:44:34 +0000 Received: from localhost ([127.0.0.1]:54730 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1or0k4-0005Zv-TN for submit@debbugs.gnu.org; Fri, 04 Nov 2022 13:44:34 -0400 Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:58121) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1or0jz-0005Zc-Nt for 59014-done@debbugs.gnu.org; Fri, 04 Nov 2022 13:44:32 -0400 Received: from pmg1.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id EC808100197; Fri, 4 Nov 2022 13:44:20 -0400 (EDT) Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 9F42E1000FB; Fri, 4 Nov 2022 13:44:19 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1667583859; bh=8Ak/bM/LaNmPFzoDCEV4pvP5ihSPpRb0I0g1M2c9WrQ=; h=From:To:Subject:In-Reply-To:References:Date:From; b=WMv3ASXYiRp033QAfr26C9xkIhtSRkEUsc/5WYAqjRq2QXOv7PZFOufWwTf9+Hc3u DqrA2+hDFgBYxM1+ezWskJbp9C4KIhKr54NEiWrJUcociNZW9g/saowRa4a4aw7NBo 1ey3rI770f6KotKzFaVZ0JcFQVOZZZkZ27NeLROAttCIVo4BE4zOfLPd3dkbr8Xpzx QNbnys/Qw1kEAY87YTaBAbUxR/DM1YrDYmg7wMU23f7ynn/7OHC6Zkd+od67AJ/Nm3 MfbCSPAheZkVVi/V715jS02v9hY8adaKBWAg6xP+UfNBMX+KhvNvekqg9rAzy084BY 7iBJHEO5jy44A== Received: from alfajor (unknown [45.44.229.252]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 82F3D120847; Fri, 4 Nov 2022 13:44:19 -0400 (EDT) From: Stefan Monnier To: 59014-done@debbugs.gnu.org Subject: Re: bug#59014: 29.0.50; single string in function body should act as doc string In-Reply-To: <83wn8a4q7k.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 04 Nov 2022 18:52:31 +0200") Message-ID: References: <86fseyewi9.fsf@graner.name> <838rkq6fqd.fsf@gnu.org> <83wn8a4q7k.fsf@gnu.org> Date: Fri, 04 Nov 2022 13:44:18 -0400 User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-SPAM-INFO: Spam detection results: 0 ALL_TRUSTED -1 Passed through trusted hosts only via SMTP AWL -0.177 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DKIM_SIGNED 0.1 Message has a DKIM or DK signature, not necessarily valid DKIM_VALID -0.1 Message has at least one valid DKIM or DK signature DKIM_VALID_AU -0.1 Message has a valid DKIM or DK signature from author's domain X-SPAM-LEVEL: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 59014-done X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) >> Should be fixed now, > Thanks, works now. Closing, Stefan ------------=_1667583902-21500-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 4 Nov 2022 12:26:34 +0000 Received: from localhost ([127.0.0.1]:52020 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqvmL-00070u-Nh for submit@debbugs.gnu.org; Fri, 04 Nov 2022 08:26:34 -0400 Received: from lists.gnu.org ([209.51.188.17]:41798) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oqvmI-00070j-MS for submit@debbugs.gnu.org; Fri, 04 Nov 2022 08:26:33 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oqvmI-00012x-HP for bug-gnu-emacs@gnu.org; Fri, 04 Nov 2022 08:26:30 -0400 Received: from smtp-out-63.di.u-psud.fr ([129.175.213.63]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oqvmG-0007cv-Dk for bug-gnu-emacs@gnu.org; Fri, 04 Nov 2022 08:26:30 -0400 Received: from smtp-out-1.di.u-psud.fr (localhost [127.0.0.1]) by smtp-out-1.di.u-psud.fr (UPS-MTA-OUT) with ESMTP id 4N3fxW2sZ0zbl7m for ; Fri, 4 Nov 2022 13:26:23 +0100 (CET) Received: from pmx1.di.u-psud.fr (pmx1.di.u-psud.fr [129.175.212.152]) by smtp-out-1.di.u-psud.fr (UPS-MTA-OUT) with ESMTP id 4N3fxW2kpyz1FPHf for ; Fri, 4 Nov 2022 13:26:23 +0100 (CET) Received: from smtp-in-1.di.u-psud.fr (localhost [127.0.0.1]) by localhost (UPS-PMX) with SMTP id 4N3fxW2cz4zdn7 for ; Fri, 4 Nov 2022 13:26:23 +0100 (CET) Received: from hypra-graner (ngnm.sciences.u-psud.fr [129.175.141.37]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp-in-1.di.u-psud.fr (UPS-MTA) with ESMTPS id 4N3fxW0k4Nz7J for ; Fri, 4 Nov 2022 13:26:23 +0100 (CET) Authentication-Results: smtp-in-1.di.u-psud.fr; none From: Nicolas Graner To: bug-gnu-emacs@gnu.org Subject: 29.0.50; single string in function body should act as doc string Date: Fri, 04 Nov 2022 13:26:22 +0100 Message-ID: <86fseyewi9.fsf@graner.name> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Rspamd-Queue-Id: 4N3fxW0k4Nz7J X-Rspamd-Action: no action Received-SPF: pass client-ip=129.175.213.63; envelope-from=SRS0=tmAQMLzU=3E=graner.name=nicolas@universite-paris-saclay.fr; helo=smtp-out-63.di.u-psud.fr X-Spam_score_int: -39 X-Spam_score: -4.0 X-Spam_bar: ---- X-Spam_report: (-4.0 / 5.0 requ) BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.1 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.1 (--) According to the Emacs lisp manual, node "Documentation Strings of Function= s": You may wonder how the documentation string could be optional, since there are required components of the function that follow it (the body). Since evaluation of a string returns that string, without any side effects, it has no effect if it is not the last form in the body. Thus, in practice, there is no confusion between the first form of the body and the documentation string; if the only body form is a string then it serves both as the return value and as the documentation. This last sentence is no longer true in 29.0.50, the single string is not used as doc string: (defun f () "foo") =E2=87=92 f (f) =E2=87=92 "foo" (documentation 'f) =E2=87=92 nil (emacs-version) =E2=87=92 "GNU Emacs 29.0.50 (build 3, x86_64-pc-linux-gnu, GTK+ Version 3.= 24.5, cairo version 1.16.0) of 2022-11-03" Hope this helps, Nicolas ------------=_1667583902-21500-1--