summaryrefslogtreecommitdiff
path: root/CONTRIBUTE
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2015-09-27 11:30:35 +0300
committerEli Zaretskii <eliz@gnu.org>2015-09-27 11:30:35 +0300
commitf49e3a2603f249bb2ec281f3eaedd80cbaef2243 (patch)
tree18f664d7e58cfff0d6fcae3f672a0320ab55dd4a /CONTRIBUTE
parent1ac5a9c20cb22efb398fa18781c6b932dd4e54df (diff)
downloademacs-f49e3a2603f249bb2ec281f3eaedd80cbaef2243.tar.gz
; Mention non-ASCII encoding issues in CONTRIBUTE
* CONTRIBUTE: Document recommendations for encoding non-ASCII characters in Emacs sources.
Diffstat (limited to 'CONTRIBUTE')
-rw-r--r--CONTRIBUTE14
1 files changed, 14 insertions, 0 deletions
diff --git a/CONTRIBUTE b/CONTRIBUTE
index 609ab7acb6b..098579e11af 100644
--- a/CONTRIBUTE
+++ b/CONTRIBUTE
@@ -201,6 +201,20 @@ then exclude that commit from the merge to trunk.
** Other process information
+*** Non-ASCII characters in Emacs files
+
+If you introduce non-ASCII characters into Emacs source files, it is a
+good idea to add a 'coding' cookie to the file to state its encoding.
+Please use the UTF-8 encoding unless it cannot do the job for some
+good reason. As of Emacs 24.4, it is no longer necessary to have
+explicit 'coding' cookies in *.el files if they are encoded in UTF-8,
+but other files need them even if encoded in UTF-8. And even for *.el
+files, having an explicit encoding specification facilitates correct
+display of non-ASCII characters when the file is visited in older
+Emacs versions.
+
+*** Useful files in the admin/ directory
+
See all the files in admin/notes/* . In particular, see
admin/notes/newfile, see admin/notes/repo.