annotate doc/misc/auth.texi @ 109969:d539b74d6530

* textmodes/flyspell.el (flyspell-check-tex-math-command): Doc fix (Bug#5651).
author Chong Yidong <cyd@stupidchicken.com>
date Tue, 24 Aug 2010 16:58:07 -0400
parents 60516122d066
children 8d09094063d0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
1 \input texinfo @c -*-texinfo-*-
102371
0e907e93a720 Fix @setfilename.
Glenn Morris <rgm@gnu.org>
parents: 102059
diff changeset
2 @setfilename ../../info/auth
102059
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 102054
diff changeset
3 @settitle Emacs auth-source Library @value{VERSION}
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
4
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
5 @set VERSION 0.2
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
6
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
7 @copying
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
8 This file describes the Emacs auth-source library.
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
9
106815
1d1d5d9bd884 Add 2010 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 104891
diff changeset
10 Copyright @copyright{} 2008, 2009, 2010 Free Software Foundation, Inc.
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
11
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
12 @quotation
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
13 Permission is granted to copy, distribute and/or modify this document
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
14 under the terms of the GNU Free Documentation License, Version 1.3 or
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
15 any later version published by the Free Software Foundation; with no
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
16 Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
17 and with the Back-Cover Texts as in (a) below. A copy of the license
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
18 is included in the section entitled ``GNU Free Documentation License''
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
19 in the Emacs manual.
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
20
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
21 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
22 modify this GNU manual. Buying copies from the FSF supports it in
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
23 developing GNU and promoting software freedom.''
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
24
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
25 This document is part of a collection distributed under the GNU Free
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
26 Documentation License. If you want to distribute this document
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
27 separately from the collection, you can do so by adding a copy of the
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
28 license to the document, as described in section 6 of the license.
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
29 @end quotation
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
30 @end copying
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
31
102059
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 102054
diff changeset
32 @dircategory Emacs
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 102054
diff changeset
33 @direntry
109274
a91e94388547 Minor doc/misc/*.texi direntry fixes.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
34 * Auth-source: (auth). The Emacs auth-source library.
102059
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 102054
diff changeset
35 @end direntry
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
36
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
37 @titlepage
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
38 @title Emacs auth-source Library
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
39 @author by Ted Zlatanov
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
40 @page
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
41 @vskip 0pt plus 1filll
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
42 @insertcopying
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
43 @end titlepage
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
44
102059
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 102054
diff changeset
45 @contents
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
46
102059
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 102054
diff changeset
47 @ifnottex
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
48 @node Top
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
49 @top Emacs auth-source
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
50 This manual describes the Emacs auth-source library.
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
51
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
52 It is a way for multiple applications to share a single configuration
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
53 (in Emacs and in files) for user convenience.
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
54
102059
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 102054
diff changeset
55 @insertcopying
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 102054
diff changeset
56
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
57 @menu
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
58 * Overview:: Overview of the auth-source library.
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
59 * Help for users::
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
60 * Secret Service API::
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
61 * Help for developers::
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
62 * Index::
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
63 * Function Index::
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
64 * Variable Index::
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
65 @end menu
102059
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 102054
diff changeset
66 @end ifnottex
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
67
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
68 @node Overview
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
69 @chapter Overview
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
70
104891
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
71 The auth-source library is simply a way for Emacs and Gnus, among
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
72 others, to answer the old burning question ``I have a server name and
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
73 a port, what are my user name and password?''
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
74
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
75 The auth-source library actually supports more than just the user name
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
76 (known as the login) or the password, but only those two are in use
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
77 today in Emacs or Gnus. Similarly, the auth-source library supports
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
78 multiple storage formats, currently either the classic ``netrc''
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
79 format, examples of which you can see later in this document, or the
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
80 Secret Service API.
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
81
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
82 @node Help for users
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
83 @chapter Help for users
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
84
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
85 ``Netrc'' files are a de facto standard. They look like this:
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
86 @example
104891
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
87 machine @var{mymachine} login @var{myloginname} password @var{mypassword} port @var{myport}
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
88 @end example
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
89
104891
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
90 The machine is the server (either a DNS name or an IP address).
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
91
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
92 The port is optional. If it's missing, auth-source will assume any
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
93 port is OK. Actually the port is a protocol name or a port number so
104891
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
94 you can have separate entries for port @var{143} and for protocol
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
95 @var{imap} if you fancy that. Anyway, you can just omit the port if
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
96 you don't need it.
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
97
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
98 The login and password are simply your login credentials to the server.
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
99
104891
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
100 ``Netrc'' files are usually called @code{.authinfo} or @code{.netrc};
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
101 nowadays @code{.authinfo} seems to be more popular and the auth-source
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
102 library encourages this confusion by making it the default, as you'll
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
103 see later.
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
104
104891
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
105 If you have problems with the port, set @code{auth-source-debug} to
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
106 @code{t} and see what port the library is checking in the
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
107 @code{*Messages*} buffer. Ditto for any other problems, your first
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
108 step is always to see what's being checked. The second step, of
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
109 course, is to write a blog entry about it and wait for the answer in
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
110 the comments.
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
111
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
112 You can customize the variable @code{auth-sources}. The following may
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
113 be needed if you are using an older version of Emacs or if the
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
114 auth-source library is not loaded for some other reason.
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
115
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
116 @lisp
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
117 (require 'auth-source) ;; probably not necessary
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
118 (customize-variable 'auth-sources) ;; optional, do it once
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
119 @end lisp
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
120
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
121 @defvar auth-sources
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
122
104891
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
123 The @code{auth-sources} variable tells the auth-source library where
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
124 your netrc files or Secret Service API collection items live for a
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
125 particular host and protocol. While you can get fancy, the default
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
126 and simplest configuration is:
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
127
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
128 @lisp
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
129 ;;; old default: required :host and :protocol, not needed anymore
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
130 (setq auth-sources '((:source "~/.authinfo.gpg" :host t :protocol t)))
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
131 ;;; mostly equivalent (see below about fallbacks) but shorter:
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
132 (setq auth-sources '((:source "~/.authinfo.gpg")))
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
133 @end lisp
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
134
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
135 This says ``for any host and any protocol, use just that one file.''
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
136 Sweet simplicity. In fact, the latter is already the default, so
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
137 unless you want to move your netrc file, it will just work if you have
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
138 that file. Make sure it exists.
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
139
104891
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
140 By adding multiple entries to @code{auth-sources} with a particular
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
141 host or protocol, you can have specific netrc files for that host or
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
142 protocol. Usually this is unnecessary but may make sense if you have
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
143 shared netrc files or some other unusual setup (90% of Emacs users
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
144 have unusual setups and the remaining 10% are @emph{really} unusual).
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
145
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
146 Here's an example that uses the Secret Service API for all lookups,
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
147 using the default collection:
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
148
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
149 @lisp
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
150 (setq auth-sources '((:source (:secrets default))))
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
151 @end lisp
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
152
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
153 And here's a mixed example, using two sources:
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
154
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
155 @lisp
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
156 (setq auth-sources '((:source (:secrets default) :host "myserver" :user "joe")
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
157 (:source "~/.authinfo.gpg")))
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
158 @end lisp
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
159
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
160 The best match is determined by order (starts from the bottom) only
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
161 for the first pass, where things are checked exactly. In the example
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
162 above, the first pass would find a single match for host
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
163 @code{myserver}. The netrc choice would fail because it matches any
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
164 host and protocol implicitly (as a @emph{fallback}). A specified
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
165 value of @code{:host t} in @code{auth-sources} is considered a match
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
166 on the first pass, unlike a missing @code{:host}.
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
167
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
168 Now if you look for host @code{missing}, it won't match either source
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
169 explicitly. The second pass (the @emph{fallback} pass) will look at
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
170 all the implicit matches and collect them. They will be scored and
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
171 returned sorted by score. The score is based on the number of
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
172 explicit parameters that matched. See the @code{auth-pick} function
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
173 for details.
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
174
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
175 @end defvar
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
176
104891
2c607b344f3b 2009-09-02 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 104692
diff changeset
177 If you don't customize @code{auth-sources}, you'll have to live with
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
178 the defaults: any host and any port are looked up in the netrc
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
179 file @code{~/.authinfo.gpg}. This is an encrypted file if and only if
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
180 you set up EPA, which is strongly recommended.
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
181
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
182 @lisp
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
183 (require 'epa-file)
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
184 (epa-file-enable)
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
185 ;;; VERY important if you want symmetric encryption
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
186 ;;; irrelevant if you don't
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
187 (setq epa-file-cache-passphrase-for-symmetric-encryption t)
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
188 @end lisp
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
189
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
190 The simplest working netrc line example is one without a port.
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
191
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
192 @example
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
193 machine YOURMACHINE login YOU password YOURPASSWORD
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
194 @end example
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
195
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
196 This will match any authentication port. Simple, right? But what if
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
197 there's a SMTP server on port 433 of that machine that needs a
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
198 different password from the IMAP server?
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
199
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
200 @example
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
201 machine YOURMACHINE login YOU password SMTPPASSWORD port 433
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
202 machine YOURMACHINE login YOU password GENERALPASSWORD
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
203 @end example
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
204
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
205 For url-auth authentication (HTTP/HTTPS), you need to put this in your
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
206 netrc file:
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
207
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
208 @example
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
209 machine yourmachine.com:80 port http login testuser password testpass
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
210 @end example
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
211
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
212 This will match any realm and authentication method (basic or digest)
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
213 over HTTP. HTTPS is set up similarly. If you want finer controls,
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
214 explore the url-auth source code and variables.
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
215
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
216 For Tramp authentication, use:
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
217
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
218 @example
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
219 machine yourmachine.com port scp login testuser password testpass
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
220 @end example
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
221
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
222 Note that the port denotes the Tramp connection method. When you
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
223 don't use a port entry, you match any Tramp method, as explained
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
224 earlier. Since Tramp has about 88 connection methods, this may be
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
225 necessary if you have an unusual (see earlier comment on those) setup.
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
226
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
227 @node Secret Service API
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
228 @chapter Secret Service API
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
229
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
230 TODO: how does it work generally, how does secrets.el work, some examples.
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
231
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
232 @node Help for developers
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
233 @chapter Help for developers
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
234
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
235 The auth-source library only has one function for external use.
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
236
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
237 @defun auth-source-user-or-password mode host port &optional username
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
238
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
239 Retrieve appropriate authentication tokens, determined by @var{mode},
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
240 for host @var{host} and @var{port}. If @var{username} is provided it
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
241 will also be checked. If @code{auth-source-debug} is t, debugging
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
242 messages will be printed. Set @code{auth-source-debug} to a function
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
243 to use that function for logging. The parameters passed will be the
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
244 same that the @code{message} function takes, that is, a string
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
245 formatting spec and optional parameters.
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
246
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
247 If @var{mode} is a list of strings, the function will return a list of
104692
b99b3dda298b Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 102820
diff changeset
248 strings or @code{nil} objects (thus you can avoid parsing the netrc
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
249 file or checking the Secret Service API more than once). If it's a
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
250 string, the function will return a string or a @code{nil} object.
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
251 Currently only the modes ``login'' and ``password'' are recognized but
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
252 more may be added in the future.
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
253
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
254 @var{host} is a string containing the host name.
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
255
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
256 @var{port} contains the protocol name (e.g. ``imap'') or
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
257 a port number. It must be a string, corresponding to the port in the
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
258 users' netrc files.
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
259
107564
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
260 @var{username} contains the user name (e.g. ``joe'') as a string.
be11042041cb 2010-03-27 Teodor Zlatanov <tzz@lifelogs.com>
Katsumi Yamaoka <yamaoka@jpl.org>
parents: 106815
diff changeset
261
102054
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
262 @example
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
263 ;; IMAP example
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
264 (setq auth (auth-source-user-or-password
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
265 '("login" "password")
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
266 "anyhostnamehere"
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
267 "imap"))
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
268 (nth 0 auth) ; the login name
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
269 (nth 1 auth) ; the password
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
270 @end example
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
271
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
272 @end defun
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
273
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
274 @node Index
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
275 @chapter Index
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
276 @printindex cp
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
277
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
278 @node Function Index
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
279 @chapter Function Index
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
280 @printindex fn
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
281
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
282 @node Variable Index
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
283 @chapter Variable Index
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
284 @printindex vr
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
285
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
286 @bye
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
287
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
288 @c End:
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
289
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
290 @ignore
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
291 arch-tag: 7b835fd3-473f-40fc-9776-1c4e49d26c94
c35aac5fa64e Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents:
diff changeset
292 @end ignore