[Emacs-diffs] /srv/bzr/emacs/trunk r112297: * etc/NEWS, doc/lispref/tips.texi (Coding Conventions): Mention

[Christopher Schmidt]

------------------------------------------------------------
revno: 112297
committer: Christopher Schmidt <address@hidden>
branch nick: emacs-trunk
timestamp: Mon 2013-04-15 19:01:00 +0200
message:
  * etc/NEWS, doc/lispref/tips.texi (Coding Conventions): Mention
  separation of package descriptor and name of internal symbols by
  two hyphens.
modified:
  doc/lispref/ChangeLog
  doc/lispref/tips.texi
  etc/ChangeLog
  etc/NEWS

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2013-04-13 14:37:20 +0000
+++ b/doc/lispref/ChangeLog     2013-04-15 17:01:00 +0000
@@ -1,3 +1,8 @@
+2013-04-15  Christopher Schmidt  <address@hidden>
+
+       * tips.texi (Coding Conventions): Mention separation of package
+       descriptor and name of internal symbols by two hyphens.
+
 2013-04-13  Stephen Berman  <address@hidden>
 
        * windows.texi (Splitting Windows): Change category of

=== modified file 'doc/lispref/tips.texi'
--- a/doc/lispref/tips.texi     2013-01-02 16:13:04 +0000
+++ b/doc/lispref/tips.texi     2013-04-15 17:01:00 +0000
@@ -51,13 +51,15 @@
 
 @item
 You should choose a short word to distinguish your program from other
-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
-package system are considered not to outweigh the costs.}.
+Lisp programs.  The names of all global symbols in your program, that
+is the names of variables, constants, and functions, should begin with
+that chosen prefix.  Separate the prefix from the rest of the name
+with a hyphen, @samp{-}.  Use two hyphens if the symbol 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
 convenient if some words come before the package's name prefix.  And

=== modified file 'etc/ChangeLog'
--- a/etc/ChangeLog     2013-04-13 14:37:20 +0000
+++ b/etc/ChangeLog     2013-04-15 17:01:00 +0000
@@ -1,3 +1,8 @@
+2013-04-15  Christopher Schmidt  <address@hidden>
+
+       * NEWS: Mention separation of package descriptor and name of
+       internal symbols by two hyphens.
+
 2013-04-13  Stephen Berman  <address@hidden>
 
        * NEWS: Mention fixing `split-window' to be non-interactive.

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2013-04-13 14:37:20 +0000
+++ b/etc/NEWS  2013-04-15 17:01:00 +0000
@@ -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 symbol is not
+meant to be used by other packages.
+
 
 * Changes in Emacs 24.4 on Non-Free Operating Systems