From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#35433: 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 Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="79010"; mail-complaints-to="usenet@blaine.gmane.org" To: 35433@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Apr 26 05:41:10 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hJrja-000KS9-Ij for geb-bug-gnu-emacs@m.gmane.org; Fri, 26 Apr 2019 05:41:10 +0200 Original-Received: from localhost ([127.0.0.1]:38611 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hJrjZ-00065c-K4 for geb-bug-gnu-emacs@m.gmane.org; Thu, 25 Apr 2019 23:41:09 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:34444) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hJrjS-00065E-TO for bug-gnu-emacs@gnu.org; Thu, 25 Apr 2019 23:41:03 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hJrjR-0005eD-Ug for bug-gnu-emacs@gnu.org; Thu, 25 Apr 2019 23:41:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:46207) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hJrjR-0005e9-RZ for bug-gnu-emacs@gnu.org; Thu, 25 Apr 2019 23:41:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hJrjR-0002Vy-Op for bug-gnu-emacs@gnu.org; Thu, 25 Apr 2019 23:41:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 26 Apr 2019 03:41:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 35433 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.15562500559640 (code B ref -1); Fri, 26 Apr 2019 03:41:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 26 Apr 2019 03:40:55 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 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+5317iRhTD X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.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.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:158267 Archived-At: 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