* emacs/package.texi (Package Installation): Mention package-pinned-packages.

* etc/NEWS: Related markup.

2 files changed, 11 insertions, 0 deletions

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 9a332b260d4..27168b00021 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2014-06-03  Glenn Morris  <rgm@gnu.org>
+
+        * package.texi (Package Installation): Mention package-pinned-packages.
+
 2014-06-02  Glenn Morris  <rgm@gnu.org>
 
         * misc.texi [iftex]: Update chapter summary.
diff --git a/doc/emacs/package.texi b/doc/emacs/package.texi
index dee1210086c..98e3c8ac706 100644
--- a/doc/emacs/package.texi
+++ b/doc/emacs/package.texi
@@ -167,6 +167,13 @@ directory name of the package archive.  You can alter this list if you
 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!
 
+@vindex package-pinned-packages
+  If you have more than one package archive enabled, and some of them
+offer different versions of the same package, you may find the option
+@code{package-pinned-packages} useful.  You can add package/archive
+pairs to this list, to ensure that the specified package is only ever
+downloaded from the specified archive.
+
   Once a package is downloaded and installed, it is @dfn{loaded} into
 the current Emacs session.  Loading a package is not quite the same as
 loading a Lisp library (@pxref{Lisp Libraries}); its effect varies