aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/misc/ChangeLog19
-rw-r--r--doc/misc/ede.texi18
-rw-r--r--doc/misc/gnus.texi75
-rw-r--r--doc/misc/tramp.texi35
4 files changed, 90 insertions, 57 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 6ffa9b51933..1660ed5335b 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,7 +1,22 @@
12011-04-14 Michael Albinus <michael.albinus@gmx.de>
2
3 * tramp.texi (Frequently Asked Questions): New item for disabling
4 Tramp in other packages.
5
62011-04-14 Teodor Zlatanov <tzz@lifelogs.com>
7
8 * gnus.texi (nnmairix caveats, Setup, Registry Article Refer Method)
9 (Fancy splitting to parent, Store arbitrary data): Updated
10 gnus-registry docs.
11
122011-04-13 Juanma Barranquero <lekktu@gmail.com>
13
14 * ede.texi: Fix typos.
15
12011-04-12 Lars Magne Ingebrigtsen <larsi@gnus.org> 162011-04-12 Lars Magne Ingebrigtsen <larsi@gnus.org>
2 17
3 * gnus.texi (Window Layout): @itemize @code doesn't exist. It's @table 18 * gnus.texi (Window Layout): @itemize @code doesn't exist.
4 @code. 19 It's @table @code.
5 20
62011-03-19 Antoine Levitt <antoine.levitt@gmail.com> 212011-03-19 Antoine Levitt <antoine.levitt@gmail.com>
7 22
diff --git a/doc/misc/ede.texi b/doc/misc/ede.texi
index bc097a87150..67df955ca8f 100644
--- a/doc/misc/ede.texi
+++ b/doc/misc/ede.texi
@@ -2123,7 +2123,7 @@ Results in --add-missing being passed to automake.
2123@end deffn 2123@end deffn
2124 2124
2125@deffn Method ede-proj-flush-autoconf :AFTER this 2125@deffn Method ede-proj-flush-autoconf :AFTER this
2126Flush the configure file (current buffer) to accomodate @var{THIS}. 2126Flush the configure file (current buffer) to accommodate @var{THIS}.
2127By flushing, remove any cruft that may be in the file. Subsequent 2127By flushing, remove any cruft that may be in the file. Subsequent
2128calls to @dfn{ede-proj-tweak-autoconf} can restore items removed by flush. 2128calls to @dfn{ede-proj-tweak-autoconf} can restore items removed by flush.
2129@end deffn 2129@end deffn
@@ -2174,7 +2174,7 @@ These are removed with make clean.
2174@end deffn 2174@end deffn
2175 2175
2176@deffn Method ede-proj-tweak-autoconf :AFTER this 2176@deffn Method ede-proj-tweak-autoconf :AFTER this
2177Tweak the configure file (current buffer) to accomodate @var{THIS}. 2177Tweak the configure file (current buffer) to accommodate @var{THIS}.
2178@end deffn 2178@end deffn
2179 2179
2180@deffn Method ede-proj-compilers :AFTER obj 2180@deffn Method ede-proj-compilers :AFTER obj
@@ -2684,7 +2684,7 @@ Bonus: Return a cons cell: (COMPILED . UPTODATE).
2684@end deffn 2684@end deffn
2685 2685
2686@deffn Method ede-proj-flush-autoconf :AFTER this 2686@deffn Method ede-proj-flush-autoconf :AFTER this
2687Flush the configure file (current buffer) to accomodate @var{THIS}. 2687Flush the configure file (current buffer) to accommodate @var{THIS}.
2688@end deffn 2688@end deffn
2689 2689
2690@deffn Method ede-buffer-mine :AFTER this buffer 2690@deffn Method ede-buffer-mine :AFTER this buffer
@@ -2697,7 +2697,7 @@ Return the variable name for @var{THIS}'s sources.
2697@end deffn 2697@end deffn
2698 2698
2699@deffn Method ede-proj-tweak-autoconf :AFTER this 2699@deffn Method ede-proj-tweak-autoconf :AFTER this
2700Tweak the configure file (current buffer) to accomodate @var{THIS}. 2700Tweak the configure file (current buffer) to accommodate @var{THIS}.
2701@end deffn 2701@end deffn
2702 2702
2703@deffn Method ede-update-version-in-source :AFTER this version 2703@deffn Method ede-update-version-in-source :AFTER this version
@@ -2777,7 +2777,7 @@ Create or update the autoload target.
2777@end deffn 2777@end deffn
2778 2778
2779@deffn Method ede-proj-flush-autoconf :AFTER this 2779@deffn Method ede-proj-flush-autoconf :AFTER this
2780Flush the configure file (current buffer) to accomodate @var{THIS}. 2780Flush the configure file (current buffer) to accommodate @var{THIS}.
2781@end deffn 2781@end deffn
2782 2782
2783@deffn Method ede-buffer-mine :AFTER this buffer 2783@deffn Method ede-buffer-mine :AFTER this buffer
@@ -2796,7 +2796,7 @@ Argument @var{THIS} is the target which needs to insert an info file.
2796@end deffn 2796@end deffn
2797 2797
2798@deffn Method ede-proj-tweak-autoconf :AFTER this 2798@deffn Method ede-proj-tweak-autoconf :AFTER this
2799Tweak the configure file (current buffer) to accomodate @var{THIS}. 2799Tweak the configure file (current buffer) to accommodate @var{THIS}.
2800@end deffn 2800@end deffn
2801 2801
2802@deffn Method ede-update-version-in-source :AFTER this version 2802@deffn Method ede-update-version-in-source :AFTER this version
@@ -3008,7 +3008,7 @@ The preferred interpreter for this code.
3008@subsubsection Specialized Methods 3008@subsubsection Specialized Methods
3009 3009
3010@deffn Method ede-proj-tweak-autoconf :AFTER this 3010@deffn Method ede-proj-tweak-autoconf :AFTER this
3011Tweak the configure file (current buffer) to accomodate @var{THIS}. 3011Tweak the configure file (current buffer) to accommodate @var{THIS}.
3012@end deffn 3012@end deffn
3013 3013
3014 3014
@@ -3536,7 +3536,7 @@ For example, C code uses .o on unix, and Emacs Lisp uses .elc.
3536@subsubsection Specialized Methods 3536@subsubsection Specialized Methods
3537 3537
3538@deffn Method ede-proj-flush-autoconf :AFTER this 3538@deffn Method ede-proj-flush-autoconf :AFTER this
3539Flush the configure file (current buffer) to accomodate @var{THIS}. 3539Flush the configure file (current buffer) to accommodate @var{THIS}.
3540@end deffn 3540@end deffn
3541 3541
3542@deffn Method ede-proj-makefile-insert-rules :AFTER this 3542@deffn Method ede-proj-makefile-insert-rules :AFTER this
@@ -3558,7 +3558,7 @@ Retrieves the slot @code{sourcetype} from an object of class @code{ede-compilati
3558@end deffn 3558@end deffn
3559 3559
3560@deffn Method ede-proj-tweak-autoconf :AFTER this 3560@deffn Method ede-proj-tweak-autoconf :AFTER this
3561Tweak the configure file (current buffer) to accomodate @var{THIS}. 3561Tweak the configure file (current buffer) to accommodate @var{THIS}.
3562@end deffn 3562@end deffn
3563 3563
3564 3564
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index fa417997794..9d9b767bcba 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -22061,10 +22061,11 @@ mairix.)
22061@item 22061@item
22062If you use the Gnus registry: don't use the registry with 22062If you use the Gnus registry: don't use the registry with
22063@code{nnmairix} groups (put them in 22063@code{nnmairix} groups (put them in
22064@code{gnus-registry-unfollowed-groups}). Be @emph{extra careful} if 22064@code{gnus-registry-unfollowed-groups}; this is the default). Be
22065you use @code{gnus-registry-split-fancy-with-parent}; mails which are 22065@emph{extra careful} if you use
22066split into @code{nnmairix} groups are usually gone for good as soon as 22066@code{gnus-registry-split-fancy-with-parent}; mails which are split
22067you check the group for new mail (yes, it has happened to me...). 22067into @code{nnmairix} groups are usually gone for good as soon as you
22068check the group for new mail (yes, it has happened to me...).
22068 22069
22069@item 22070@item
22070Therefore: @emph{Never ever} put ``real'' mails into @code{nnmairix} 22071Therefore: @emph{Never ever} put ``real'' mails into @code{nnmairix}
@@ -25916,8 +25917,7 @@ of all messages matching a particular set of criteria.
25916Fortunately, setting up the Gnus registry is pretty easy: 25917Fortunately, setting up the Gnus registry is pretty easy:
25917 25918
25918@lisp 25919@lisp
25919(setq gnus-registry-max-entries 2500 25920(setq gnus-registry-max-entries 2500)
25920 gnus-registry-use-long-group-names t)
25921 25921
25922(gnus-registry-initialize) 25922(gnus-registry-initialize)
25923@end lisp 25923@end lisp
@@ -25939,16 +25939,16 @@ what they do before you copy them blindly).
25939 ("spam" t) 25939 ("spam" t)
25940 ("train" t)) 25940 ("train" t))
25941 gnus-registry-max-entries 500000 25941 gnus-registry-max-entries 500000
25942 gnus-registry-use-long-group-names t 25942 ;; this is the default
25943 gnus-registry-track-extra '(sender subject)) 25943 gnus-registry-track-extra '(sender subject))
25944@end lisp 25944@end lisp
25945 25945
25946They say: keep a lot of messages around, use long group names, track 25946They say: keep a lot of messages around, track messages by sender and
25947messages by sender and subject (not just parent Message-ID), and when 25947subject (not just parent Message-ID), and when the registry splits
25948the registry splits incoming mail, use a majority rule to decide where 25948incoming mail, use a majority rule to decide where messages should go
25949messages should go if there's more than one possibility. In addition, 25949if there's more than one possibility. In addition, the registry
25950the registry should ignore messages in groups that match ``nntp'', 25950should ignore messages in groups that match ``nntp'', ``nnrss'',
25951``nnrss'', ``spam'', or ``train.'' 25951``spam'', or ``train.''
25952 25952
25953You are doubtless impressed by all this, but you ask: ``I am a Gnus 25953You are doubtless impressed by all this, but you ask: ``I am a Gnus
25954user, I customize to live. Give me more.'' Here you go, these are 25954user, I customize to live. Give me more.'' Here you go, these are
@@ -25958,19 +25958,9 @@ the general settings.
25958The groups that will not be followed by 25958The groups that will not be followed by
25959@code{gnus-registry-split-fancy-with-parent}. They will still be 25959@code{gnus-registry-split-fancy-with-parent}. They will still be
25960remembered by the registry. This is a list of regular expressions. 25960remembered by the registry. This is a list of regular expressions.
25961@end defvar 25961By default any group name that ends with ``delayed'', ``drafts'',
25962 25962``queue'', or ``INBOX'', belongs to the nnmairix backend, or contains
25963@defvar gnus-registry-ignored-groups 25963the word ``archive'' is not followed.
25964The groups that will not be remembered by the registry. This is a
25965list of regular expressions, also available through Group/Topic
25966customization (so you can ignore or keep a specific group or a whole
25967topic).
25968@end defvar
25969
25970@defvar gnus-registry-use-long-group-names
25971Whether the registry will use long group names. It's recommended to
25972set this to @code{t}, although everything works if you don't. Future
25973functionality will require it.
25974@end defvar 25964@end defvar
25975 25965
25976@defvar gnus-registry-max-entries 25966@defvar gnus-registry-max-entries
@@ -25978,8 +25968,15 @@ The number (an integer or @code{nil} for unlimited) of entries the
25978registry will keep. 25968registry will keep.
25979@end defvar 25969@end defvar
25980 25970
25971@defvar gnus-registry-max-pruned-entries
25972The maximum number (an integer or @code{nil} for unlimited) of entries
25973the registry will keep after pruning.
25974@end defvar
25975
25981@defvar gnus-registry-cache-file 25976@defvar gnus-registry-cache-file
25982The file where the registry will be stored between Gnus sessions. 25977The file where the registry will be stored between Gnus sessions. By
25978default the file name is @code{.gnus.registry.eioio} in the same
25979directory as your @code{.newsrc.eld}.
25983@end defvar 25980@end defvar
25984 25981
25985@node Registry Article Refer Method 25982@node Registry Article Refer Method
@@ -26003,8 +26000,7 @@ lines:
26003;; Keep enough entries to have a good hit rate when referring to an 26000;; Keep enough entries to have a good hit rate when referring to an
26004;; article using the registry. Use long group names so that Gnus 26001;; article using the registry. Use long group names so that Gnus
26005;; knows where the article is. 26002;; knows where the article is.
26006(setq gnus-registry-max-entries 2500 26003(setq gnus-registry-max-entries 2500)
26007 gnus-registry-use-long-group-names t)
26008 26004
26009(gnus-registry-initialize) 26005(gnus-registry-initialize)
26010 26006
@@ -26050,9 +26046,8 @@ following variables.
26050 26046
26051@defvar gnus-registry-track-extra 26047@defvar gnus-registry-track-extra
26052This is a list of symbols, so it's best to change it from the 26048This is a list of symbols, so it's best to change it from the
26053Customize interface. By default it's @code{nil}, but you may want to 26049Customize interface. By default it's @code{(subject sender)}, which
26054track @code{subject} and @code{sender} as well when splitting by parent. 26050may work for you. It can be annoying if your mail flow is large and
26055It may work for you. It can be annoying if your mail flow is large and
26056people don't stick to the same groups. 26051people don't stick to the same groups.
26057@end defvar 26052@end defvar
26058 26053
@@ -26060,7 +26055,8 @@ people don't stick to the same groups.
26060This is a symbol, so it's best to change it from the Customize 26055This is a symbol, so it's best to change it from the Customize
26061interface. By default it's @code{nil}, but you may want to set it to 26056interface. By default it's @code{nil}, but you may want to set it to
26062@code{majority} or @code{first} to split by sender or subject based on 26057@code{majority} or @code{first} to split by sender or subject based on
26063the majority of matches or on the first found. 26058the majority of matches or on the first found. I find @code{majority}
26059works best.
26064@end defvar 26060@end defvar
26065 26061
26066@node Store custom flags and keywords 26062@node Store custom flags and keywords
@@ -26095,17 +26091,12 @@ The registry has a simple API that uses a Message-ID as the key to
26095store arbitrary data (as long as it can be converted to a list for 26091store arbitrary data (as long as it can be converted to a list for
26096storage). 26092storage).
26097 26093
26098@defun gnus-registry-store-extra-entry (id key value) 26094@defun gnus-registry-set-id-key (id key value)
26099Store @code{value} in the extra data key @code{key} for message 26095Store @code{value} under @code{key} for message @code{id}.
26100@code{id}.
26101@end defun
26102
26103@defun gnus-registry-delete-extra-entry (id key)
26104Delete the extra data key @code{key} for message @code{id}.
26105@end defun 26096@end defun
26106 26097
26107@defun gnus-registry-fetch-extra (id key) 26098@defun gnus-registry-get-id-key (id key)
26108Get the extra data key @code{key} for message @code{id}. 26099Get the data under @code{key} for message @code{id}.
26109@end defun 26100@end defun
26110 26101
26111@defvar gnus-registry-extra-entries-precious 26102@defvar gnus-registry-extra-entries-precious
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index e1c4a806de2..2663d2df0f5 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -2812,7 +2812,6 @@ When @value{tramp} does not connect to the remote host, there are three
2812reasons heading the bug mailing list: 2812reasons heading the bug mailing list:
2813 2813
2814@itemize @minus 2814@itemize @minus
2815
2816@item 2815@item
2817Unknown characters in the prompt 2816Unknown characters in the prompt
2818 2817
@@ -2882,7 +2881,6 @@ checksum.
2882 (when (file-remote-p default-directory) 2881 (when (file-remote-p default-directory)
2883 (set (make-local-variable 'file-precious-flag) t)))) 2882 (set (make-local-variable 'file-precious-flag) t))))
2884@end lisp 2883@end lisp
2885
2886@end itemize 2884@end itemize
2887 2885
2888 2886
@@ -3377,14 +3375,43 @@ export EDITOR=/path/to/emacsclient.sh
3377 3375
3378 3376
3379@item 3377@item
3380How can I disable @value{tramp}? 3378There are packages which call @value{tramp} although I haven't entered
3379a remote file name ever. I dislike it, how could I disable it?
3381 3380
3382Shame on you, why did you read until now? 3381In general, @value{tramp} functions are used only when
3382you apply remote file name syntax. However, some packages enable
3383@value{tramp} on their own.
3383 3384
3384@itemize @minus 3385@itemize @minus
3386@item
3387@file{ido.el}
3388
3389You could disable @value{tramp} file name completion:
3390
3391@lisp
3392(custom-set-variables
3393 '(ido-enable-tramp-completion nil))
3394@end lisp
3385 3395
3386@item 3396@item
3397@file{rlogin.el}
3398
3399You could disable remote directory tracking mode:
3400
3401@lisp
3402(rlogin-directory-tracking-mode -1)
3403@end lisp
3404@end itemize
3405
3406
3407@item
3408How can I disable @value{tramp} at all?
3409
3410Shame on you, why did you read until now?
3411
3412@itemize @minus
3387@ifset emacs 3413@ifset emacs
3414@item
3388If you just want to have @value{ftppackagename} as default remote 3415If you just want to have @value{ftppackagename} as default remote
3389files access package, you should apply the following code: 3416files access package, you should apply the following code:
3390 3417