From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Boruch Baum Newsgroups: gmane.emacs.devel Subject: Re: declare function/macro private Date: Mon, 7 Jun 2021 21:14:56 -0400 Message-ID: <20210608011456.zc56i2i22tboxcgf@E15-2016.optimum.net> References: <20210607033526.4c5nntohhprdkzzd@E15-2016.optimum.net> <835yyphmqx.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="27043"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: NeoMutt/20180716 Cc: 0278C47F-42CE-45C4-B789-83C57DF1A191@bydasein.com, monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Jun 08 03:16:17 2021 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 1lqQLo-0006pF-3y for ged-emacs-devel@m.gmane-mx.org; Tue, 08 Jun 2021 03:16:16 +0200 Original-Received: from localhost ([::1]:57824 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lqQLm-0005Zx-UJ for ged-emacs-devel@m.gmane-mx.org; Mon, 07 Jun 2021 21:16:14 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50990) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lqQKi-0004mi-Vk for emacs-devel@gnu.org; Mon, 07 Jun 2021 21:15:09 -0400 Original-Received: from mout.gmx.net ([212.227.17.20]:50973) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lqQKh-0008OZ-1j; Mon, 07 Jun 2021 21:15:08 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1623114900; bh=ppZOao3Tbdag763U1zAJq21yxgcR2aSI4hiNo0RY9xE=; h=X-UI-Sender-Class:Date:From:To:Cc:Subject:References:In-Reply-To; b=gwKADIGftoQNqGAqV5HDUomjq8Kdep1ytQbxKmV/NegdVFB6uGfX4yX1s3fS9qnNL VlXPZZdXEPFSW8LK9KHl8F+/DvLwuFlJOgF5DV8nuCOsbtpSDx01lcRitOYSOb6OMR bHYYTFCQ5UYDGNlAXDk2hajXoLlY+KwLkI1RmXZ0= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from E15-2016.optimum.net ([96.224.230.212]) by mail.gmx.net (mrgmx105 [212.227.17.174]) with ESMTPSA (Nemesis) id 1MgNct-1l98cl0Jx9-00hrn2; Tue, 08 Jun 2021 03:15:00 +0200 Content-Disposition: inline In-Reply-To: <835yyphmqx.fsf@gnu.org> X-Provags-ID: V03:K1:b/XhPLUG7dp/UQ3dMv90LxtxD1KPjYhGm1IGSNseySW3bJR2vjH pv6qAwGGNge2EmfcrNwPEyIN9l9dk7/jghDAM3vkoiJh/G6xZngw8Le/psKhYg6czd7p7Lh j9/A6Cf7oe6ZlwnIOCs6cxV82IDE/eWAOXaANPcBnwmvxOosZaIu9ZFel53HakYXQNd+FHF 2PoXT3+NPbI7epzLBh5Gg== X-UI-Out-Filterresults: notjunk:1;V03:K0:TKCQyucdFNY=:ubVJujHp+ZRgGtrqtz7Noi F3+Te01re7S3qmBxj9IkUIYelqOQRVJm7MB4rZag1ePfGYN8a7DR2tlKoqtjwO51ALpe3uqmZ CYakvtQ/eebN1ufFdLSVuxxNP+rG3JmlxWWVFyXFduJMJs5eIdU0YskVF8MKejxTPW5YAxf+j QNio1wBxcTspj/OEYnlBHat8pqJ9knd2261h/0O+vKs2RgEZNu5fG6fmnt1Ul1VPZVf2bRjcj 3Ahg6lQsJXpH0rKy3EqEGKbnGsZHLFHnP9zsmLluyyJCNILio9HBKNDAsonxI9kIRzm2bsS4N xVSUyzkK4iZDwwa9RwV2TZkanvx3iihr9hH1hw9gd7HPtpmoJKqpI3vWW+yW1+yc7wM2GCdFT /ZkPxqsYqw9jIihAigU8nleLJekeipKPKefSagGOUolRHL0KcWAvrfRuJdprE+TLpFEqHGWjw Jzlpp2qAsGDuy4TngwDaM0p9GdRbPxnE1X3PClBzayjt/VeLQII0nrlidpQIdDjwSJ0neeD13 3rX1Oa6rETuhoh8ICi95mlhZrRqlvXV+B/CPFOakzqKErens+WU9D6s4n+7vGNjST21yE23PF TPwdnIQM0meqp+IhttZbzc+pe+pf2HvC4LZfVciA2MfS915b3mhLmNO7OFQsU97FRE2zZB/bz WM3TNL7LEORzh9PtpfqVRnJTSrHowAQ5izD5wvHHfQrnuqY9ptrNl+QhGEub6YfB4+xa9XrVo gQ2JGMnXshRaczd43HslN1ZVmE4XNSSqZHOPSsiqpBYPg8/DwBi7PdcWjukP2RmQURdApziY Received-SPF: pass client-ip=212.227.17.20; envelope-from=boruch_baum@gmx.com; helo=mout.gmx.net X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, 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.23 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:270548 Archived-At: On 2021-06-07 15:39, Eli Zaretskii wrote: > > Date: Sun, 6 Jun 2021 23:35:26 -0400 > > From: Boruch Baum > > Cc: "Paul W. Rankin" <0278C47F-42CE-45C4-B789-83C57DF1A191@bydasein.co= m>, > > Stefan Monnier > > > > On Sun, 06 Jun 2021 22:54:41 -0400, Stefan Monnier wrote: > > > > > My current guess is that you fear that "--" has currently been used > > > carelessly > > > > Using 'ivy/counsel' and performing M-x -- gives me 56 completion > > candidates. 23 are from magit, Here are the rest: > > You need to remove from this list those which are intended for > invocation via the mouse. They aren't relevant to the issue at hand, > because the "--" was used there "for other purposes". The point was just to support Paul Rankin's position that a '--' substring isn't a reliable determinant of a function's public/private nature, so can't be used as an alternative to an explicit (optional) declaration. My concern isn't the declaration, but the scope of its consequences. For example, an emacs user who does no elisp programming would be happy to have no private variable/function results appear among completion candidates when performing M-x describe-variable/function. Elisp programmers would want those completion candidates exposed, and subject to being extended/advised. =2D- hkp://keys.gnupg.net CA45 09B5 5351 7C11 A9D1 7286 0036 9E45 1595 8BC0