From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Joel Reicher Newsgroups: gmane.emacs.devel Subject: Re: Commands, term "closure" and online help Date: Sun, 14 Jul 2024 18:48:37 +1000 Message-ID: <86plrgcqai.fsf@gmail.com> References: <861q76llng.fsf@gnu.org> <86y19ek6hx.fsf@gnu.org> <26141.19574.948512.394768@retriever.mtv.corp.google.com> <86v84ik3bp.fsf@gnu.org> <86ttgs1s11.fsf@gmail.com> <87sewcplet.fsf@web.de> <86h6cs1olc.fsf@gmail.com> <87sewc8m9m.fsf@web.de> Mime-Version: 1.0 Content-Type: text/plain; format=flowed Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="35283"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: Michael Heerdegen To: Michael Heerdegen via "Emacs development discussions." Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jul 14 10:49:42 2024 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 1sSuvO-00091c-Ee for ged-emacs-devel@m.gmane-mx.org; Sun, 14 Jul 2024 10:49:42 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sSuuf-0003wY-K8; Sun, 14 Jul 2024 04:48:57 -0400 Original-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 1sSuud-0003wJ-G7 for emacs-devel@gnu.org; Sun, 14 Jul 2024 04:48:55 -0400 Original-Received: from mail-oi1-x234.google.com ([2607:f8b0:4864:20::234]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sSuuU-0001Na-1a for emacs-devel@gnu.org; Sun, 14 Jul 2024 04:48:55 -0400 Original-Received: by mail-oi1-x234.google.com with SMTP id 5614622812f47-3d9db222782so2028110b6e.3 for ; Sun, 14 Jul 2024 01:48:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1720946922; x=1721551722; darn=gnu.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=oqCR21Lg3MMtyH9c3Mpzb7hlGJ3gy6oE+B1JNSrzFNA=; b=Pgr41C9XEJBEL+5CW8Iw6YWrRRIU2D6w1mM7bT5x0TIH3cYbgFLy2tGrOR2palGbvd KNBDcmQjKfh+NrVbtmTLIn0ZbfaREIadiC5yfKevpiiexyXjbFLok22MDQHlMtFM5WUg USsqs4loHMtXQAzkpglhI9+A6A5z8BlUW5J0O9quEPgcyRWsR89eP5gwu0MpxVO8nGPR ZjpTIhNFlRZrd5gTWscd1M+qz235bOQvc00WhjE8YDRt9CJzaueLrTfPduHRgorVZ0Tb /qMQQPGiLfhOHBz4wpzhw3At+B3du2YxnQsJrJe0i7Kb8eG0WJXS0P4FX7lcq+pzP7p0 WRjw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1720946922; x=1721551722; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=oqCR21Lg3MMtyH9c3Mpzb7hlGJ3gy6oE+B1JNSrzFNA=; b=Cn1qUak1Vr6FAHzNwhI2sjelwW8EsLO2QhjVm8ZjXA8gy0odLSUssKovatpEHXz6Hm mcMRq9KvI1/xRDOOXJuEHotAj8dYWQzrWDoE7tt6+ycoMSjH+qOd3xIsdIvykN66VfqH fBjmjnRZorcUkC/uKGi4vJ7TvrTxPughHxCmV79BQBMRfIDnHOeJURaRTvrpGy8vGkew +dAbIa6Z3+Jn+a/kIKodb46ItxVLJKhwobvpXTyVIUFnh5WgRdfNiSDPStSSKM1hM6Ha 9necut3nWPuF2mzCSPF3A63bp7YYZCBQu6ssIML6h671Ybj+aVE53+LoUXblb0BQ8DSi L54w== X-Gm-Message-State: AOJu0YxH2YpsvnlszkshzO2omY+heVVAnCyXPFRAOc9l9OeKz5isrJC5 Pwdm7N+RPIuPRqEiSQWIGrDA7/LZs5O4DOnBBwCh3xGSyJ5SMOa3 X-Google-Smtp-Source: AGHT+IFwbF7Kpxg6jFdiUb2KUI2SmEiJnKlOXrktZRS8YIhhOSTMd8Tno8QHSIZ06yCsWYVmbqEb8A== X-Received: by 2002:a05:6808:148b:b0:3d9:26d6:c70f with SMTP id 5614622812f47-3d93bee9516mr20140170b6e.7.1720946922458; Sun, 14 Jul 2024 01:48:42 -0700 (PDT) Original-Received: from LAPTOP-ACR66VVN ([1.145.146.9]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-1fc0bb9c4c2sm20500795ad.78.2024.07.14.01.48.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 14 Jul 2024 01:48:42 -0700 (PDT) In-Reply-To: <87sewc8m9m.fsf@web.de> (Michael Heerdegen via's message of "Sun, 14 Jul 2024 09:29:09 +0200") Received-SPF: pass client-ip=2607:f8b0:4864:20::234; envelope-from=joel.reicher@gmail.com; helo=mail-oi1-x234.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:321634 Archived-At: Michael Heerdegen via "Emacs development discussions." writes: > Joel Reicher writes: > >>> Aren't "dynamically defined functions" bytecode functions when >>> running compiled code? So this would not be a better term. >> >> Which bit of the documentation are you thinking of? I can't >> find that phrase with reference to bytecode. > > We are talking about the generated documentation in *Help*, > right? I've just been using my own words. In my question above I was referring to the Info documentation. I think it's helpful for the generated and static documentation to use consistent terminology. > But: Note that the wording used in the generated help pages has > changed since the start of this thread: we are currently saying > (at least in master) "interactive interpreted-function" or > "interactive byte-code-function". Can you live with that? Oh I see! Just had a poke around in the repo; I didn't realise the elisp respresentations themselves had changed, and I thought this was still just a documentation matter. I can't really offer an opinion until I understand the way the new types are being used, but I think the OP's main concern was that the term "closure" be avoided because it's a little opaque to some people unfamiliar with language implementation. Thanks and regards, - Joel