From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Tassilo Horn Newsgroups: gmane.emacs.help Subject: Re: Understanding internal use functions Date: Tue, 07 May 2019 11:57:24 +0200 Message-ID: <87ef5ah9iz.fsf@gnu.org> References: <87imuoghwv.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="39397"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Help Gnu Emacs mailing list To: "Paul W. Rankin" Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Tue May 07 11:57:41 2019 Return-path: Envelope-to: geh-help-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 1hNwqz-000A9o-E3 for geh-help-gnu-emacs@m.gmane.org; Tue, 07 May 2019 11:57:41 +0200 Original-Received: from localhost ([127.0.0.1]:43601 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hNwqy-0003tA-F8 for geh-help-gnu-emacs@m.gmane.org; Tue, 07 May 2019 05:57:40 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:50997) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hNwqn-0003t4-GO for help-gnu-emacs@gnu.org; Tue, 07 May 2019 05:57:30 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:56456) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hNwqn-0001QC-Ae; Tue, 07 May 2019 05:57:29 -0400 Original-Received: from auth1-smtp.messagingengine.com ([66.111.4.227]:41773) by fencepost.gnu.org with esmtpsa (TLS1.2:DHE_RSA_AES_256_CBC_SHA256:256) (Exim 4.82) (envelope-from ) id 1hNwql-00036J-Lc; Tue, 07 May 2019 05:57:28 -0400 Original-Received: from compute7.internal (compute7.nyi.internal [10.202.2.47]) by mailauth.nyi.internal (Postfix) with ESMTP id 2E7AE20D89; Tue, 7 May 2019 05:57:27 -0400 (EDT) Original-Received: from mailfrontend1 ([10.202.2.162]) by compute7.internal (MEProxy); Tue, 07 May 2019 05:57:27 -0400 X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduuddrkedtgddvfecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpefhvffufhffjgfkfgggtgesthdtredttdertdenucfhrhhomhepvfgrshhsihhl ohcujfhorhhnuceothhsughhsehgnhhurdhorhhgqeenucfkphepudefgedrudduledrvd egrdduleehnecurfgrrhgrmhepmhgrihhlfhhrohhmpehthhhorhhnodhmvghsmhhtphgr uhhthhhpvghrshhonhgrlhhithihqdekieejfeekjeekgedqieefhedvleekqdhtshguhh eppehgnhhurdhorhhgsehfrghsthhmrghilhdrfhhmnecuvehluhhsthgvrhfuihiivgep td X-ME-Proxy: Original-Received: from jiffyarch (j289989.servers.jiffybox.net [134.119.24.195]) by mail.messagingengine.com (Postfix) with ESMTPA id 0FD4AE4665; Tue, 7 May 2019 05:57:25 -0400 (EDT) Mail-Followup-To: "Paul W. Rankin" , Help Gnu Emacs mailing list In-Reply-To: (Paul W. Rankin's message of "Tue, 07 May 2019 13:07:47 +1000") X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.21 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.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.org gmane.emacs.help:120247 Archived-At: "Paul W. Rankin" writes: >> Internal functions/variables usually convey the meaning of "don't >> rely on me because I might change whenever my author likes". So it's >> more a hint to programmers than to users. > > So I should name a functions as internal as a way to imply "hey don't > use this in other programs" (for whatever reason)? Yes. And inversely, if you've written a public (non-internal) function in your package, better assume that someone somewhere is already using it in her config, so don't change its interface if not absolutely necessary. Bye, Tassilo