From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Christopher Dimech Newsgroups: gmane.emacs.help Subject: [External] : Supplying DOC string in a `defun' using `defvar' Date: Thu, 3 Jun 2021 18:18:29 +0200 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6888"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "help-gnu-emacs@gnu.org" To: Stefan Monnier Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jun 03 18:27:54 2021 Return-path: Envelope-to: geh-help-gnu-emacs@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 1loqCI-0001VH-Ry for geh-help-gnu-emacs@m.gmane-mx.org; Thu, 03 Jun 2021 18:27:54 +0200 Original-Received: from localhost ([::1]:58014 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1loqCH-0007tX-SQ for geh-help-gnu-emacs@m.gmane-mx.org; Thu, 03 Jun 2021 12:27:53 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40072) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1loq3R-0001WL-HX for help-gnu-emacs@gnu.org; Thu, 03 Jun 2021 12:18:45 -0400 Original-Received: from mout.gmx.net ([212.227.15.18]:40965) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1loq3P-0001jO-FE for help-gnu-emacs@gnu.org; Thu, 03 Jun 2021 12:18:45 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1622737109; bh=JCue8Wwhif+hzuaCrO/w+dBotT1LJE1Z+dH2CJLbaqo=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=daScOiIy0P9Gt/fahDTGIDNJq2aQB6LoHiBQ9GLQQxRKSw4Az4FHulgd3V/qVqoVv lMXqS27zPDxTvPXvUA5vI6WEKdRxuEzXqtJSSdSvYK+yP5nP9MRxLf6YJtsefWV9/2 4Irn2jSD2wRxmBH1j+i7VB5DB+/D4eoTO/PC6wLs= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [213.165.168.94] ([213.165.168.94]) by web-mail.gmx.net (3c-app-mailcom-bs08.server.lan [172.19.170.176]) (via HTTP); Thu, 3 Jun 2021 18:18:29 +0200 Importance: normal Sensitivity: Normal In-Reply-To: X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:mtK2/j+Yg4aJwoQHTnLsO1nBDEg7Pl1tZLRNxxp/tQ2obV4mk5n1zbLV+1aCCHNYtz2DB rQGiCFKFTovFOeTAdqsmOQdc9spNWwE6RsJe5+f2vJ/V3DGAhW7ED2Rn3J+52imUz8o/QDl5gIi3 +ICVSeVnyuqdbnzThKkAa3CSzXGFbCczVmuKNsvu2AjtaiSfeJjluTA7Qqj9but9eOucdHdzIVZE O8dQYA4K0dzYQ2nUbHp9gavclhJraSa6oVfobZhI7gT5z3WUVN0z91IIHPThU0zQK5xjReMTjKe/ SA= X-UI-Out-Filterresults: notjunk:1;V03:K0:mue9smrE/ik=:U2avEmvpr4bdC2HIoZ9seO cVNTzKm+0EvbO9dJwJjyruGjZgcjRU95OEoNQKsCU3iBAQUssHNj2S6gXbJIowWvZXKj/ydoj DOAstKkTiotDt3Mxtd8Ck2W6yk2BBG6IKdQIoYyQ0Gxb2seF9wuMDk9pFOmUYQXOJUX+1Bd3E AyxB+fxq5uLDHVYw4oeaLzoaYt5UX0iw5VPt5YUH/FpWHQwZ5pejdtdP8y+3suLQwG+sBotDf lLk9Ow2rZZK2PCG1JfJ4irM1kNQ8PuKI9JzNqeJeAXQWRryEXgtp4FLYqzhykZNAvXVkKXqLV XPGlmIXKuxBJATZWR3nPoAkY17uJCCNBAvr3iqCnmKytEEmJ6Pf49oNAC0G/UCrR88cVjlQLr DXKBAc/A3G0OmSHU8e03Wn2IegxANuDt23Pl6artF9kT0P6Uu8vu3N+/e9EcNmajznavP0v3G 06SD51xHjKXkJAQ3sUJHkWHATH4phlMPYdx5G7C+b0eqTsFyUiQQrmSdGs6/4ou2V/iFFfFqW Ut16UyYGjBThq5fYU9n+3gdwZeSSBbCn9NxOoaDth9X05ltxAekQ2jjQchnSHHzxLrqOby9Vb HGSt9D8JF/K/TOYuS2XTGhe2Y6mEMa0XSut6NUMX2HybVcI6z9R+3KN+UOarI+HGjzDy5oFGL iwRenkqWzJtj37qTqeFJ0mjc5HXJTt6C7BPZvkBdpivPOAu8FLJW+F/GQvpYsS9d4PSjR43Xj XX1veLOO30pWfIOsp7cN7LU2LoBjw5Pg+Ig+BR+kQdjpAOUJ7ZACjf6MbX5MtGCKtUDafmGE Received-SPF: pass client-ip=212.227.15.18; envelope-from=dimech@gmx.com; helo=mout.gmx.net X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.io gmane.emacs.help:130535 Archived-At: > Sent: Friday, June 04, 2021 at 3:46 AM > From: "Stefan Monnier" > To: "Christopher Dimech" > Cc: "Drew Adams" , "help-gnu-emacs@gnu.org" > Subject: Re: [External] : Supplying DOC string in a `defun' using `defva= r' > > > Would I need to update the :documentation declaration after the transi= tion to default > > lexical binding becomes official? > > No. > > > It is acceptable to use the property of `defun` for the documentation.= For anonymous > > functions, I do not think one needs elaborate ways to set the document= ation - a normal > > description is good enough. > > Yet it's specifically for those cases that I introduced the > `:documentation` feature. > > Stefan At an operational level, I approve of your approach. Well done.