diff options
| author | Glenn Morris | 2020-01-15 07:50:22 -0800 |
|---|---|---|
| committer | Glenn Morris | 2020-01-15 07:50:22 -0800 |
| commit | d672ad60e34b4e1dcb28f91d15f1e286acf2f94f (patch) | |
| tree | 5d17911717db0469bed838cbda7c0adf9638e31b /doc | |
| parent | e31287e704a539ebef777d92e4d06d4b1d912b2a (diff) | |
| parent | 0e936f18f8738fbe3809784f5ec6feb27c6bb24e (diff) | |
| download | emacs-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.texi | 1 | ||||
| -rw-r--r-- | doc/emacs/package.texi | 76 | ||||
| -rw-r--r-- | doc/lispref/variables.texi | 3 |
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 | |||
| 1099 | Emacs Lisp Packages | 1099 | Emacs 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}). | |||
| 57 | The package's status---normally one of @samp{available} (can be | 58 | The package's status---normally one of @samp{available} (can be |
| 58 | downloaded from the package archive), @samp{installed}, | 59 | downloaded 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}), |
| 60 | or @samp{built-in} (included in Emacs by default). The status | 61 | or @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}. |
| 62 | directory specified by @code{package-user-dir} (@pxref{Package | 63 | |
| 63 | Files}). External packages are treated much like built-in: they | 64 | @item |
| 64 | cannot be deleted through the package menu, and are not considered for | 65 | Which package archive this package is from, if you have more than one |
| 65 | upgrading. | 66 | package archive enabled. |
| 66 | |||
| 67 | The status can also be @samp{new}. This is equivalent to | ||
| 68 | @samp{available}, except that it means the package became newly | ||
| 69 | available on the package archive after your last invocation of | ||
| 70 | @kbd{M-x list-packages}. In other instances, a package may have the | ||
| 71 | status @samp{held}, @samp{disabled}, or @samp{obsolete}. | ||
| 72 | @xref{Package Installation}. | ||
| 73 | 67 | ||
| 74 | @item | 68 | @item |
| 75 | A short description of the package. | 69 | A short description of the package. |
| @@ -139,7 +133,7 @@ current line by an @kbd{i} or @kbd{d} command | |||
| 139 | Mark all package with a newer available version for upgrading | 133 | Mark 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 |
| 141 | on the new available versions, and a deletion mark on the old | 135 | on the new available versions, and a deletion mark on the old |
| 142 | installed versions. | 136 | installed 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}). | |||
| 195 | For example, you can install a package by typing @kbd{i} on the line | 189 | For example, you can install a package by typing @kbd{i} on the line |
| 196 | listing that package, followed by @kbd{x}. | 190 | listing that package, followed by @kbd{x}. |
| 197 | 191 | ||
| 192 | @node Package Statuses | ||
| 193 | @section Package Statuses | ||
| 194 | @cindex package status | ||
| 195 | |||
| 196 | A package can have one of the following statuses: | ||
| 197 | |||
| 198 | @table @samp | ||
| 199 | @item available | ||
| 200 | The package is not installed, but can be downloaded and installed from | ||
| 201 | the package archive. | ||
| 202 | |||
| 203 | @item avail-obso | ||
| 204 | The package is available for installation, but a newer version is also | ||
| 205 | available. Packages with this status are hidden by default. | ||
| 206 | |||
| 207 | @item built-in | ||
| 208 | The package is included in Emacs by default. It cannot be deleted | ||
| 209 | through the package menu, and is not considered for upgrading. | ||
| 210 | |||
| 211 | @item dependency | ||
| 212 | The package was installed automatically to satisfy a dependency of | ||
| 213 | another package. | ||
| 214 | |||
| 215 | @item disabled | ||
| 216 | The package has been disabled using the @code{package-load-list} | ||
| 217 | variable. | ||
| 218 | |||
| 219 | @item external | ||
| 220 | The package is not built-in and not from the directory specified by | ||
| 221 | @code{package-user-dir} (@pxref{Package Files}). External packages | ||
| 222 | are treated much like @samp{built-in} packages and cannot be deleted. | ||
| 223 | |||
| 224 | @item held | ||
| 225 | The package is held, @xref{Package Installation}. | ||
| 226 | |||
| 227 | @item incompat | ||
| 228 | The package cannot be installed for some reason, for example because | ||
| 229 | it depends on uninstallable packages. | ||
| 230 | |||
| 231 | @item installed | ||
| 232 | The package is installed. | ||
| 233 | |||
| 234 | @item new | ||
| 235 | Equivalent to @samp{available}, except that the package became newly | ||
| 236 | available on the package archive after your last invocation of | ||
| 237 | @kbd{M-x list-packages}. | ||
| 238 | |||
| 239 | @item obsolete | ||
| 240 | The package is an outdated installed version; in addition to this | ||
| 241 | version 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, | |||
| 1187 | lexical binding is enabled if the @var{lexical} argument to | 1187 | lexical 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 | ||
| 1190 | Lexical binding is also enabled in Lisp Interaction and IELM | ||
| 1191 | mode, 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 |
| 1192 | continue to be dynamically bound. These are called @dfn{special | 1195 | continue to be dynamically bound. These are called @dfn{special |