[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Naming internal functions
From: |
Christopher Schmidt |
Subject: |
Re: Naming internal functions |
Date: |
Mon, 15 Apr 2013 14:46:26 +0100 (BST) |
Stefan Monnier <address@hidden> writes:
>> 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.
>
> Sounds good, tho a suggested patch would be welcome.
--- doc/lispref/tips.texi
+++ doc/lispref/tips.texi
@@ -54,9 +54,10 @@
Lisp programs. The names of all global variables, constants, and
functions in your program should begin with that chosen prefix.
Separate the prefix from the rest of the name with a hyphen, @samp{-}.
-This practice helps avoid name conflicts, since all global variables
-in Emacs Lisp share the same name space, and all functions share
-another name address@hidden benefits of a Common Lisp-style
+Use two hyphens if the object is not meant to be used by other
+packages. This practice helps avoid name conflicts, since all global
+variables in Emacs Lisp share the same name space, and all functions
+share another name address@hidden benefits of a Common Lisp-style
package system are considered not to outweigh the costs.}.
Occasionally, for a command name intended for users to use, it is more
--- etc/NEWS
+++ etc/NEWS
@@ -409,6 +409,12 @@
`preserve-extended-attributes' as it now handles both SELinux context
and ACL entries.
+** Changes to the Emacs Lisp Coding Conventions in Emacs 24.4
+
+*** The package descriptor and name of global variables, constants,
+and functions should be separated by two hypens if the object is not
+meant to be used by other packages.
+
* Changes in Emacs 24.4 on Non-Free Operating Systems
Christopher
- Re: Modern Conventions for Emacs Lisp files?, (continued)
- Re: Modern Conventions for Emacs Lisp files?, Thorsten Jolitz, 2013/04/15
- Re: Modern Conventions for Emacs Lisp files?, Eli Zaretskii, 2013/04/15
- Re: Modern Conventions for Emacs Lisp files?, Thorsten Jolitz, 2013/04/15
- Re: Modern Conventions for Emacs Lisp files?, Stefan Monnier, 2013/04/15
- Re: Modern Conventions for Emacs Lisp files?, Bastien, 2013/04/15
- Naming internal functions (was: Modern Conventions for Emacs Lisp files?), Christopher Schmidt, 2013/04/08
- Re: Naming internal functions, Stefan Monnier, 2013/04/08
- Re: Naming internal functions,
Christopher Schmidt <=
- Re: Naming internal functions, Eli Zaretskii, 2013/04/15
- Re: Naming internal functions, Christopher Schmidt, 2013/04/15
- Re: Naming internal functions, Eli Zaretskii, 2013/04/15
- Re: Naming internal functions, Christopher Schmidt, 2013/04/15
- Re: Naming internal functions, xfq, 2013/04/15
Re: Modern Conventions for Emacs Lisp files?, Pascal J. Bourguignon, 2013/04/08