From unknown Fri Jun 20 07:09:22 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#35433 <35433@debbugs.gnu.org> To: bug#35433 <35433@debbugs.gnu.org> Subject: Status: 27.0.50; 'function' docstring: tell more about advantages? Reply-To: bug#35433 <35433@debbugs.gnu.org> Date: Fri, 20 Jun 2025 14:09:22 +0000 retitle 35433 27.0.50; 'function' docstring: tell more about advantages? reassign 35433 emacs submitter 35433 Michael Heerdegen severity 35433 wishlist thanks From debbugs-submit-bounces@debbugs.gnu.org Thu Apr 25 23:40:55 2019 Received: (at submit) by debbugs.gnu.org; 26 Apr 2019 03:40:55 +0000 Received: from localhost ([127.0.0.1]:59749 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hJrjK-0002VQ-PF for submit@debbugs.gnu.org; Thu, 25 Apr 2019 23:40:54 -0400 Received: from eggs.gnu.org ([209.51.188.92]:48257) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hJrjI-0002VC-M5 for submit@debbugs.gnu.org; Thu, 25 Apr 2019 23:40:54 -0400 Received: from lists.gnu.org ([209.51.188.17]:45816) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hJrjD-0005YL-Hq for submit@debbugs.gnu.org; Thu, 25 Apr 2019 23:40:47 -0400 Received: from eggs.gnu.org ([209.51.188.92]:34406) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hJrjC-0005N6-J6 for bug-gnu-emacs@gnu.org; Thu, 25 Apr 2019 23:40:47 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.7 required=5.0 tests=BAYES_20,FREEMAIL_FROM, RCVD_IN_DNSWL_LOW,URIBL_BLOCKED autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hJrjB-0005X6-LL for bug-gnu-emacs@gnu.org; Thu, 25 Apr 2019 23:40:46 -0400 Received: from mout.web.de ([212.227.15.14]:53853) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hJrjB-0005Vm-8l for bug-gnu-emacs@gnu.org; Thu, 25 Apr 2019 23:40:45 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1556250043; bh=EI2ABsSv1LZ2J5YzrC2CQUupsKCg1Dm6uAoB6cyEixE=; h=X-UI-Sender-Class:From:To:Subject:Date; b=gkfiRpSudZ8yTE93vMQwY/dEFqaeFv99jgfyVy+u4Y5H/Pa0drkN52l84CCJz/AQ1 40rGFFVLnIG0Cn0GgQgvy+lmHWt2K1gB3TWDis9azEnvrEQxsvx16hUf7EqY183NN6 HjFbIROEKpQDVGq8bgITBS50k2qXrCDwWmbiqAq8= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Received: from drachen.dragon ([92.208.87.27]) by smtp.web.de (mrweb003 [213.165.67.108]) with ESMTPSA (Nemesis) id 0MIvaT-1hMKZ80Me1-002UMd for ; Fri, 26 Apr 2019 05:40:43 +0200 From: Michael Heerdegen To: bug-gnu-emacs@gnu.org Subject: 27.0.50; 'function' docstring: tell more about advantages? Date: Fri, 26 Apr 2019 05:40:42 +0200 Message-ID: <874l6ll9hh.fsf@web.de> MIME-Version: 1.0 Content-Type: text/plain X-Provags-ID: V03:K1:vY++masfiUBMlX9YJNSPCPYhS5oS3DKUYLD3oUSmkgRoaOQJpKI 36JBdikToD2zBDJcFzIhKznBdfjFMk3VlLbhJYOVlUjYEnnRftL7MtHKCCiRTVl1pMShdjE E84JRRHWlT0S2hkc6gcy13na+tStmqCSnkInP8h2rWNbcT5UICsn5K8oazqY3RMHan59VAn /uoFKPwOsCtYulwCrMsew== X-UI-Out-Filterresults: notjunk:1;V03:K0:EePLpMJEfCo=:6tA09NVoys9CDZV+ZPAXqQ c1zPYgXFsS70rsX9mOHyVsqDm98HVOJWY6IciyjDaH6G2OfENmNQ5OXkczbccPqYoJIOkJ9Ic Uk7ggDrn7LRhU8s4Fhuttt7Yvzk5vnlLNQY+d7YUhLanL4nF5apInNKuDyyR5PzoUi1v7Qt4q NMkpzQ4TpT4gTGkULR1C8Ei+GjizK9slyRiRFr2yte8FbIAcnEZITTSgFZK74qccpe5BC+Vq/ 71O3KVcb3s+LXOpz9/m2x4oZkErEe20LbAR52sgRdpUubD2ipqoWGiBVPgweRJDoJGKh58wyA c449GR+hsPbR2xnOzoUcHjS2ELE9WwYzBKX8i5OBvyJYmA0QERYdAPki0+mRDHyaKb1bso7pl D3ycaArYzQ2OpXKyrnqg+Hbfp7PlwTzZ8nZkskytaTGDgCJJqxXAZpz3PoOZp+JVvX3CLFPO6 EW4lMhYwQYwfXV00yHpKAC17jBUKEi1ivjzQDVyqSP7O57VMhvTfI+PZzuQGqt271Wn1e/d4z dri6lS/Z4aWEEzIipgsoBS+Nb0FaBAAnR9hdsdJ0CzYspMUBrVpKjLQWfjRxaQswFeUrHs395 EiR7GnncixC6cZImi9GGCCP3W+dEBTWlpIleVX31LOvbK3DBYkQplPVuB5Pa2ahwve4l4bvP2 8yhCdXhgAZR0Pnsw2u6xXqW8VOCEYne2SHLlHCNA7Hr0QHNArXIaA+qHVTrkd1k8Nlx1yv0Ja qBKB6JYGovGZ0U5QMhSIKEb1KVlZJLRagWjLM4CQCT2zDCriD3dG426xVLcU6l+5317iRhTDJ xJHA+YhZLDS/5EEg2XYS0DNky5nSfhFarYr+iclbEp60LD0s+mSmZ4HCfbEm6viD8ann/x8iO lndIkMkhpu72gdXGRkKERtOUl538TSibWsJFGTYtBNtcbpu7LLTaW0NKyKZ2nt7co3nOEymj9 UeF/8ddLqxg== X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 212.227.15.14 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Spam-Score: -1.4 (-) 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.4 (--) Hello, I wonder if we should add to the docstring of `function' that when the argument is a symbol, several checks are performed: it is checked whether the function will be defined at run-time and whether the function is obsolete, for example. The current docstring doesn't suggest that function-quoting symbols has any advantages, but these warnings are also useful for users' init files, people that are not always informed what "argument is byte compiled" implies. Thanks, Michael. In GNU Emacs 27.0.50 (build 38, x86_64-pc-linux-gnu, GTK+ Version 3.24.5) of 2019-04-26 built on drachen Repository revision: a43eea1bc82acce627d489a32f706572b27e6f7f Repository branch: master Windowing system distributor 'The X.Org Foundation', version 11.0.12003000 System Description: Debian GNU/Linux buster/sid From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 26 02:49:17 2019 Received: (at 35433) by debbugs.gnu.org; 26 Apr 2019 06:49:17 +0000 Received: from localhost ([127.0.0.1]:59847 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hJufc-00073G-Rl for submit@debbugs.gnu.org; Fri, 26 Apr 2019 02:49:17 -0400 Received: from eggs.gnu.org ([209.51.188.92]:57409) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hJufZ-000732-UU for 35433@debbugs.gnu.org; Fri, 26 Apr 2019 02:49:14 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:35311) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hJufU-0007DM-IV; Fri, 26 Apr 2019 02:49:08 -0400 Received: from [176.228.60.248] (port=1041 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hJufT-0003P2-N9; Fri, 26 Apr 2019 02:49:08 -0400 Date: Fri, 26 Apr 2019 09:48:51 +0300 Message-Id: <83h8alxnvw.fsf@gnu.org> From: Eli Zaretskii To: Michael Heerdegen In-reply-to: <874l6ll9hh.fsf@web.de> (message from Michael Heerdegen on Fri, 26 Apr 2019 05:40:42 +0200) Subject: Re: bug#35433: 27.0.50; 'function' docstring: tell more about advantages? References: <874l6ll9hh.fsf@web.de> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 35433 Cc: 35433@debbugs.gnu.org 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: Michael Heerdegen > Date: Fri, 26 Apr 2019 05:40:42 +0200 > > I wonder if we should add to the docstring of `function' that when the > argument is a symbol, several checks are performed: it is checked > whether the function will be defined at run-time and whether the > function is obsolete, for example. > > The current docstring doesn't suggest that function-quoting symbols has > any advantages, but these warnings are also useful for users' init > files, people that are not always informed what "argument is byte > compiled" implies. I think these details belong first and foremost to the ELisp manual. We could also add a shortened version to the doc string, but I'd like first to see the full version in the manual. Thanks. From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 27 04:30:38 2019 Received: (at 35433) by debbugs.gnu.org; 27 Apr 2019 08:30:38 +0000 Received: from localhost ([127.0.0.1]:34253 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hKIjG-0007rR-A0 for submit@debbugs.gnu.org; Sat, 27 Apr 2019 04:30:38 -0400 Received: from mout.web.de ([217.72.192.78]:48273) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hKIjE-0007rF-RM for 35433@debbugs.gnu.org; Sat, 27 Apr 2019 04:30:37 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1556353830; bh=4DaFYBtZobt1ZtPj0KSVcMBxkrhQ7wsSov1xKNFxvLU=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=l5pCo+mgtbC0ksFsyb7FzyJ+7paT6UFXWHsHcl+oYWUDFZDADa+yQTQUdpJ2dkRbG WsT5mlZEb/8uqjbhGhCtggrQQuph1NXDSu6UpKylJaJKSuoI94ydOX1F9PEhDAB6J9 18ag1x0ls52gpw2WdXyPPPl7gOKbrGskOo6usPJg= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Received: from drachen.dragon ([92.208.87.27]) by smtp.web.de (mrweb101 [213.165.67.124]) with ESMTPSA (Nemesis) id 0M7snk-1gY5tV3zjE-00vR9s; Sat, 27 Apr 2019 10:30:30 +0200 From: Michael Heerdegen To: Eli Zaretskii Subject: Re: bug#35433: 27.0.50; 'function' docstring: tell more about advantages? References: <874l6ll9hh.fsf@web.de> <83h8alxnvw.fsf@gnu.org> Date: Sat, 27 Apr 2019 10:30:28 +0200 In-Reply-To: <83h8alxnvw.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 26 Apr 2019 09:48:51 +0300") Message-ID: <877ebf6eaj.fsf@web.de> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Provags-ID: V03:K1:MiShcu+w4yhcg6VgOrWA2/CAik337p2TmdzOk8/XCP6pPirQ7Gx IhbyLbXfrLhqbAVuI2THOzAQuvzHkiP+M1PgXJZtuL8pqWr+NSngnL1SKRlSBi1nZ6TqOdP Yxz4swIm7SijKA07E85lzscjMRNVkrWQZ1nq5SRbD9lZcxkZU5YC/nzWcdMsy+2fapa9WvG y0/pRfJ8e33Ibd+yfwitA== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:G5UFPRWMU6U=:qsv0PawRUZdu5E5MGZ6qjt hGxjLUQkGDMIEN/39fyI3p78UClCRDIhW+jJ1y6c/i8zAtxr72E/Y9YAEKcQ2iECZdjFoogQq qR5v+rXttYDn5tgiOJL9O974kUwEAGpbw4BFvvlHh7WV2nLgv61ce5XvSFpZuAsPLerZwgGt+ ET+rRMzA3s6AvuMkLzMuiT5aQg8H6KuLtPe0iQZv9+fmAnCUZywHBo6ZlyJGBmWGmFeYQniGq yL4O5XJGVbqYIuF8pxrFpIrg+AneMvjMyL7NxPvAbiRV2Mv17PnzWyW6lBvRaTHX848G1+KN2 wPhAupnQl3Se3vQGNLF5kYuiIwJ2kuNx00ZLCtonOF+oEFphgPYkibgfBQn5b9Si0r3Ee5sQe lLpgw9cJfDJaFBsMtItmhAjbealUPxZFuZUNbBP7hwANEHSVmjy68NCQyPSpANNiCzgA8nwZC 4SL4h/4SsZx6ruhWILsi7r+ldlmufEjszB3ogqyTDl7hLheLepjf3QNIQlUSVT8Tm6egwsea2 MbmXczzaOjMVCDjMtPr5/O7NEf99kSxzME5agfc1MKzzDYRYAtIv9aAGqOnajbv4jZ2Bg3Ubp 5cl89pv9n1dCtCT1/GGmIqNCuPKT3wOb+MPORc5QGE6HpDeTUKx0HgWcsR1FJaKlcVyrIvPhi MudiVyJVrxROAMnpcq+zmz6gDJE0g4XkYMiAUzTdQHd3GwmP5aomp8ePD/nZcPPmOHv5fLnpc zK0oASBbF67XAmr9cuVfW5YgdpfHhGsTXfbnHq+HZb/aNCdQZ/UMfvz/fst4gsDHNs9b3RyJo SSA8y/KG+UqLcrGTxbKqfJ9CCMOrZwZP+zGBLkeyn5kuKGmzkh3ioY5CUjbXu5VrBGpnV6ewd 6RgL7Br1HSKwUy/Ll5YzfE1n70HOGZcAftzbJWr2zkWh6jE6F/vSI8PWywighkzXTjUagN6Ar GyXrJWbcG/w== X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 35433 Cc: 35433@debbugs.gnu.org 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: -1.7 (-) Eli Zaretskii writes: > I think these details belong first and foremost to the ELisp manual. > We could also add a shortened version to the doc string, but I'd like > first to see the full version in the manual. Maybe we could just change the wording in the docstring to something like "In byte compilation, `function' causes its argument to be handled by the by compiler." and tell the rest in the manual. Currently it only says "compiling the argument" which only covers the lambda-form case, and this is even the less interesting case, because lambda function-quotes itself nowadays. Michael. From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 27 04:47:27 2019 Received: (at 35433) by debbugs.gnu.org; 27 Apr 2019 08:47:27 +0000 Received: from localhost ([127.0.0.1]:34275 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hKIzW-0008FQ-Sl for submit@debbugs.gnu.org; Sat, 27 Apr 2019 04:47:27 -0400 Received: from eggs.gnu.org ([209.51.188.92]:32998) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hKIzU-0008FC-JP for 35433@debbugs.gnu.org; Sat, 27 Apr 2019 04:47:25 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:43119) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hKIzP-0006lO-9A; Sat, 27 Apr 2019 04:47:19 -0400 Received: from [176.228.60.248] (port=2095 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hKIzO-0000mg-KD; Sat, 27 Apr 2019 04:47:19 -0400 Date: Sat, 27 Apr 2019 11:47:04 +0300 Message-Id: <835zqzx2bb.fsf@gnu.org> From: Eli Zaretskii To: Michael Heerdegen In-reply-to: <877ebf6eaj.fsf@web.de> (message from Michael Heerdegen on Sat, 27 Apr 2019 10:30:28 +0200) Subject: Re: bug#35433: 27.0.50; 'function' docstring: tell more about advantages? References: <874l6ll9hh.fsf@web.de> <83h8alxnvw.fsf@gnu.org> <877ebf6eaj.fsf@web.de> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 35433 Cc: 35433@debbugs.gnu.org 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: Michael Heerdegen > Cc: 35433@debbugs.gnu.org > Date: Sat, 27 Apr 2019 10:30:28 +0200 > > Eli Zaretskii writes: > > > I think these details belong first and foremost to the ELisp manual. > > We could also add a shortened version to the doc string, but I'd like > > first to see the full version in the manual. > > Maybe we could just change the wording in the docstring to something > like > > "In byte compilation, `function' causes its argument to be handled by > the by compiler." > > and tell the rest in the manual. Fine with me (but you probably meant "byte compiler", not "by compiler"). From debbugs-submit-bounces@debbugs.gnu.org Wed May 22 19:40:06 2019 Received: (at 35433) by debbugs.gnu.org; 22 May 2019 23:40:06 +0000 Received: from localhost ([127.0.0.1]:43398 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hTaq5-0002Ld-U8 for submit@debbugs.gnu.org; Wed, 22 May 2019 19:40:06 -0400 Received: from mout.web.de ([212.227.15.14]:56077) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hTaq4-0002L3-8O for 35433@debbugs.gnu.org; Wed, 22 May 2019 19:40:04 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1558568393; bh=iEvB1ecI13HJVa4qY1l/5jbUY5mtmRBpnYbHpHP1Z0c=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=s8WK0a36I/hj4bS8hB9jkWbvbEkiqgdBL8IRz/19+hKkFsDMnc+/ApA4m3xEg+hTI Ztiaqea0IZ9FKu2UbwSksCdGf4sYdo1GXsVMV8uSSJNmS3SJN4OgZSN8jBsqc8BAie UVp0GXdK+Q9U/7EfvwGYVlxhZe5SEcfpRZWsN5f4= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Received: from drachen.dragon ([188.110.143.34]) by smtp.web.de (mrweb002 [213.165.67.108]) with ESMTPSA (Nemesis) id 0Lz2zw-1gYCu83HBQ-014FEU; Thu, 23 May 2019 01:39:52 +0200 From: Michael Heerdegen To: Eli Zaretskii Subject: Re: bug#35433: 27.0.50; 'function' docstring: tell more about advantages? References: <874l6ll9hh.fsf@web.de> <83h8alxnvw.fsf@gnu.org> <877ebf6eaj.fsf@web.de> <835zqzx2bb.fsf@gnu.org> Date: Thu, 23 May 2019 01:39:49 +0200 In-Reply-To: <835zqzx2bb.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 27 Apr 2019 11:47:04 +0300") Message-ID: <87a7fe2h4q.fsf@web.de> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Provags-ID: V03:K1:A7WYKOspGMCgqDzL97Wx8KmcnGh4vJoqyZXABjfjR17JKkGOnSG G7z0B4qZ/aPhCRNHhmUul3vRf96Rt8bvKJdReT/M+HwgmZGeO/xmviV/O1njayeK6Pq4vLO tCXDKeXa17RzYDTaAUGC/rE0IIYTVSLknCAWE7FKyW4lN8zKXB4u/kPxTJNX7k0Q3IAjfQ0 hEhav7JyrPsQyB8u1dlSg== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:O451F7Lm/DM=:jyBvT4NxooVHZ2hAT5kPWy P2RRNTxxzvjYzdN1NSZIEi8VxpDpHmZCukuYqmE49vNig4pKfaBIK4oAOcbObPHbIajkttUZv xQA1y8oSOTaTUG9Nl1qrWode0oYv1YH2d96XBzPEo9Urnltm2mZzWvxLfPjRWGqiLirdqb0qv t+V90OOFLSLVCbO9vWKVD2/jxjMTEgJIFBesr2FUb7fcRFfy5ho3lHR8YOeKZKNOOxZqCuhhW cq0P/VgQ8qi7Db6Sk/wqcWoW5FlVNmVj/Gz978JCJLj0WsPQ7a7m5mUVdnBWB+ecKj4ImD/u2 SLDGwc+8gPDcEtYma6JbDOERcWtp7w6F25GA9FHw42bjFmWyiRo34vxDabkuX3bDBjbtovwqD vYLMwkeADSYj4dJo2yMzttBEJV8J6sx5gc3fqQmElDFvg9C6zCcSb2k57zjTQO9WD6svp+DE3 ELDPE0bN6lCFn5ZOKG2Z+QtgeaPa/+j5/WS7CdpMaMdaWCuBXdTYYpQrPWWzRNG+YdT1h9Gur JwiVnBc/+ckR2kXb1zd6BTRiT9GVdC6vRTEjV37nr7wlT371SgaZxxt0Qq4gsJ0I0+7WnslV8 gAdlhK1T5Ho246kwtYCq00ttoUuszU6d+c+4NCD5qsm3J1fibNrXXAn8GdSCGkw/iFkgizPgr P/Yfie+lWjEkygY71SdvEVtEhIqeYN/5Z7ERsEnlyhyLeuV97FEGzbkqs7qY4OsZQR3g+lFaP QvtciBlV0xxOD2cgO8z6pqO0IwaHmDATeMxuzBZTgBE+WgVGumF1+eSxLMEmp8tfFSoGq/LJ+ zfngACm+ofZv/NaGPSzRuqdBPNkNKrzVFa7960cu9xws7WzCfhSPE7YI/gQ81g0buh6TvpQnu 9LZ3CLNtQ/QEisjgyYxPJFKgnbF4dENRdQWv8IGEA2ALIBXEfCtiUYFWq/RgvuzUvsC/WjMhy W785qUsLfN3lFpOdl3PN4/X+GfiCmFHENZKQPiVKAwoPHrp0Tqw8I X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 35433 Cc: 35433@debbugs.gnu.org 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: -1.7 (-) --=-=-= Content-Type: text/plain Eli Zaretskii writes: > Fine with me (but you probably meant "byte compiler", not "by > compiler"). Ehm - maybe. Ok, is this ok and are all conventions respected? --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=0001-Improve-documentation-of-the-function-special-form.patch Content-Transfer-Encoding: quoted-printable =46rom 5ac1f0de47720a19225d71e83b906192940a6917 Mon Sep 17 00:00:00 2001 From: Michael Heerdegen Date: Sat, 27 Apr 2019 09:40:10 +0200 Subject: [PATCH] Improve documentation of the 'function' special form Point out that 'function' quoting is beneficial also for symbols. * src/eval.c (function): Enhance docstring. * doc/lispref/functions.texi (Anonymous Functions): Improve documentation. =2D-- doc/lispref/functions.texi | 4 ++++ src/eval.c | 4 ++-- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi index 97f7fb9f79..09844318d9 100644 =2D-- a/doc/lispref/functions.texi +++ b/doc/lispref/functions.texi @@ -1122,6 +1122,10 @@ Anonymous Functions When lexical binding is enabled, @var{function-object} is converted into a closure. @xref{Closures}. @end itemize + +When @var{function-object} is a symbol and the code is byte compiled, +the byte-compiler will warn should that function be undefined or may +be unknown at run-time. @end defspec @cindex @samp{#'} syntax diff --git a/src/eval.c b/src/eval.c index 567c32e0d7..5bba876637 100644 =2D-- a/src/eval.c +++ b/src/eval.c @@ -544,8 +544,8 @@ usage: (quote ARG) */) DEFUN ("function", Ffunction, Sfunction, 1, UNEVALLED, 0, doc: /* Like `quote', but preferred for objects which are function= s. -In byte compilation, `function' causes its argument to be compiled. -`quote' cannot do that. +In byte compilation, `function' causes its argument to be handled by +the byte compiler. `quote' cannot do that. usage: (function ARG) */) (Lisp_Object args) { =2D- 2.20.1 --=-=-= Content-Type: text/plain Thanks, Michael. --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Thu May 23 00:43:31 2019 Received: (at 35433) by debbugs.gnu.org; 23 May 2019 04:43:31 +0000 Received: from localhost ([127.0.0.1]:43700 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hTfZj-0003fa-4x for submit@debbugs.gnu.org; Thu, 23 May 2019 00:43:31 -0400 Received: from eggs.gnu.org ([209.51.188.92]:49519) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hTfZi-0003fP-8n for 35433@debbugs.gnu.org; Thu, 23 May 2019 00:43:30 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:53482) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hTfZd-0003fV-3T; Thu, 23 May 2019 00:43:25 -0400 Received: from [176.228.60.248] (port=3264 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hTfZc-0002pd-Eq; Thu, 23 May 2019 00:43:24 -0400 Date: Thu, 23 May 2019 07:43:32 +0300 Message-Id: <83blzt7pcb.fsf@gnu.org> From: Eli Zaretskii To: Michael Heerdegen In-reply-to: <87a7fe2h4q.fsf@web.de> (message from Michael Heerdegen on Thu, 23 May 2019 01:39:49 +0200) Subject: Re: bug#35433: 27.0.50; 'function' docstring: tell more about advantages? References: <874l6ll9hh.fsf@web.de> <83h8alxnvw.fsf@gnu.org> <877ebf6eaj.fsf@web.de> <835zqzx2bb.fsf@gnu.org> <87a7fe2h4q.fsf@web.de> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 35433 Cc: 35433@debbugs.gnu.org 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: Michael Heerdegen > Cc: 35433@debbugs.gnu.org > Date: Thu, 23 May 2019 01:39:49 +0200 > > +When @var{function-object} is a symbol and the code is byte compiled, > +the byte-compiler will warn should that function be undefined or may > +be unknown at run-time. I'd say "... will warn if that function is not defined, which means it might not be known at run time" instead. "Undefined" and "unknown" sound vague and more ominous to me. Otherwise, fine with me, thanks. From debbugs-submit-bounces@debbugs.gnu.org Thu May 23 12:55:25 2019 Received: (at 35433) by debbugs.gnu.org; 23 May 2019 16:55:25 +0000 Received: from localhost ([127.0.0.1]:45142 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hTr01-0000Zl-Br for submit@debbugs.gnu.org; Thu, 23 May 2019 12:55:25 -0400 Received: from mout.web.de ([212.227.15.3]:55991) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hTr00-0000ZY-7A for 35433@debbugs.gnu.org; Thu, 23 May 2019 12:55:24 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1558630510; bh=a7KiFAViml5sn5aH/pPfBrO/66uX8/EdXMb91UvGNPo=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=i1fsS5oy+oKB187FWxQUmOUUedIcc7R/NsYs0IFpvo4U/EHEo47sl40L/oaiCjuiR HXPZjb8kdzxSZMqvlg4MKLLL1AOwTYzxFs9r53d8NjjZrlnHqOVCPddbJujzVVK3T5 lphfQ1IfQfWyGsngko4LG8kZZEjzgwG6joe4kgkI= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Received: from drachen.dragon ([188.110.143.34]) by smtp.web.de (mrweb002 [213.165.67.108]) with ESMTPSA (Nemesis) id 0LoHKz-1h1O0F2cfZ-00gGrN; Thu, 23 May 2019 18:55:10 +0200 From: Michael Heerdegen To: Eli Zaretskii Subject: Re: bug#35433: 27.0.50; 'function' docstring: tell more about advantages? References: <874l6ll9hh.fsf@web.de> <83h8alxnvw.fsf@gnu.org> <877ebf6eaj.fsf@web.de> <835zqzx2bb.fsf@gnu.org> <87a7fe2h4q.fsf@web.de> <83blzt7pcb.fsf@gnu.org> Date: Thu, 23 May 2019 18:55:08 +0200 In-Reply-To: <83blzt7pcb.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 23 May 2019 07:43:32 +0300") Message-ID: <87r28p1577.fsf@web.de> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Provags-ID: V03:K1:ygFlnVFSlwLd4e76iURP3jRBXNqBP+4kH6f6zRLk3K7EkVAl2JP lrIfBR3jg1/kRzcCrXN2aHrEv8prTjgUTpvAGo0c3DXK1YZiTzpYmyNPX9/htZz0pr7WtF4 RDq5hNUwv0kdimGtvuqZTLfPaB7u5cZGASLTM5+WwSuQqpBiMZCsHAPX47Lfr1SgMsEPNYM t9bLsFcxM+Bwn1x4H0VyQ== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:Nvx5NtM4iIw=:eyU3qcxqpgkUQQIV7MjjYa gqaORQHj7woZ3RlYYNI7ytLvdmSfzj/ujq3dP+NGuOoVfrnhTm0huxGH5bdL1P6MWbp8C6VTH MbXzLxHsGgNPHGG/1EAFx3g/ufNaGSnzJf1Q7zq7c/LfaKPdqAk+5Tobyv6r9CH3Yjg5W9rmQ K7cZ/sK9y/rfX16A6MX1ftfkatY88kTSKtRm0Et1n0nGJKhoOvp0Ehul372BH/594fGmK5tdx 6a3S4iXOmuCYm3U3zvV5tlwrChWe7tipCcFnTt4XBJoIdyTgvvZ7pxA3F9Dn4WoMIzGwH1uHD GgTiGt9E0cpJ7qqV8nLNosPwVh9x92zXcmVjqkcvA7vhXGuvQY/3NPVmiiFBBlztqBxq53ByH awaj5HiHkHRu0ZscaF9lyoeJAN/hfmVZWwvJgo4VqTnnltSMN2i9GFJguZnLw3qN7orD8t0ug SSSS94j5YvPkvXCdUWKpbYAMLCj3FpLWvKcH/202FbiLCaapItcHi+Ey309YEuS8ONyHtLKuE IiLbkrJ6NH2t1jQeGsbXM7qg6YL0b8cpqNczCzAA5sOJGnF2jJPnv2FWYBA+Lcxtn4255mqcI Gh9dZJ8ck0o6dz27wj8gMEAws9Jmk0PUcPKlF0t6vwhDsa3fqmMBDoFm35/I1Tl0jh16tYoZV n1A+5sla9NH8XwIaI+JoQR8NYGLX7CoktbcZpFsvWT/1sII/ca7eCyZiYICYOtKmxg8Wc4UqS QkusZrpjFk0Sak4UhGNeyR/wNFGA1OkoPwI9fRNd2geU8ek36AsJyXYQnE3sVhkJOes5wcFW6 1D58jOH+xE/kzE3O/J1iwZA3yt3C2iamb0S9jtnKz+JzOqOF/m2TXL87Ic/eUFrZS/nDIsDdV 4VMWu/Re7A9lMNAjL0zFTAgGvF8igYdZBoVYHn13JIWC08asF+ARaSPtKRn0NXpVXFWvVjwa4 RXtzHi7jc2fVU0gM80xEFeEg8lwgLdfYn7u7O5Ywv5Hv7CfbRoxk0 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 35433 Cc: 35433@debbugs.gnu.org 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: -1.7 (-) Eli Zaretskii writes: > > From: Michael Heerdegen > > Cc: 35433@debbugs.gnu.org > > Date: Thu, 23 May 2019 01:39:49 +0200 > > > > +When @var{function-object} is a symbol and the code is byte compiled, > > +the byte-compiler will warn should that function be undefined or may > > +be unknown at run-time. > > I'd say "... will warn if that function is not defined, which means > it might not be known at run time" instead. No, these are two different cases: (1) function not known when compiling, and (2) known to the compiler but function may still be unknown when the compiled code is run, because the compiled file misses `require' statements, for example. > "Undefined" and "unknown" sound vague and more ominous to me. Well, I tried to reuse the words from the actual compiler warnings - see `byte-compile-warn-about-unresolved-functions'. I may change "may be unknown" to "may not be known" - unless you have a better idea: +When @var{function-object} is a symbol and the code is byte compiled, +the byte-compiler will warn should that function be undefined or may +not be known at run-time. Thanks, Michael. From debbugs-submit-bounces@debbugs.gnu.org Thu May 23 14:31:45 2019 Received: (at 35433) by debbugs.gnu.org; 23 May 2019 18:31:46 +0000 Received: from localhost ([127.0.0.1]:45242 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hTsVF-0002uV-Io for submit@debbugs.gnu.org; Thu, 23 May 2019 14:31:45 -0400 Received: from eggs.gnu.org ([209.51.188.92]:52660) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hTsVB-0002uG-Uq for 35433@debbugs.gnu.org; Thu, 23 May 2019 14:31:43 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:38612) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hTsV6-00026A-Pf; Thu, 23 May 2019 14:31:36 -0400 Received: from [176.228.60.248] (port=2750 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hTsV6-0003fb-7I; Thu, 23 May 2019 14:31:36 -0400 Date: Thu, 23 May 2019 21:31:45 +0300 Message-Id: <83tvdl58fi.fsf@gnu.org> From: Eli Zaretskii To: Michael Heerdegen In-reply-to: <87r28p1577.fsf@web.de> (message from Michael Heerdegen on Thu, 23 May 2019 18:55:08 +0200) Subject: Re: bug#35433: 27.0.50; 'function' docstring: tell more about advantages? References: <874l6ll9hh.fsf@web.de> <83h8alxnvw.fsf@gnu.org> <877ebf6eaj.fsf@web.de> <835zqzx2bb.fsf@gnu.org> <87a7fe2h4q.fsf@web.de> <83blzt7pcb.fsf@gnu.org> <87r28p1577.fsf@web.de> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 35433 Cc: 35433@debbugs.gnu.org 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: Michael Heerdegen > Cc: 35433@debbugs.gnu.org > Date: Thu, 23 May 2019 18:55:08 +0200 > > > I'd say "... will warn if that function is not defined, which means > > it might not be known at run time" instead. > > No, these are two different cases: (1) function not known when > compiling, and (2) known to the compiler but function may still be > unknown when the compiled code is run, because the compiled file misses > `require' statements, for example. Then replace "which means it" with "or". > > "Undefined" and "unknown" sound vague and more ominous to me. > > Well, I tried to reuse the words from the actual compiler warnings - see > `byte-compile-warn-about-unresolved-functions'. The warnings there say "the function `%s' might not be defined at runtime." "the function `%s' is not known to be defined." They don't say "undefined" and "unknown". > I may change "may be unknown" to "may not be known" - unless you > have a better idea: > > +When @var{function-object} is a symbol and the code is byte compiled, > +the byte-compiler will warn should that function be undefined or may > +not be known at run-time. The phrase "should that function be ..." is usually interpreted as something that may or may happen in the future, which AFAIU is not what you mean. That's why I proposed a different wording, which doesn't have that problem. Or maybe I'm misunderstanding your intent. From debbugs-submit-bounces@debbugs.gnu.org Thu May 23 19:18:58 2019 Received: (at 35433-done) by debbugs.gnu.org; 23 May 2019 23:18:58 +0000 Received: from localhost ([127.0.0.1]:45602 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hTwzC-0001M0-Ay for submit@debbugs.gnu.org; Thu, 23 May 2019 19:18:58 -0400 Received: from mout.web.de ([212.227.17.12]:49673) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hTwzA-0001Ll-Ax for 35433-done@debbugs.gnu.org; Thu, 23 May 2019 19:18:57 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1558653525; bh=cku9RK7fOQuRClDMJLyemEYqg/hSt/KLd+CcqSoW/M0=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=X0V1RMl7Zcl9kK/aMt9u5vKEG674QEcdwJE6YYPDQu/cJgI+NGGpJKbUIWcQoF0H0 Gyqe3U6sdP80BNN+/S5qUYiBXbBu1phYdXhqLksl1ml6XMkyZSjKOC2oXEnjA5YgDA CHGh17jnbZ6EFXGGf19nnZ+Hhd7VX//neP5FR1pc= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Received: from drachen.dragon ([188.110.143.34]) by smtp.web.de (mrweb103 [213.165.67.124]) with ESMTPSA (Nemesis) id 0Lrryk-1gV4PK3xXS-013h0s; Fri, 24 May 2019 01:18:45 +0200 From: Michael Heerdegen To: Eli Zaretskii Subject: Re: bug#35433: 27.0.50; 'function' docstring: tell more about advantages? References: <874l6ll9hh.fsf@web.de> <83h8alxnvw.fsf@gnu.org> <877ebf6eaj.fsf@web.de> <835zqzx2bb.fsf@gnu.org> <87a7fe2h4q.fsf@web.de> <83blzt7pcb.fsf@gnu.org> <87r28p1577.fsf@web.de> <83tvdl58fi.fsf@gnu.org> Date: Fri, 24 May 2019 01:18:40 +0200 In-Reply-To: <83tvdl58fi.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 23 May 2019 21:31:45 +0300") Message-ID: <87lfywiwtr.fsf@web.de> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Provags-ID: V03:K1:XaO8lb3uAjAWLxYWwvaBhnkKzug1UGd8WlJFfdw1YvCplZEkfBS +rcoaOngsrABxiBqkmAOlBSMWybRuNRdWPWm+CKY/4gtQ3MXtuvYEx+YmJ5J21HybZeShD6 rejLBfjjuA+zU3zyL3gbc/wSz0LG0YxGX1PhQaovaX7ftpY4FXRkiKZH5TjZFXYv5g3Tp8P VIX49F4Q8EFbST4RE6TOQ== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:Je8TOtLj838=:qsD6z5wTIm9kzV7Vtx4rx4 59lFBy6Vwh89sJfYz4Zi/130t+mREHhWz/EzhJ2ZEeCtNU4KXWH5L9b/b4kZ35Khb56ZLEe0x PP18JWDZU5zv2FtjZ504cQzXO1DDSeXHEsmN80hFlYgr7FgP7qMrK3S9VasK5RLF+KkuHPJ7W bguj0kVWxw2LpU9S/LgLSsWbOxyTU4SRgm88FVR/WnpprxwFwFXTvNGmaOT2owtZ7Fjzw1JWX EFZj3e5ONkI3XdBijoE4CCLB1n/lNpZGriL/mPI78/q16goiSnrha8R6aYVQkTwQxI362EvSz YFFxwxGvvhYXbYc//moRxK5jupjZBD/MPc89wZfUpcJnpnRWSOlaG6ZfDFHHbzb3pS2ZooMPO eTLgmjpN57Sg1o5jiegUxARYG1XQSpxdAMRUhCxlfwlUcj+x3JyYO9/dOkULTd9MVuScU9Yxx 6uUPQepMi2zs0SWzn+dDlbjBBvLVssYZGR5BoS5PrdAhQXVGdNl8iCpcGYgN+et/7A8q0gwTU L4SW+eiiuYwMCYyqEWiqPlEhEuEL4liT92n5h9PDrEPFl2mC6XQHUPRezB8clgMB6aSSN6mo1 wK62ialWQegg8Pgsj59vzKIjoiVqk5lQsubNpnngQxGAlYGiIqDxZNpaA2mXb8b47NhpTSR18 yntToatNbMUq8NTSgF+5uQ272hUGzVcPTGCcpOIrLUEOAxnSuzalfbpYmHppQX0Zu8VkC0dgN ubpMmUmfTmCTIQ4025Lad0/iLOlzivM0SPqay0Xy29y/jwbzUNsvkSajORV+5BlO4uZFfVvtm mqSj7eQEks7Ylo89C7tIfShjcZ0FRliiWp6fVXyqLm1hk8uYobTEPE9hTLi312wRogE2xmmXB viOUgIokxPXWcUCudUmjrwgSoDFJ9f0Je5+R9k/J+qEJmZ0aLJ0ry2pCOnHZXN3l+QlUvWyiL wnUB+i7GK5IZPIhwlNafFAVoAhJLbsWWyjQ7AmrvKZ7OmDPS/R9A1 X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 35433-done Cc: 35433-done@debbugs.gnu.org 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: -1.7 (-) Eli Zaretskii writes: > Then replace "which means it" with "or". Ok, I just did that in 84a3da15e9 and close the report - thanks for your assistance (will probably not be the last time I need help with wording). BTW, what I found a bit inconsistent in that manual node was that sometimes the verb and the noun are sometimes called "byte-compile"/"byte-compiler" (with hyphen) and sometimes "byte compile"/"byte compiler" (without). Dunno if it matters and that should be more consistent. Thanks, Michael. From debbugs-submit-bounces@debbugs.gnu.org Fri May 24 02:42:05 2019 Received: (at 35433) by debbugs.gnu.org; 24 May 2019 06:42:05 +0000 Received: from localhost ([127.0.0.1]:45976 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hU3u1-0003lR-7M for submit@debbugs.gnu.org; Fri, 24 May 2019 02:42:05 -0400 Received: from eggs.gnu.org ([209.51.188.92]:55713) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hU3tz-0003ku-5v for 35433@debbugs.gnu.org; Fri, 24 May 2019 02:42:03 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:49057) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hU3tt-00072B-W3; Fri, 24 May 2019 02:41:58 -0400 Received: from [176.228.60.248] (port=3807 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hU3tt-0000hk-DF; Fri, 24 May 2019 02:41:57 -0400 Date: Fri, 24 May 2019 09:42:09 +0300 Message-Id: <83h89k5p6m.fsf@gnu.org> From: Eli Zaretskii To: Michael Heerdegen In-reply-to: <87lfywiwtr.fsf@web.de> (message from Michael Heerdegen on Fri, 24 May 2019 01:18:40 +0200) Subject: Re: bug#35433: 27.0.50; 'function' docstring: tell more about advantages? References: <874l6ll9hh.fsf@web.de> <83h8alxnvw.fsf@gnu.org> <877ebf6eaj.fsf@web.de> <835zqzx2bb.fsf@gnu.org> <87a7fe2h4q.fsf@web.de> <83blzt7pcb.fsf@gnu.org> <87r28p1577.fsf@web.de> <83tvdl58fi.fsf@gnu.org> <87lfywiwtr.fsf@web.de> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 35433 Cc: 35433@debbugs.gnu.org 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: Michael Heerdegen > Cc: 35433-done@debbugs.gnu.org > Date: Fri, 24 May 2019 01:18:40 +0200 > > Eli Zaretskii writes: > > > Then replace "which means it" with "or". > > Ok, I just did that in 84a3da15e9 and close the report Thanks. > thanks for your assistance You are welcome. > (will probably not be the last time I need help with wording). Nothing wrong with that. > BTW, what I found a bit inconsistent in that manual node was that > sometimes the verb and the noun are sometimes called > "byte-compile"/"byte-compiler" (with hyphen) and sometimes "byte > compile"/"byte compiler" (without). Dunno if it matters and that should > be more consistent. I think "byte-compile" should use a hyphen, whereas "byte-compiler" should not. From unknown Fri Jun 20 07:09:22 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 21 Jun 2019 11:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator