aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorGlenn Morris2020-01-15 07:50:22 -0800
committerGlenn Morris2020-01-15 07:50:22 -0800
commitd672ad60e34b4e1dcb28f91d15f1e286acf2f94f (patch)
tree5d17911717db0469bed838cbda7c0adf9638e31b /doc
parente31287e704a539ebef777d92e4d06d4b1d912b2a (diff)
parent0e936f18f8738fbe3809784f5ec6feb27c6bb24e (diff)
downloademacs-d672ad60e34b4e1dcb28f91d15f1e286acf2f94f.tar.gz
emacs-d672ad60e34b4e1dcb28f91d15f1e286acf2f94f.zip
Merge from origin/emacs-27
0e936f18f8 (origin/emacs-27) Fix build failure with --with-cairo --wi... c34f7e884b Add new node "Package Statuses" to manual fdee034ac8 * lisp/isearch.el: Fix corner cases of isearch-lazy-count. 7b14329d86 ; * lisp/simple.el (messages-buffer): Doc fix. (Bug#39124) 7ec66a59e3 Document spacing issues with Xft for some fonts 08cd247fbd ; * etc/NEWS: Fix typo. d645628e3c Always use lexical-binding in lisp-interaction-mode (bug#3... c42198f78c ; *etc/NEWS: Fix typo. 0ed9cfa7dc vc-dir: ensure we don't use a pager with git 37e0d00c14 Improve ERC's matching of nicks and URLs (bug#38257) d47b157969 Handle tab-bar clicks on a GPM-capable console. e4791f3f8e ;* etc/TODO: Update. # Conflicts: # etc/NEWS
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/emacs.texi1
-rw-r--r--doc/emacs/package.texi76
-rw-r--r--doc/lispref/variables.texi3
3 files changed, 66 insertions, 14 deletions
diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi
index 0400ed0b736..c3cb37e6a6d 100644
--- a/doc/emacs/emacs.texi
+++ b/doc/emacs/emacs.texi
@@ -1099,6 +1099,7 @@ Hyperlinking and Navigation Features
1099Emacs Lisp Packages 1099Emacs Lisp Packages
1100 1100
1101* Package Menu:: Buffer for viewing and managing packages. 1101* Package Menu:: Buffer for viewing and managing packages.
1102* Package Statuses:: Which statuses a package can have.
1102* Package Installation:: Options for package installation. 1103* Package Installation:: Options for package installation.
1103* Package Files:: Where packages are installed. 1104* Package Files:: Where packages are installed.
1104 1105
diff --git a/doc/emacs/package.texi b/doc/emacs/package.texi
index cca602e7a05..1cac7f9b4b6 100644
--- a/doc/emacs/package.texi
+++ b/doc/emacs/package.texi
@@ -32,6 +32,7 @@ Manual}.
32 32
33@menu 33@menu
34* Package Menu:: Buffer for viewing and managing packages. 34* Package Menu:: Buffer for viewing and managing packages.
35* Package Statuses:: Which statuses a package can have.
35* Package Installation:: Options for package installation. 36* Package Installation:: Options for package installation.
36* Package Files:: Where packages are installed. 37* Package Files:: Where packages are installed.
37@end menu 38@end menu
@@ -57,19 +58,12 @@ The package's version number (e.g., @samp{11.86}).
57The package's status---normally one of @samp{available} (can be 58The package's status---normally one of @samp{available} (can be
58downloaded from the package archive), @samp{installed}, 59downloaded from the package archive), @samp{installed},
59@c @samp{unsigned} (installed, but not signed; @pxref{Package Signing}), 60@c @samp{unsigned} (installed, but not signed; @pxref{Package Signing}),
60or @samp{built-in} (included in Emacs by default). The status 61or @samp{built-in} (included in Emacs by default).
61@samp{external} means the package is not built-in and not from the 62@xref{Package Statuses}.
62directory specified by @code{package-user-dir} (@pxref{Package 63
63Files}). External packages are treated much like built-in: they 64@item
64cannot be deleted through the package menu, and are not considered for 65Which package archive this package is from, if you have more than one
65upgrading. 66package archive enabled.
66
67The status can also be @samp{new}. This is equivalent to
68@samp{available}, except that it means the package became newly
69available on the package archive after your last invocation of
70@kbd{M-x list-packages}. In other instances, a package may have the
71status @samp{held}, @samp{disabled}, or @samp{obsolete}.
72@xref{Package Installation}.
73 67
74@item 68@item
75A short description of the package. 69A short description of the package.
@@ -139,7 +133,7 @@ current line by an @kbd{i} or @kbd{d} command
139Mark all package with a newer available version for upgrading 133Mark all package with a newer available version for upgrading
140(@code{package-menu-mark-upgrades}). This places an installation mark 134(@code{package-menu-mark-upgrades}). This places an installation mark
141on the new available versions, and a deletion mark on the old 135on the new available versions, and a deletion mark on the old
142installed versions. 136installed versions (marked with status @samp{obsolete}).
143 137
144@item x 138@item x
145@kindex x @r{(Package Menu)} 139@kindex x @r{(Package Menu)}
@@ -195,6 +189,60 @@ from lower-priority archives (@code{package-menu-toggle-hiding}).
195For example, you can install a package by typing @kbd{i} on the line 189For example, you can install a package by typing @kbd{i} on the line
196listing that package, followed by @kbd{x}. 190listing that package, followed by @kbd{x}.
197 191
192@node Package Statuses
193@section Package Statuses
194@cindex package status
195
196A package can have one of the following statuses:
197
198@table @samp
199@item available
200The package is not installed, but can be downloaded and installed from
201the package archive.
202
203@item avail-obso
204The package is available for installation, but a newer version is also
205available. Packages with this status are hidden by default.
206
207@item built-in
208The package is included in Emacs by default. It cannot be deleted
209through the package menu, and is not considered for upgrading.
210
211@item dependency
212The package was installed automatically to satisfy a dependency of
213another package.
214
215@item disabled
216The package has been disabled using the @code{package-load-list}
217variable.
218
219@item external
220The package is not built-in and not from the directory specified by
221@code{package-user-dir} (@pxref{Package Files}). External packages
222are treated much like @samp{built-in} packages and cannot be deleted.
223
224@item held
225The package is held, @xref{Package Installation}.
226
227@item incompat
228The package cannot be installed for some reason, for example because
229it depends on uninstallable packages.
230
231@item installed
232The package is installed.
233
234@item new
235Equivalent to @samp{available}, except that the package became newly
236available on the package archive after your last invocation of
237@kbd{M-x list-packages}.
238
239@item obsolete
240The package is an outdated installed version; in addition to this
241version of the package, a newer version is also installed.
242
243@c @samp{unsigned} (installed, but not signed; @pxref{Package Signing}),
244@end table
245
198@node Package Installation 246@node Package Installation
199@section Package Installation 247@section Package Installation
200 248
diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi
index 1ec97e2f3de..1e357754abe 100644
--- a/doc/lispref/variables.texi
+++ b/doc/lispref/variables.texi
@@ -1187,6 +1187,9 @@ When evaluating Emacs Lisp code directly using an @code{eval} call,
1187lexical binding is enabled if the @var{lexical} argument to 1187lexical binding is enabled if the @var{lexical} argument to
1188@code{eval} is non-@code{nil}. @xref{Eval}. 1188@code{eval} is non-@code{nil}. @xref{Eval}.
1189 1189
1190Lexical binding is also enabled in Lisp Interaction and IELM
1191mode, used in the @file{*scratch*} and @file{*ielm*} buffers.
1192
1190@cindex special variables 1193@cindex special variables
1191 Even when lexical binding is enabled, certain variables will 1194 Even when lexical binding is enabled, certain variables will
1192continue to be dynamically bound. These are called @dfn{special 1195continue to be dynamically bound. These are called @dfn{special