mirror of
git://git.sv.gnu.org/emacs.git
synced 2025-12-05 22:20:24 -08:00
72b1379f07
Monitors are wider now than when these defaults were first set, and it is useful to take better advantage of that, to fit text on fewer lines. Yet, it has repeatedly been shown that overly long lines reduce readability: "A reasonable guideline would be 55 to 75 characters per line."[1] We also don't want to disfavor narrow displays, like mobile phones; a more promising direction here might be to automatically word wrap docstrings and make their maximum width customizable. That might require a new docstring format, however. Bumping it by 7 characters, from 65 to 72, seems a reasonable compromise for now. Consideration was given to increasing it to 70 or 75, but 72 happens to be a commonly recommended maximum line width elsewhere (see Fortran 66, Python docstrings, commit message recommendations, etc.), and we might as well do the same. This change was discussed in: https://lists.gnu.org/r/emacs-devel/2022-07/msg00217.html [1] "Optimal Line Length in Reading — A Literature Review", Nanavati and Bias, Visible Language, Vol. 39 No. 2 (2005). https://journals.uc.edu/index.php/vl/article/view/5765 * lisp/emacs-lisp/lisp-mode.el (emacs-lisp-docstring-fill-column): * .dir-locals.el (fill-column, emacs-lisp-docstring-fill-column): Bump default to 72.
48 lines
2.2 KiB
EmacsLisp
48 lines
2.2 KiB
EmacsLisp
;;; Directory Local Variables -*- no-byte-compile: t; -*-
|
|
;;; For more information see (info "(emacs) Directory Variables")
|
|
|
|
((nil . ((tab-width . 8)
|
|
(sentence-end-double-space . t)
|
|
(fill-column . 72)
|
|
(emacs-lisp-docstring-fill-column . 72)
|
|
(vc-git-annotate-switches . "-w")
|
|
(bug-reference-url-format . "https://debbugs.gnu.org/%s")
|
|
(diff-add-log-use-relative-names . t)
|
|
(etags-regen-regexp-alist
|
|
.
|
|
((("c" "objc") .
|
|
("/[ \t]*DEFVAR_[A-Z_ \t(]+\"\\([^\"]+\\)\"/\\1/"
|
|
"/[ \t]*DEFVAR_[A-Z_ \t(]+\"[^\"]+\",[ \t]\\([A-Za-z0-9_]+\\)/\\1/"))))
|
|
(etags-regen-ignores . ("test/manual/etags/"))
|
|
(vc-prepare-patches-separately . nil)))
|
|
(c-mode . ((c-file-style . "GNU")
|
|
(c-noise-macro-names . ("INLINE" "NO_INLINE" "ATTRIBUTE_NO_SANITIZE_UNDEFINED"
|
|
"UNINIT" "CALLBACK" "ALIGN_STACK" "ATTRIBUTE_MALLOC"
|
|
"ATTRIBUTE_DEALLOC_FREE" "ANDROID_EXPORT" "TEST_STATIC"))
|
|
(electric-quote-comment . nil)
|
|
(electric-quote-string . nil)
|
|
(indent-tabs-mode . t)
|
|
(mode . bug-reference-prog)))
|
|
(objc-mode . ((c-file-style . "GNU")
|
|
(electric-quote-comment . nil)
|
|
(electric-quote-string . nil)
|
|
(mode . bug-reference-prog)))
|
|
(c-ts-mode . ((c-ts-mode-indent-style . gnu)
|
|
(indent-tabs-mode . t)
|
|
(mode . bug-reference-prog)))
|
|
(log-edit-mode . ((log-edit-font-lock-gnu-style . t)
|
|
(log-edit-setup-add-author . t)
|
|
(vc-git-log-edit-summary-target-len . 50)))
|
|
(change-log-mode . ((add-log-time-zone-rule . t)
|
|
(fill-column . 74)
|
|
(mode . bug-reference)))
|
|
(diff-mode . ((mode . whitespace)))
|
|
(emacs-lisp-mode . ((indent-tabs-mode . nil)
|
|
(electric-quote-comment . nil)
|
|
(electric-quote-string . nil)
|
|
(mode . bug-reference-prog)))
|
|
(lisp-data-mode . ((indent-tabs-mode . nil)))
|
|
(texinfo-mode . ((electric-quote-comment . nil)
|
|
(electric-quote-string . nil)
|
|
(mode . bug-reference-prog)))
|
|
(outline-mode . ((mode . bug-reference))))
|