[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/bind-key 1938f50e74 5/9: Use two spaces to end sentence
From: |
ELPA Syncer |
Subject: |
[elpa] externals/bind-key 1938f50e74 5/9: Use two spaces to end sentences |
Date: |
Tue, 15 Nov 2022 11:57:20 -0500 (EST) |
branch: externals/bind-key
commit 1938f50e74a8c8ab1fc968ebfa087da1730ff3cb
Author: Stefan Kangas <stefankangas@gmail.com>
Commit: Stefan Kangas <stefankangas@gmail.com>
Use two spaces to end sentences
---
use-package.texi | 82 ++++++++++++++++++++++++++++----------------------------
1 file changed, 41 insertions(+), 41 deletions(-)
diff --git a/use-package.texi b/use-package.texi
index a5f850c875..fc504305b4 100644
--- a/use-package.texi
+++ b/use-package.texi
@@ -45,9 +45,9 @@ General Public License for more details.
@top use-package User Manual
The @code{use-package} macro allows you to isolate package configuration in
your
-@code{.emacs} file in a way that is both performance-oriented and, well, tidy.
I
+@code{.emacs} file in a way that is both performance-oriented and, well, tidy.
I
created it because I have over 80 packages that I use in Emacs, and things
-were getting difficult to manage. Yet with this utility my total load time is
+were getting difficult to manage. Yet with this utility my total load time is
around 2 seconds, with no loss of functionality!
@insertcopying
@@ -105,9 +105,9 @@ Keywords
@chapter Introduction
The @code{use-package} macro allows you to isolate package configuration in
your
-@code{.emacs} file in a way that is both performance-oriented and, well, tidy.
I
+@code{.emacs} file in a way that is both performance-oriented and, well, tidy.
I
created it because I have over 80 packages that I use in Emacs, and things
-were getting difficult to manage. Yet with this utility my total load time is
+were getting difficult to manage. Yet with this utility my total load time is
around 2 seconds, with no loss of functionality!
More text to come@dots{}
@@ -127,10 +127,10 @@ its development repository.
@node Installing from an Elpa Archive
@section Installing from an Elpa Archive
-use-package is available from Melpa and Melpa-Stable. If you haven't used
+use-package is available from Melpa and Melpa-Stable. If you haven't used
Emacs' package manager before, then it is high time you familiarize yourself
with it by reading the documentation in the Emacs manual, see
-@ref{Packages,,,emacs,}. Then add one of the archives to
@code{package-archives}:
+@ref{Packages,,,emacs,}. Then add one of the archives to
@code{package-archives}:
@itemize
@item
@@ -229,7 +229,7 @@ Now see @ref{Post-Installation Tasks}.
@section Post-Installation Tasks
After installing use-package you should verify that you are indeed using the
-use-package release you think you are using. It's best to restart Emacs before
+use-package release you think you are using. It's best to restart Emacs before
doing so, to make sure you are not using an outdated value for
@code{load-path}.
@example
@@ -249,13 +249,13 @@ If you run into problems, then please see the
@ref{Debugging Tools}.
@node Getting Started
@chapter Getting Started
-TODO@. For now, see @code{README.md}.
+TODO@. For now, see @code{README.md}.
@node Basic Concepts
@chapter Basic Concepts
@code{use-package} was created for few basic reasons, each of which drove the
-design in various ways. Understanding these reasons may help make some of
+design in various ways. Understanding these reasons may help make some of
those decisions clearer:
@itemize
@@ -279,7 +279,7 @@ close to a functional Emacs as possible.
@item
To allow byte-compilation of one's init file so that any warnings or
-errors seen are meaningful. In this way, even if byte-compilation is not
+errors seen are meaningful. In this way, even if byte-compilation is not
used for speed (reason 3), it can still be used as a sanity check.
@end itemize
@@ -316,8 +316,8 @@ used for speed (reason 3), it can still be used as a sanity
check.
Sometimes it only makes sense to configure a package after another has been
loaded, because certain variables or functions are not in scope until that
-time. This can achieved using an @code{:after} keyword that allows a fairly
rich
-description of the exact conditions when loading should occur. Here is an
+time. This can achieved using an @code{:after} keyword that allows a fairly
rich
+description of the exact conditions when loading should occur. Here is an
example:
@lisp
@@ -332,13 +332,13 @@ example:
@end lisp
In this case, because all of these packages are demand-loaded in the order
-they occur, the use of @code{:after} is not strictly necessary. By using it,
+they occur, the use of @code{:after} is not strictly necessary. By using it,
however, the above code becomes order-independent, without an implicit
depedence on the nature of your init file.
By default, @code{:after (foo bar)} is the same as @code{:after (:all foo
bar)}, meaning
that loading of the given package will not happen until both @code{foo} and
@code{bar}
-have been loaded. Here are some of the other possibilities:
+have been loaded. Here are some of the other possibilities:
@lisp
:after (foo bar)
@@ -354,7 +354,7 @@ been loaded, or both @code{baz} and @code{quux} have been
loaded.
@strong{NOTE}: Pay attention if you set @code{use-package-always-defer} to t,
and also use
the @code{:after} keyword, as you will need to specify how the declared
package is
-to be loaded: e.g., by some @code{:bind}. If you're not using one of the
mechanisms
+to be loaded: e.g., by some @code{:bind}. If you're not using one of the
mechanisms
that registers autoloads, such as @code{:bind} or @code{:hook}, and your
package manager
does not provide autoloads, it's possible that without adding @code{:demand t}
to
those declarations, your package will never be loaded.
@@ -363,14 +363,14 @@ those declarations, your package will never be loaded.
@section @code{:bind-keymap}, @code{:bind-keymap*}
Normally @code{:bind} expects that commands are functions that will be
autoloaded
-from the given package. However, this does not work if one of those commands
+from the given package. However, this does not work if one of those commands
is actually a keymap, since keymaps are not functions, and cannot be
autoloaded using Emacs' @code{autoload} mechanism.
To handle this case, @code{use-package} offers a special, limited variant of
-@code{:bind} called @code{:bind-keymap}. The only difference is that the
"commands"
+@code{:bind} called @code{:bind-keymap}. The only difference is that the
"commands"
bound to by @code{:bind-keymap} must be keymaps defined in the package, rather
than
-command functions. This is handled behind the scenes by generating custom code
+command functions. This is handled behind the scenes by generating custom code
that loads the package containing the keymap, and then re-executes your
keypress after the first load, to reinterpret that keypress as a prefix key.
@@ -409,7 +409,7 @@ A more literal way to do the exact same thing is:
@end lisp
When you use the @code{:commands} keyword, it creates autoloads for those
commands
-and defers loading of the module until they are used. Since the @code{:init}
form
+and defers loading of the module until they are used. Since the @code{:init}
form
is always run---even if @code{ace-jump-mode} might not be on your
system---remember
to restrict @code{:init} code to only what would succeed either way.
@@ -425,7 +425,7 @@ The @code{:bind} keyword takes either a cons or a list of
conses:
The @code{:commands} keyword likewise takes either a symbol or a list of
symbols.
NOTE: Special keys like @code{tab} or @code{F1}-@code{Fn} can be written in
square brackets,
-i.e. @code{[tab]} instead of @code{"tab"}. The syntax for the keybindings is
similar to
+i.e. @code{[tab]} instead of @code{"tab"}. The syntax for the keybindings is
similar to
the "kbd" syntax: see
@uref{https://www.gnu.org/software/emacs/manual/html_node/emacs/Init-Rebinding.html,
the Emacs Manual} for more information.
Examples:
@@ -459,7 +459,7 @@ The effect of this statement is to wait until @code{helm}
has loaded, and then t
bind the key @code{C-c h} to @code{helm-execute-persistent-action} within
Helm's local
keymap, @code{helm-mode-map}.
-Multiple uses of @code{:map} may be specified. Any binding occurring before the
+Multiple uses of @code{:map} may be specified. Any binding occurring before
the
first use of @code{:map} are applied to the global keymap:
@lisp
@@ -493,7 +493,7 @@ Here is the simplest @code{use-package} declaration:
@end lisp
This loads in the package @code{foo}, but only if @code{foo} is available on
your
-system. If not, a warning is logged to the @code{*Messages*} buffer. If it
+system. If not, a warning is logged to the @code{*Messages*} buffer. If it
succeeds, a message about @code{"Loading foo"} is logged, along with the time
it
took to load, if it took over 0.1 seconds.
@@ -567,14 +567,14 @@ The @code{:custom-face} keyword allows customization of
package custom faces.
@node @code{defer} @code{demand}
@section @code{:defer}, @code{:demand}
-In almost all cases you don't need to manually specify @code{:defer t}. This is
-implied whenever @code{:bind} or @code{:mode} or @code{:interpreter} is used.
Typically, you
+In almost all cases you don't need to manually specify @code{:defer t}. This
is
+implied whenever @code{:bind} or @code{:mode} or @code{:interpreter} is used.
Typically, you
only need to specify @code{:defer} if you know for a fact that some other
package
will do something to cause your package to load at the appropriate time, and
thus you would like to defer loading even though use-package isn't creating
any autoloads for you.
-You can override package deferral with the @code{:demand} keyword. Thus, even
if
+You can override package deferral with the @code{:demand} keyword. Thus, even
if
you use @code{:bind}, using @code{:demand} will force loading to occur
immediately and
not establish an autoload for the bound key.
@@ -616,7 +616,7 @@ If you need to silence a missing function warning, you can
use @code{:functions}
@section @code{:diminish}, @code{:delight}
@code{use-package} also provides built-in support for the diminish and delight
-utilities---if you have them installed. Their purpose is to remove or change
+utilities---if you have them installed. Their purpose is to remove or change
minor mode strings in your mode-line.
@uref{https://github.com/myrjola/diminish.el, diminish} is invoked with the
@code{:diminish} keyword, which is passed either a
@@ -635,7 +635,7 @@ package name with "-mode" appended at the end:
@uref{https://elpa.gnu.org/packages/delight.html, delight} is invoked with the
@code{:delight} keyword, which is passed a minor mode
symbol, a replacement string or quoted
@uref{https://www.gnu.org/software/emacs/manual/html_node/elisp/Mode-Line-Data.html,
mode-line data} (in which case the minor
mode symbol is guessed to be the package name with "-mode" appended at the
-end), both of these, or several lists of both. If no arguments are provided,
+end), both of these, or several lists of both. If no arguments are provided,
the default mode name is hidden completely.
@lisp
@@ -677,7 +677,7 @@ from the output entirely, to accelerate startup times.
@node @code{ensure} @code{pin}
@section @code{:ensure}, @code{:pin}
-You can use @code{use-package} to load packages from ELPA with
@code{package.el}. This
+You can use @code{use-package} to load packages from ELPA with
@code{package.el}. This
is particularly useful if you share your @code{.emacs} among several machines;
the
relevant packages are downloaded automatically once declared in your
@code{.emacs}.
The @code{:ensure} keyword causes the package(s) to be installed automatically
if
@@ -707,7 +707,7 @@ archives is also a valid use-case.
By default @code{package.el} prefers @code{melpa} over @code{melpa-stable} due
to the
versioning @code{(> evil-20141208.623 evil-1.0.9)}, so even if you are tracking
only a single package from @code{melpa}, you will need to tag all the
non-@code{melpa}
-packages with the appropriate archive. If this really annoys you, then you can
+packages with the appropriate archive. If this really annoys you, then you can
set @code{use-package-always-pin} to set a default.
If you want to manually keep a package updated and ignore upstream updates,
@@ -752,7 +752,7 @@ Example:
@section @code{:hook}
The @code{:hook} keyword allows adding functions onto hooks, here only the
basename
-of the hook is required. Thus, all of the following are equivalent:
+of the hook is required. Thus, all of the following are equivalent:
@lisp
(use-package ace-jump-mode
@@ -827,8 +827,8 @@ the same thing as @code{:if (not foo)}.
@section @code{:load-path}
If your package needs a directory added to the @code{load-path} in order to
load,
-use @code{:load-path}. This takes a symbol, a function, a string or a list of
-strings. If the path is relative, it is expanded within
+use @code{:load-path}. This takes a symbol, a function, a string or a list of
+strings. If the path is relative, it is expanded within
@code{user-emacs-directory}:
@lisp
@@ -839,8 +839,8 @@ strings. If the path is relative, it is expanded within
Note that when using a symbol or a function to provide a dynamically generated
list of paths, you must inform the byte-compiler of this definition so the
-value is available at byte-compilation time. This is done by using the special
-form @code{eval-and-compile} (as opposed to @code{eval-when-compile}).
Further, this
+value is available at byte-compilation time. This is done by using the special
+form @code{eval-and-compile} (as opposed to @code{eval-when-compile}).
Further, this
value is fixed at whatever was determined during compilation, to avoid looking
up the same information again on each startup:
@@ -859,7 +859,7 @@ up the same information again on each startup:
Similar to @code{:bind}, you can use @code{:mode} and @code{:interpreter} to
establish a
deferred binding within the @code{auto-mode-alist} and
@code{interpreter-mode-alist}
-variables. The specifier to either keyword can be a cons cell, a list of cons
+variables. The specifier to either keyword can be a cons cell, a list of cons
cells, or a string or regexp:
@lisp
@@ -898,8 +898,8 @@ This does exactly the same thing as the following:
Similar to @code{:mode} and @code{:interpreter}, you can also use
@code{:magic} and
@code{:magic-fallback} to cause certain function to be run if the beginning of
a
-file matches a given regular expression. The difference between the two is
-that @code{:magic-fallback} has a lower priority than @code{:mode}. For
example:
+file matches a given regular expression. The difference between the two is
+that @code{:magic-fallback} has a lower priority than @code{:mode}. For
example:
@lisp
(use-package pdf-tools
@@ -918,9 +918,9 @@ string @code{"%PDF"}.
Normally, @code{use-package} will load each package at compile time before
compiling the configuration, to ensure that any necessary symbols are in scope
-to satisfy the byte-compiler. At times this can cause problems, since a
+to satisfy the byte-compiler. At times this can cause problems, since a
package may have special loading requirements, and all that you want to use
-@code{use-package} for is to add a configuration to the @code{eval-after-load}
hook. In
+@code{use-package} for is to add a configuration to the @code{eval-after-load}
hook. In
such cases, use the @code{:no-require} keyword:
@lisp
@@ -936,8 +936,8 @@ such cases, use the @code{:no-require} keyword:
While the @code{:after} keyword delays loading until the dependencies are
loaded,
the somewhat simpler @code{:requires} keyword simply never loads the package
if the
dependencies are not available at the time the @code{use-package} declaration
is
-encountered. By "available" in this context it means that @code{foo} is
available
-of @code{(featurep 'foo)} evaluates to a non-nil value. For example:
+encountered. By "available" in this context it means that @code{foo} is
available
+of @code{(featurep 'foo)} evaluates to a non-nil value. For example:
@lisp
(use-package abbrev
- [elpa] externals/bind-key updated (87c03dffc7 -> 21a126cb7e), ELPA Syncer, 2022/11/15
- [elpa] externals/bind-key 8354533d36 2/9: Delete use-package.org, ELPA Syncer, 2022/11/15
- [elpa] externals/bind-key 8bdfe31fbb 7/9: Merge pull request #1017 from skangas/gnu-elpa, ELPA Syncer, 2022/11/15
- [elpa] externals/bind-key 2a7da686bc 1/9: manual: Regenerate texi file, ELPA Syncer, 2022/11/15
- [elpa] externals/bind-key 7126fb73f9 4/9: Move incorrectly placed example in README, ELPA Syncer, 2022/11/15
- [elpa] externals/bind-key 2f7544a081 6/9: Fix makeinfo warnings, ELPA Syncer, 2022/11/15
- [elpa] externals/bind-key 77e04dc55b 3/9: Recommend GNU ELPA over MELPA, ELPA Syncer, 2022/11/15
- [elpa] externals/bind-key b8f0537840 8/9: Merge branch 'master' into texinfo-wip, ELPA Syncer, 2022/11/15
- [elpa] externals/bind-key 21a126cb7e 9/9: Merge pull request #1018 from skangas/texinfo-wip, ELPA Syncer, 2022/11/15
- [elpa] externals/bind-key 1938f50e74 5/9: Use two spaces to end sentences,
ELPA Syncer <=