auth-sources doc fixes

* doc/misc/auth.texi (GnuPG and EasyPG Assistant Configuration):
Be agnostic about authinfo/authinfo.gpg default order. 

* lisp/gnus/auth-source.el (auth-sources): Doc fix.

Fixes: debbugs:16642

doc/misc/ChangeLog

+2014-02-08  Glenn Morris  <rgm@gnu.org>
+
+	* auth.texi (GnuPG and EasyPG Assistant Configuration):
+	Be agnostic about authinfo/authinfo.gpg default order.  (Bug#16642)
+
 2014-02-07  Glenn Morris  <rgm@gnu.org>
 
 	* viper.texi (File and Buffer Handling): Prefer ido to iswitchb.

doc/misc/auth.texi

@@ -470,10 +470,10 @@ It returns the number of items forgotten.
 @node GnuPG and EasyPG Assistant Configuration
 @appendix GnuPG and EasyPG Assistant Configuration
 
-If you don't customize @code{auth-sources}, the auth-source library
-reads @file{~/.authinfo.gpg}, which is a GnuPG encrypted file.  Then
-it will check @file{~/.authinfo} but it's not recommended to use such
-an unencrypted file.
+If the @code{auth-sources} variable contains @file{~/.authinfo.gpg}
+before @file{~/.authinfo}, the auth-source library will try to
+read the GnuPG encrypted @file{.gpg} file first, before
+the unencrypted file.
 
 In Emacs 23 or later there is an option @code{auto-encryption-mode} to
 automatically decrypt @file{*.gpg} files.  It is enabled by default.

lisp/gnus/ChangeLog

+2014-02-08  Glenn Morris  <rgm@gnu.org>
+
+	* auth-source.el (auth-sources): Doc fix.  (Bug#16642)
+
 2014-02-07  Lars Ingebrigtsen  <larsi@gnus.org>
 
 	* ietf-drums.el (ietf-drums-parse-address): Don't bug out when called

lisp/gnus/auth-source.el

@@ -233,16 +233,9 @@ If the value is a function, debug messages are logged by calling
 
 (defcustom auth-sources '("~/.authinfo" "~/.authinfo.gpg" "~/.netrc")
   "List of authentication sources.
-
-The default will get login and password information from
-\"~/.authinfo.gpg\", which you should set up with the EPA/EPG
-packages to be encrypted.  If that file doesn't exist, it will
-try the unencrypted version \"~/.authinfo\" and the famous
-\"~/.netrc\" file.
-
-See the auth.info manual for details.
-
 Each entry is the authentication type with optional properties.
+Entries are tried in the order in which they appear.
+See Info node `(auth)Help for users' for details.
 
 It's best to customize this with `M-x customize-variable' because the choices
 can get pretty complex."