emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

UTF-8 characters in commit messages (was: [PATCH] ; Simplify (with-curr


From: Tim Landscheidt
Subject: UTF-8 characters in commit messages (was: [PATCH] ; Simplify (with-current-buffer (get-buffer …) …))
Date: Fri, 15 Mar 2024 09:16:34 +0000
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/28.3 (gnu/linux)

Eli Zaretskii <eliz@gnu.org> wrote:

> […]

> For the future, please avoid using non-ASCII characters in commit log
> messages.

I had only looked at CONTRIBUTE's:

| - Commit messages should contain only printable UTF-8 characters.

Further down, the test commit-msg performs is described as:

| - commit log message should include only valid printable ASCII and
|   UTF-8 characters;

The GNU Coding Standards are a bit more explicit about this:

| Sticking to the ASCII character set (plain text, 7-bit
| characters) is preferred in GNU source code comments, text
| documents, and other contexts, unless there is good reason
| to do something else because of the application domain.  For
| example, if source code deals with the French Revolutionary
| calendar, it is OK if its literal strings contain accented
| characters in month names like “Floréal”.  Also, it is OK
| (but not required) to use non-ASCII characters to represent
| proper names of contributors in change logs (see Change
| Logs).

Perhaps the first line quoted above could be rephrased à la:

| - Commit messages should contain only valid printable ASCII
|   characters.  If necessary, they may contain printable
|   UTF-8 characters.

Tim



reply via email to

[Prev in Thread] Current Thread [Next in Thread]