procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Minor formatting tweak in the Emacs manual

Browse source 
* doc/emacs/custom.texi (Directory Variables): Don't have 2
footnotes back to back, it looks bad in HTML.  (Bug#31555)
This commit is contained in:
Eli Zaretskii 2018-05-22 20:27:28 +03:00
parent fadf6535c0
commit c0f3e6b56b
1 changed files with 12 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

22
doc/emacs/custom.texi
View file

@ -1313,16 +1313,13 @@ accomplished with @dfn{directory-local variables}.
@cindex @file{.dir-locals.el} file @cindex @file{.dir-locals.el} file
The usual way to define directory-local variables is to put a file The usual way to define directory-local variables is to put a file
named @file{.dir-locals.el}@footnote{ On MS-DOS, the name of this file named @file{.dir-locals.el}@footnote{
should be @file{_dir-locals.el}, due to limitations of the DOS On MS-DOS, the name of this file should be @file{_dir-locals.el}, due
filesystems. If the filesystem is limited to 8+3 file names, the name to limitations of the DOS filesystems. If the filesystem is limited
of the file will be truncated by the OS to @file{_dir-loc.el}. to 8+3 file names, the name of the file will be truncated by the OS to
}@footnote{ You can also use @file{.dir-locals-2.el}, which @file{_dir-loc.el}.
is loaded in addition. This is useful when @file{.dir-locals.el} is }in a directory. Whenever Emacs visits any file in that directory or
under version control in a shared repository and can't be used for any of its subdirectories, it will apply the directory-local variables
personal customizations. } in a
directory. Whenever Emacs visits any file in that directory or any of
its subdirectories, it will apply the directory-local variables
specified in @file{.dir-locals.el}, as though they had been defined as specified in @file{.dir-locals.el}, as though they had been defined as
file-local variables for that file (@pxref{File Variables}). Emacs file-local variables for that file (@pxref{File Variables}). Emacs
searches for @file{.dir-locals.el} starting in the directory of the searches for @file{.dir-locals.el} starting in the directory of the
@ -1331,6 +1328,11 @@ this search is skipped for remote files. If needed, the search can be
extended for remote files by setting the variable extended for remote files by setting the variable
@code{enable-remote-dir-locals} to @code{t}. @code{enable-remote-dir-locals} to @code{t}.
You can also use @file{.dir-locals-2.el}; if found, Emacs loads it
in addition to @file{.dir-locals.el}. This is useful when
@file{.dir-locals.el} is under version control in a shared repository
and can't be used for personal customizations.
The @file{.dir-locals.el} file should hold a specially-constructed The @file{.dir-locals.el} file should hold a specially-constructed
list, which maps major mode names (symbols) to alists list, which maps major mode names (symbols) to alists
(@pxref{Association Lists,,, elisp, The Emacs Lisp Reference Manual}). (@pxref{Association Lists,,, elisp, The Emacs Lisp Reference Manual}).