From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Christopher Schmidt Newsgroups: gmane.emacs.devel Subject: Naming internal functions (was: Modern Conventions for Emacs Lisp files?) Date: Mon, 8 Apr 2013 21:55:18 +0100 (BST) Message-ID: <87zjx8ivyb.fsf_-_@earth.home> References: <87hajhswdh.fsf@gmail.com> <87y5csu7ml.fsf@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1365454528 5764 80.91.229.3 (8 Apr 2013 20:55:28 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 8 Apr 2013 20:55:28 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Apr 08 22:55:31 2013 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 1UPJ69-0003tL-Q5 for ged-emacs-devel@m.gmane.org; Mon, 08 Apr 2013 22:55:29 +0200 Original-Received: from localhost ([::1]:55211 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UPJ69-0000e5-Fj for ged-emacs-devel@m.gmane.org; Mon, 08 Apr 2013 16:55:29 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:38979) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UPJ63-0000Xh-Qt for emacs-devel@gnu.org; Mon, 08 Apr 2013 16:55:26 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UPJ61-0008PT-39 for emacs-devel@gnu.org; Mon, 08 Apr 2013 16:55:23 -0400 Original-Received: from ristopher.com ([146.185.21.93]:38766 helo=saturn.ch.ristopher.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UPJ60-0008PD-Jp for emacs-devel@gnu.org; Mon, 08 Apr 2013 16:55:20 -0400 Original-Received: by saturn.ch.ristopher.com (Postfix, from userid 0) id 7D4D520E13; Mon, 8 Apr 2013 21:55:18 +0100 (BST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=ch.ristopher.com; s=mail; t=1365454518; bh=uUYMy+I2kMwy3hNb2ZIR8QTUVMLnph6J+NIVBXqdaDs=; h=From:To:Subject:In-Reply-To:Message-ID:References:MIME-Version: Content-Type:Date; b=Ta2/qbJuzI798uz6iSe+xGgYbJQo7Vmkmw4bVsur7ZvKYynjI8CHT1MJVshR2b8Tp tYK2eDsdP/VnKWNGDx7tGWi6MrbVxpdz3yAxpcC3OePtZXy40iPqcP1RT2o6jxXFvW rcpzzCKmT1dSyx1pJGqcBhdzI2CpPHb5i6jIE6u8= In-Reply-To: (Stefan Monnier's message of "Mon, 08 Apr 2013 16:07:54 -0400") Mail-Followup-To: emacs-devel@gnu.org X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x X-Received-From: 146.185.21.93 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:158783 Archived-At: Stefan Monnier writes: > I'd be happy to refine/extend/tweak the existing conventions, but > switching to different ones would be a lot more problematic. I would like to propose a tweak to the prefix convention. (info "(elisp)Coding Conventions") Let's separate package and name of internal functions or variables with two consecutive dashes. There are some packages which implement that already, such as epg or cl. In my opinion, this makes understanding code a lot easier and one does know instantly whether a function or variable is safe for use by external packages. Christopher