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: Thu, 23 May 2019 18:55:08 +0200 Message-ID: <87r28p1577.fsf@web.de> 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> Mime-Version: 1.0 Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="184547"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 35433@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu May 23 18:56:16 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 1hTr0p-000ltK-V5 for geb-bug-gnu-emacs@m.gmane.org; Thu, 23 May 2019 18:56:16 +0200 Original-Received: from localhost ([127.0.0.1]:40716 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hTr0o-0006qj-TR for geb-bug-gnu-emacs@m.gmane.org; Thu, 23 May 2019 12:56:14 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:46945) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hTr0d-0006mH-No for bug-gnu-emacs@gnu.org; Thu, 23 May 2019 12:56:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hTr0c-0001nO-Gj for bug-gnu-emacs@gnu.org; Thu, 23 May 2019 12:56:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:59832) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hTr0c-0001nI-CW for bug-gnu-emacs@gnu.org; Thu, 23 May 2019 12:56:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hTr0c-0000ad-8b for bug-gnu-emacs@gnu.org; Thu, 23 May 2019 12:56:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 23 May 2019 16:56:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35433 X-GNU-PR-Package: emacs Original-Received: via spool by 35433-submit@debbugs.gnu.org id=B35433.15586305252222 (code B ref 35433); Thu, 23 May 2019 16:56:02 +0000 Original-Received: (at 35433) by debbugs.gnu.org; 23 May 2019 16:55:25 +0000 Original-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 Original-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 Original-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 In-Reply-To: <83blzt7pcb.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 23 May 2019 07:43:32 +0300") X-Provags-ID: V03:K1:ygFlnVFSlwLd4e76iURP3jRBXNqBP+4kH6f6zRLk3K7EkVAl2JP lrIfBR3jg1/kRzcCrXN2aHrEv8prTjgUTpvAGo0c3DXK1YZiTzpYmyNPX9/htZz0pr7WtF4 RDq5hNUwv0kdimGtvuqZTLfPaB7u5cZGASLTM5+WwSuQqpBiMZCsHAPX47Lfr1SgMsEPNYM t9bLsFcxM+Bwn1x4H0VyQ== 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/wNFGA1OkoPwI9fRNd2geU8ek36AsJyXYQnE3sVhkJOes5wcFW 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:159684 Archived-At: 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.