From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: master 48ac40e60e: ; Fix last change. Date: Sun, 14 Aug 2022 21:31:38 +0300 Message-ID: <8335dyk779.fsf@gnu.org> References: <166049949398.16955.13217655219158269477@vcs2.savannah.gnu.org> <20220814175134.47827C09BFD@vcs2.savannah.gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="37912"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Aug 14 20:32:50 2022 Return-path: Envelope-to: ged-emacs-devel@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 1oNIPp-0009g7-Jy for ged-emacs-devel@m.gmane-mx.org; Sun, 14 Aug 2022 20:32:49 +0200 Original-Received: from localhost ([::1]:51476 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oNIPo-0002X1-As for ged-emacs-devel@m.gmane-mx.org; Sun, 14 Aug 2022 14:32:48 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49024) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oNIOw-0001o8-Jj for emacs-devel@gnu.org; Sun, 14 Aug 2022 14:31:54 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:50532) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oNIOw-0004QU-6k; Sun, 14 Aug 2022 14:31:54 -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=zynzK640dPsUDXglheoJ5eZQrTWz9Fgd2+Ejtdxvmk8=; b=Bv97TAwcY8Vy u4QPEiKVyCq5K1IWavSrHP7t6id0w1p/NF9U0Vh+UFAc7d56kqINnWdAQzxJezkYfAWSp3w9MNZxo SzM4eujXc87aq/0q/ISXqVgjzmW2Dlkc/+VXnEPWILs7tt4Zg0IdjbnNtczZiK+lJraNQEsY9Wa/d Q1eHpS1//TvB8MHzXNj19UuH5Rjfsnc+GHFUIpFjFQ5tynbD0qkiq4ml8m6GeV6JOJHBBbSnODnwZ xk01SOCo2xgTROkEsy2nJbwR92MXcxyydLm7SG97q5dZwDQgIGc+DVMEPtkI63Zw9ER+7ltJ32/mS SW9jzKrPf3cOMnY7DrE18Q==; Original-Received: from [87.69.77.57] (port=4080 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 1oNIOv-0004lX-Ki; Sun, 14 Aug 2022 14:31:54 -0400 In-Reply-To: (message from Stefan Monnier on Sun, 14 Aug 2022 14:16:02 -0400) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:293458 Archived-At: > From: Stefan Monnier > Cc: emacs-devel@gnu.org > Date: Sun, 14 Aug 2022 14:16:02 -0400 > > > +This returns non-nil if its argument is either a built-in, or a > > +byte-compiled, or a natively-compiled function object, or a function > > +loaded from a dynamic module. > > Funny: I find this rather hard to understand compared to my > original wording. E.g. a reader might wonder what other cases there > could be and why they don't return non-nil. Are there other cases? If so, what are they? If I know what they are, I can think of a better wording. But if there are no other cases, I see nothing wrong with the current wording. > IOW, I prefer an "intentional" description over the "extensional" one > you installed. The original wording was too vague. Such a specific API cannot be documented in such vague terms. > E.g. it's more useful when faced with a new function type. Whoever does that change will need to remember to update the documentation. If they don't, some future bug report will remind us. We cannot refrain from documenting useful things because we don't want to have top modify our documentation due to future changes.