From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Tassilo Horn Newsgroups: gmane.emacs.devel Subject: Re: Document that symbol prefix "my-" (or other) should be left for users Date: Tue, 15 Dec 2015 19:22:20 +0100 Message-ID: <87mvtbinc3.fsf@gnu.org> References: <87mvtekydf.fsf@mithlond.arda> <87egeqkwj2.fsf@mithlond.arda> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1450203783 31861 80.91.229.3 (15 Dec 2015 18:23:03 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 15 Dec 2015 18:23:03 +0000 (UTC) Cc: Drew Adams , emacs-devel@gnu.org To: Teemu Likonen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Dec 15 19:22:55 2015 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1a8uF8-0006IA-38 for ged-emacs-devel@m.gmane.org; Tue, 15 Dec 2015 19:22:34 +0100 Original-Received: from localhost ([::1]:38606 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a8uF7-0002KR-43 for ged-emacs-devel@m.gmane.org; Tue, 15 Dec 2015 13:22:33 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53562) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a8uF3-0002Jn-Fu for emacs-devel@gnu.org; Tue, 15 Dec 2015 13:22:30 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a8uF0-00051b-73 for emacs-devel@gnu.org; Tue, 15 Dec 2015 13:22:29 -0500 Original-Received: from out1-smtp.messagingengine.com ([66.111.4.25]:57654) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a8uF0-00051W-1G for emacs-devel@gnu.org; Tue, 15 Dec 2015 13:22:26 -0500 Original-Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.nyi.internal (Postfix) with ESMTP id 3140421AEB for ; Tue, 15 Dec 2015 13:22:24 -0500 (EST) Original-Received: from frontend2 ([10.202.2.161]) by compute3.internal (MEProxy); Tue, 15 Dec 2015 13:22:24 -0500 DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-sasl-enc :x-sasl-enc; s=smtpout; bh=b+ijw/nPjZ4rbQm1z5C17L1L+iQ=; b=StGEm q+VtUNK+WjoVXMncFUeNO8Pd2YRxa0FzlHHMmBJVKlrFVQNGOMAh/on8Sr/CLN1z fDCLKeZqpP4JUDDktSBxJlz7Xf72L/V8LxwYFIXV4kCpZUJmvCTFqYY226rhG9iu G6pJhlX8krjkLzOWwGYbpJQBNpqDPd3RYLcRvw= X-Sasl-enc: MRs9hSVafht1lpIgyJ5eEGcVi5DTdJ8wrwXplpewLJUv 1450203743 Original-Received: from thinkpad-t440p (unknown [2.163.251.121]) by mail.messagingengine.com (Postfix) with ESMTPA id 1C0CD680136; Tue, 15 Dec 2015 13:22:22 -0500 (EST) Mail-Followup-To: Teemu Likonen , Drew Adams , emacs-devel@gnu.org In-Reply-To: (John Wiegley's message of "Mon, 14 Dec 2015 12:31:07 -0800") User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/25.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 66.111.4.25 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:196321 Archived-At: John Wiegley writes: >> I have had zero problems but it's also near-zero effort to decide a >> prefix, document it and obey it. And yes, it's for avoiding name >> conflicts: so that user's configuration won't harm future Emacs >> functionality, nor the other way around. > >> But it's just a suggestion. I'm not going to have a month long >> discussion about this. So just ignore it. :-) > > I appreciate the effort, Teemu, but I don't think it needs explicit > documentation. The only package that could conceivably use "my-" as a > prefix would have to be called "my", otherwise it's in violation of > other Emacs coding standards. There are some packages which have a long name and then use a short abbreviation for (parts of) their functions and variables. For example, the `ace-window' package defines functions and variables with the prefixes ace-* and aw-* (the latter mostly for "private" stuff). At least the aw-* symbols could easily clash with Anton Wiegley's private stuff. I just picked `ace-window' from the top of my head. I'm pretty sure there are more packages which use some abbreviation of their name as prefix. Despite clashes, such abbreviations make those packages also less discoverable using the normal auto-completion features C-h f/v. Bye, Tassilo