From af622f1a315d48f0d979748e330b97f66179919a Mon Sep 17 00:00:00 2001 From: yamaoka Date: Thu, 25 Nov 2004 08:35:16 +0000 Subject: [PATCH] Synch to No Gnus 200411250834. --- texi/ChangeLog | 10 +++++++++ texi/gnus-ja.texi | 61 ++++++++++++++++++++++++++++++++++++++++++++-------- texi/gnus.texi | 62 +++++++++++++++++++++++++++++++++++++++++++++-------- 3 files changed, 115 insertions(+), 18 deletions(-) diff --git a/texi/ChangeLog b/texi/ChangeLog index 27d0604..7817cb1 100644 --- a/texi/ChangeLog +++ b/texi/ChangeLog @@ -1,3 +1,13 @@ +2004-11-25 Katsumi Yamaoka + + * gnus.texi (Finding the News): Add a note for NNTP marks. + Improved by Romain Francoise. + +2004-11-23 Romain Francoise + + * gnus.texi (NNTP marks): New node. + (NNTP): Move NNTP marks variables to the new node. + 2004-11-21 Jesper Harder * gnus.texi, gnus-news.texi, pgg.texi, sasl.texi: backend -> back diff --git a/texi/gnus-ja.texi b/texi/gnus-ja.texi index c2a3779..0c84586 100644 --- a/texi/gnus-ja.texi +++ b/texi/gnus-ja.texi @@ -666,6 +666,7 @@ Getting News * Direct Functions:: $B%5!<%P!<$KD>@\@\B3$9$k(B * Indirect Functions:: $B%5!<%P!<$K4V@\E*$K@\B3$9$k(B * Common Variables:: $B$$$/$D$+$N@\B3MQ$N4X?t$,;2>H$9$kJQ?t(B +* NNTP marks:: @acronym{NNTP} $B%5!<%P!\:Y$K(B +$B$D$$$F$O(B @ref{NNTP marks} $B$r;2>H$7$F2<$5$$!#(B + @node The First Time @section $B0lHV=i$a(B @cindex first time usage @@ -12023,6 +12029,7 @@ LIST $B%3%^%s%I$N%*%W%7%g%s$K;H$C$F!"(B($B%5!<%P!<$N(B) $B%j%9%H=PNO$r@_Dj$ * Direct Functions:: $B%5!<%P!<$KD>@\@\B3$9$k(B * Indirect Functions:: $B%5!<%P!<$K4V@\E*$K@\B3$9$k(B * Common Variables:: $B$$$/$D$+$N@\B3MQ$N4X?t$,;2>H$9$kJQ?t(B +* NNTP marks:: @acronym{NNTP} $B%5!<%P! *\r?} $B$G$9!#(B - -@item nntp-marks-is-evil -@vindex nntp-marks-is-evil -$BHs(B-@code{nil} $B$@$C$?$i!"$3$N%P%C%/%(%s%I$O(B @sc{marks} $B%U%!%$%k$rL5;k$7$^(B -$B$9!#%G%#%U%)%k%H$O(B @code{nil} $B$G$9!#(B - -@item nntp-marks-directory -@vindex nntp-marks-directory -@acronym{NNTP} $B%0%k!<%W$N(B @sc{marks} $B$,3JG<$5$l$k%G%#%l%/%H%j$G$9!#(B @end table @code{nntp-end-of-line} $B$NCM$r(B @samp{\n} $B$KJQ99$9$kI,MW$,$"$k$G$"$m$&$3(B @@ -12266,6 +12264,51 @@ Emacs $B$N%;%C%7%g%sA4BN$r%i%C%W$7$F!"%G%#%U%)%k%H$N%a%=%C%I$r;H$&$H$$$&$N(B $B$O(B @samp{("-8")} $B$G$9!#(B @end table +@node NNTP marks +@subsubsection NNTP marks +@cindex storing NNTP marks + +Gnus $B$O(B @acronym{NNTP} $B%5!<%P!$l$N%U%!%$%k$O!"BP1~(B +$B$9$k%5!<%P!<$N$=$l$>$l$KBP$7$F@lMQ$G$9!#0u%U%!%$%k$O!"%K%e!<%9%5!<%P!<$K(B +$B;w$F$$$k8EE5E*$J3,AX(B +$B$G(B @file{~/News/marks} (@code{nntp-marks-directory}) $B$KJ]B8$5$l$^$9!#Nc(B +$B$($P(B news.gmane.org $B%5!<%P!<$K$*$1$k(B @samp{gmane.discuss} $B%0%k!<%W$N$?$a(B +$B$N0u%U%!%$%k(B +$B$O(B @file{~/News/marks/news.gmane.org/gmane/discuss/.marks} $B$KJ]B8$5$l$^(B +$B$9!#(B + +$B0u%U%!%$%k$OLr$KN)$A$^$9!#(B@file{~/News/marks} $B%G%#%l%/%H%j$O(B (rsync$B!"(B +scp $B$^$?$OB>$N2?$+$r;H$C$F(B) Gnus $B$rAv$i$;$kJL$N%[%9%H$K%3%T!<$9$k$3$H$,(B +$B$G$-!"$I$N5-;v$rFI$s$G0u$rIU$1$?$+$r$=$A$i$G:F8=$7$^$9!#(B +@file{~/News/marks} $B$N%G!<%?$O!"(B@file{~/.newsrc.eld} $B$K$"$kF1$8$b$N$h$j(B +$B$bM%@h$5$l$^$9!#(B + +$B0u%U%!%$%k$O!"$=$l$>$l$N%5!<%P!<$4$H$K!"Hs>o$KFC2=$5$l$k$3$H$KCm0U$7$F2<(B +$B$5$$!#(BGnus $B$O5-;vHV9f$r5-21$9$k$N$G!"N>J}$N%[%9%H$GF1$8%5!<%P!<$r;H$C$F(B +$B$$$J$$$H!"J*;v$O2u$l$F$7$^$&$G$7$g$&(B ($BBgDq$N%5!<%P!<$OB>$N$I$s$J%5!<%P!<(B +$B$HF1$85-;vHV9f$r;H$$$^$;$s(B)$B!#$7$+$7!"$"$k%[%9%H$G%5!<%P!<(B A$B!"(BB$B!"(BC $B$r;H$$!"(B +$BJL$N%[%9%H$G%5!<%P!<(B A$B!"(BD$B!"(BE $B$r;H$&>l9g$K$O!"(BA $B$N$?$a$N0u%U%!%$%k$rF1$8(B +$B$K$9$k$3$H$,$G$-!"Fs$D$N%[%9%H4V$G$=$N%5!<%P!<$OF14|$7$^$9!#(B + +@acronym{NNTP} $B0u$N;HMQ$O@-G=$NNt2=$r>7$-!"(BGnus $B$r$N$m$/46$8$5$;$k2DG=@-(B +$B$,$"$j$^$9!#$=$&$$$&>l9g$O(B @code{nntp-marks-is-evil} $BJQ?t$r(B @code{t} $B$K(B +$B@_Dj$7$F$_$F2<$5$$!#$9$k$H!"0u$O(B @file{~/.newsrc.eld} ($B$@$1(B) $B$K3JG<$5$l(B +$B$k$G$7$g$&!#(B + +$B4XO"$9$kJQ?t(B: + +@table @code +@item nntp-marks-is-evil +@vindex nntp-marks-is-evil +$BHs(B-@code{nil} $B$@$C$?$i!"$3$N%P%C%/%(%s%I$O0u%U%!%$%k$rL5;k$7$^$9!#%G%#%U%)(B +$B%k%H$O(B @code{nil} $B$G$9!#(B + +@item nntp-marks-directory +@vindex nntp-marks-directory +@acronym{NNTP} $B%0%k!<%W$N0u$,3JG<$5$l$k%G%#%l%/%H%j$G$9!#(B +@end table + @node News Spool @subsection $B%K%e!<%9%9%W!<%k(B @cindex nnspool diff --git a/texi/gnus.texi b/texi/gnus.texi index 6dd4d01..fa51576 100644 --- a/texi/gnus.texi +++ b/texi/gnus.texi @@ -653,6 +653,7 @@ Getting News * Direct Functions:: Connecting directly to the server. * Indirect Functions:: Connecting indirectly to the server. * Common Variables:: Understood by several connection functions. +* NNTP marks:: Storing marks for @acronym{NNTP} servers. Getting Mail @@ -1050,6 +1051,11 @@ you would typically set this variable to (setq gnus-secondary-select-methods '((nnmbox ""))) @end lisp +Note: the @acronym{NNTP} back end stores marks in marks files +(@pxref{NNTP marks}). This feature makes it easy to share marks between +several Gnus installations, but may slow down things a bit when fetching +new articles. @xref{NNTP marks} for more information. + @node The First Time @section The First Time @@ -12790,6 +12796,7 @@ command. You may use it as a server variable as follows: * Direct Functions:: Connecting directly to the server. * Indirect Functions:: Connecting indirectly to the server. * Common Variables:: Understood by several connection functions. +* NNTP marks:: Storing marks for @acronym{NNTP} servers. @end menu @@ -12965,15 +12972,6 @@ login name. This works for Solaris @code{telnet}, for instance. Regexp matching the shell prompt on the intermediate host. The default is @samp{bash\\|\$ *\r?$\\|> *\r?}. -@item nntp-marks-is-evil -@vindex nntp-marks-is-evil -If non-@code{nil}, this back end will ignore any @sc{marks} files. The -default is @code{nil}. - -@item nntp-marks-directory -@vindex nntp-marks-directory -The directory where @sc{marks} for nntp groups will be stored. - @end table Note that you may want to change the value for @code{nntp-end-of-line} @@ -13046,6 +13044,52 @@ is @samp{("-8")}. @end table +@node NNTP marks +@subsubsection NNTP marks +@cindex storing NNTP marks + +Gnus stores marks (@pxref{Marking Articles}) for @acronym{NNTP} +servers in marks files. A marks file records what marks you have set +in a group and each file is specific to the corresponding server. +Marks files are stored in @file{~/News/marks} +(@code{nntp-marks-directory}) under a classic hierarchy resembling +that of a news server, for example marks for the group +@samp{gmane.discuss} on the news.gmane.org server will be stored in +the file @file{~/News/marks/news.gmane.org/gmane/discuss/.marks}. + +Marks files are useful because you can copy the @file{~/News/marks} +directory (using rsync, scp or whatever) to another Gnus installation, +and it will realize what articles you have read and marked. The data +in @file{~/News/marks} has priority over the same data in +@file{~/.newsrc.eld}. + +Note that marks files are very much server-specific: Gnus remembers +the article numbers so if you don't use the same servers on both +installations things are most likely to break (most @acronym{NNTP} +servers do not use the same article numbers as any other server). +However, if you use servers A, B, C on one installation and servers A, +D, E on the other, you can sync the marks files for A and then you'll +get synchronization for that server between the two installations. + +Using @acronym{NNTP} marks can possibly incur a performance penalty so +if Gnus feels sluggish, try setting the @code{nntp-marks-is-evil} +variable to @code{t}. Marks will then be stored in @file{~/.newsrc.eld}. + +Related variables: + +@table @code + +@item nntp-marks-is-evil +@vindex nntp-marks-is-evil +If non-@code{nil}, this back end will ignore any marks files. The +default is @code{nil}. + +@item nntp-marks-directory +@vindex nntp-marks-directory +The directory where marks for nntp groups will be stored. + +@end table + @node News Spool @subsection News Spool -- 1.7.10.4