lisp/editorconfig: Minor cosmetic fixes

This commit is contained in:
Stefan Kangas 2024-06-18 21:17:21 +02:00 committed by Stefan Monnier
parent 57b2439cb5
commit 0f4fe99a38
3 changed files with 21 additions and 21 deletions

View file

@ -1,10 +1,10 @@
@dircategory Emacs
@direntry
* EditorConfig: (editorconfig). EditorConfig Emacs Plugin.
* EditorConfig: (editorconfig). EditorConfig Plugin.
@end direntry
@node Top
@chapter EditorConfig Emacs Plugin
@chapter EditorConfig Plugin
@anchor{#editorconfig-emacs-plugin}
This is an @uref{https://editorconfig.org,EditorConfig} plugin for
@uref{https://www.gnu.org/software/emacs/,Emacs}.
@ -23,18 +23,19 @@ This is an @uref{https://editorconfig.org,EditorConfig} plugin for
@anchor{#getting-started}
@menu
* packageel::
* package::
* use-package::
* Manual installation::
@end menu
@node packageel
@node package
@subsection package.el
@anchor{#package.el}
This package is available from
@uref{https://melpa.org/#/editorconfig,MELPA},
@uref{https://stable.melpa.org/#/editorconfig,MELPA Stable} and
This package is shipped with Emacs. More recent versions can be
installed from
@uref{http://elpa.nongnu.org/nongnu/editorconfig.html,NonGNU ELPA}.
Install from these repositories and enable global minor-mode
@code{editorconfig-mode}:
@ -43,7 +44,7 @@ Install from these repositories and enable global minor-mode
@end verbatim
Normally, enabling @code{editorconfig-mode} should be enough for this
plugin to work: all other configurations are optional. This mode sets up
plugin to work: all other configurations are optional. This mode sets up
hooks so that EditorConfig properties will be loaded and applied to the
new buffers automatically when visiting files.
@ -129,7 +130,7 @@ show up on our radar.
@subsection File Type (file_type_ext, file_type_emacs)
@anchor{#file-type-file_type_ext-file_type_emacs}
File-type feature is currently disabled, because this package is now
undergoing big internal refactoring. For those who want this
undergoing big internal refactoring. For those who want this
functionality, please consider using
@uref{https://github.com/10sr/editorconfig-custom-majormode-el,editorconfig-custom-majormode}.
@ -159,7 +160,7 @@ function.
One possible value is
@uref{https://github.com/lewang/ws-butler,@code{ws-butler-mode}}, with
which only lines touched get trimmed. To use it, add following to your
which only lines touched get trimmed. To use it, add following to your
init.el:
@verbatim
@ -215,7 +216,7 @@ recommend first trying
@code{M-x editorconfig-display-current-properties}.
This command will open a new buffer and display the EditorConfig
properties loaded for current buffer. You can check if EditorConfig
properties loaded for current buffer. You can check if EditorConfig
properties were not read for buffers at all, or they were loaded but did
not take effect for some other reasons.
@ -232,8 +233,8 @@ plugin requires explicit support for each major-mode for
@code{indent_size} property.
By default this plugin ships with settings for many major-modes, but,
sorry to say, it cannot be perfect. Especially it is difficult to
support brand-new major-modes. Please feel free to submit issue or
sorry to say, it cannot be perfect. Especially it is difficult to
support brand-new major-modes. Please feel free to submit issue or
pull-request for such major-mode!
Supported major-modes and their indentation configs are defined in the
@ -243,13 +244,13 @@ variable @code{editorconfig-indentation-alist}.
@subsection Not work at all for FOO-mode!
@anchor{#not-work-at-all-for-foo-mode}
Most cases properties are loaded just after visiting files when
@code{editorconfig-mode} is enabled. But it is known that there are
@code{editorconfig-mode} is enabled. But it is known that there are
major-modes that this mechanism does not work for and require explicit
call of @code{editorconfig-apply}.
Typically it will occur when the major-mode is not defined using
@code{define-derived-mode} (@code{rpm-spec-mode} is an example for
this). Please feel free to submit issues if you find such modes!
this). Please feel free to submit issues if you find such modes!
@node Submitting Bugs and Feature Requests
@section Submitting Bugs and Feature Requests
@ -288,10 +289,10 @@ License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.
You should have received a copy of the GNU General Public License along
with this program. If not, see @url{https://www.gnu.org/licenses/}.
with this program. If not, see @url{https://www.gnu.org/licenses/}.
@bye

View file

@ -74,8 +74,7 @@ Slots:
Last modified time of .editorconfig file.
`path'
Absolute path to .editorconfig file.'
"
Absolute path to .editorconfig file."
(top-props nil)
(sections nil)
(mtime nil)

View file

@ -1,4 +1,4 @@
;;; editorconfig.el --- EditorConfig Emacs Plugin -*- lexical-binding: t -*-
;;; editorconfig.el --- EditorConfig Plugin -*- lexical-binding: t -*-
;; Copyright (C) 2011-2024 Free Software Foundation, Inc.
@ -182,7 +182,7 @@ This hook will be run even when there are no matching sections in
(web-mode . editorconfig--get-indentation-web-mode)
(zig-mode zig-indent-offset)
)
"Alist of indentation setting methods by modes
"Alist of indentation setting methods by modes.
This is a fallback used for those modes which don't set
`editorconfig-indent-size-vars'.