From 326c1f0631e9e3f09f4e18516110534af7381282 Mon Sep 17 00:00:00 2001 From: Katsumi Yamaoka Date: Fri, 10 Aug 2007 02:34:24 +0000 Subject: [PATCH] (NNTP): Mention nntp-xref-number-is-evil. --- texi/ChangeLog | 4 ++++ texi/gnus.texi | 28 ++++++++++++++++++++++++++++ 2 files changed, 32 insertions(+) diff --git a/texi/ChangeLog b/texi/ChangeLog index 676f67e37..1d39de944 100644 --- a/texi/ChangeLog +++ b/texi/ChangeLog @@ -1,3 +1,7 @@ +2007-08-10 Katsumi Yamaoka + + * gnus.texi (NNTP): Mention nntp-xref-number-is-evil. + 2007-07-20 Micha,Ak(Bl Cadilhac * gnus.texi (RSS): Document nnrss-ignore-article-fields. diff --git a/texi/gnus.texi b/texi/gnus.texi index c9d5e6a42..a0a29c1c9 100644 --- a/texi/gnus.texi +++ b/texi/gnus.texi @@ -13234,6 +13234,34 @@ network is fast, setting this variable to a really small number means that fetching will probably be slower. If this variable is @code{nil}, @code{nntp} will never split requests. The default is 5. +@item nntp-xref-number-is-evil +@vindex nntp-xref-number-is-evil +When Gnus refers to an article having the @code{Message-ID} that a user +specifies or having the @code{Message-ID} of the parent article of the +current one (@pxref{Finding the Parent}), Gnus sends a @code{HEAD} +command to the @acronym{NNTP} server to know where it is, and the server +returns the data containing the pairs of a group and an article number +in the @code{Xref} header. Gnus normally uses the article number to +refer to the article if the data shows that that article is in the +current group, while it uses the @code{Message-ID} otherwise. However, +some news servers, e.g., ones running Diablo, run multiple engines +having the same articles but article numbers are not kept synchronized +between them. In that case, the article number that appears in the +@code{Xref} header varies by which engine is chosen, so you cannot refer +to the parent article that is in the current group, for instance. If +you connect to such a server, set this variable to a non-@code{nil} +value, and Gnus never uses article numbers. For example: + +@lisp +(setq gnus-select-method + '(nntp "newszilla" + (nntp-address "newszilla.example.com") + (nntp-xref-number-is-evil t) + @dots{})) +@end lisp + +The default value of this server variable is @code{nil}. + @item nntp-prepare-server-hook @vindex nntp-prepare-server-hook A hook run before attempting to connect to an @acronym{NNTP} server. -- 2.25.1