mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-08 07:20:28 -08:00
Code Issues Projects Releases Wiki Activity

Fix (Non)GNU ELPA description in manual

Browse source 
* doc/emacs/package.texi (Packages): Move detailed (Non)GNU ELPA
description...
(Package Installation): ...here, and fix incorrect information.
This commit is contained in:
Stefan Kangas 2025-02-13 16:37:51 +01:00
parent 87a61eba1b
commit b9b9c33dcb
1 changed files with 19 additions and 16 deletions
Download patch file Download diff file Expand all files Collapse all files

35
doc/emacs/package.texi
View file

@ -39,16 +39,9 @@ attributes of the package and the features that it implements.
@cindex NonGNU ELPA @cindex NonGNU ELPA
By default, Emacs downloads packages from two archives: By default, Emacs downloads packages from two archives:
@url{https://elpa.gnu.org/, GNU ELPA} and @url{https://elpa.nongnu.org/, @url{https://elpa.gnu.org/, GNU ELPA} and @url{https://elpa.nongnu.org/,
NonGNU ELPA}. These are maintained by the Emacs developers and hosted by NonGNU ELPA}. These are maintained by the Emacs developers and hosted
the GNU project. @dfn{GNU ELPA} contains GNU packages that we consider by the GNU project. Optionally, you can also download packages from
part of GNU Emacs, but are distributed separately from the core Emacs. third-party archives. @xref{Package Installation}.
@dfn{NonGNU ELPA} contains third-party packages whose copyright has not
been assigned to the Free Software Foundation.@footnote{For more
information about copyright assignments, see
@url{https://www.gnu.org/licenses/why-assign.html, Why the FSF Gets
Copyright Assignments from Contributors}.} Optionally, you can also
download packages from third-party archives. @xref{Package
Installation}.
For information about turning an Emacs Lisp program into an For information about turning an Emacs Lisp program into an
installable package, @xref{Packaging,,,elisp, The Emacs Lisp Reference installable package, @xref{Packaging,,,elisp, The Emacs Lisp Reference
@ -407,12 +400,22 @@ package is somehow unavailable, Emacs signals an error and stops
installation.) A package's requirements list is shown in its help installation.) A package's requirements list is shown in its help
buffer. buffer.
By default, packages are downloaded from a single package archive By default, Emacs downloads packages from two archives:
maintained by the Emacs developers. This is controlled by the @url{https://elpa.gnu.org/, GNU ELPA} and @url{https://elpa.nongnu.org/,
variable @code{package-archives}, whose value is a list of package NonGNU ELPA}. These are maintained by the Emacs developers and hosted
archives known to Emacs. Each list element must have the form by the GNU project. @dfn{GNU ELPA} contains GNU packages that we
@code{(@var{id} . @var{location})}, where @var{id} is the name of a consider part of GNU Emacs, but are distributed separately from the core
package archive and @var{location} is the @acronym{URL} or Emacs. @dfn{NonGNU ELPA} contains third-party packages whose copyright
has not been assigned to the Free Software Foundation.@footnote{For more
information about copyright assignments, see
@url{https://www.gnu.org/licenses/why-assign.html, Why the FSF Gets
Copyright Assignments from Contributors}.}
@noindent
This is controlled by the variable @code{package-archives}, whose value
is a list of package archives known to Emacs. Each list element must
have the form @code{(@var{id} . @var{location})}, where @var{id} is the
name of a package archive and @var{location} is the @acronym{URL} or
name of the package archive directory. You can alter this list if you name of the package archive directory. You can alter this list if you
wish to use third party package archives---but do so at your own risk, wish to use third party package archives---but do so at your own risk,
and use only third parties that you think you can trust! and use only third parties that you think you can trust!