+2004-11-25 Katsumi Yamaoka <yamaoka@jpl.org>
+
+ * gnus.texi (Finding the News): Add a note for NNTP marks.
+ Improved by Romain Francoise.
+
+2004-11-23 Romain Francoise <romain@orebokech.com>
+
+ * gnus.texi (NNTP marks): New node.
+ (NNTP): Move NNTP marks variables to the new node.
+
2004-11-21 Jesper Harder <harder@ifa.au.dk>
* gnus.texi, gnus-news.texi, pgg.texi, sasl.texi: backend -> back
* Direct Functions:: \e$B%5!<%P!<$KD>@\@\B3$9$k\e(B
* Indirect Functions:: \e$B%5!<%P!<$K4V@\E*$K@\B3$9$k\e(B
* Common Variables:: \e$B$$$/$D$+$N@\B3MQ$N4X?t$,;2>H$9$kJQ?t\e(B
+* NNTP marks:: @acronym{NNTP} \e$B%5!<%P!<MQ$N0u$NJ]B8\e(B
Getting Mail
@noindent
\e$B$H@_Dj$7$^$9!#\e(B
+\e$BCm\e(B: @acronym{NNTP} \e$B$O0u%U%!%$%k\e(B (@pxref{NNTP marks}) \e$B$K0u$rJ]B8$7$^$9!#\e(B
+\e$B$3$N5!G=$O\e(B Gnus \e$B$,%$%s%9%H!<%k$5$l$F$$$kJ#?t$N%[%9%H4V$G0u$r6&M-$9$k$3$H\e(B
+\e$B$rMF0W$K$7$^$9$,!"?7Ce5-;v$N<hF@$r$A$g$C$HCY$/$9$k$+$b$7$l$^$;$s!#>\:Y$K\e(B
+\e$B$D$$$F$O\e(B @ref{NNTP marks} \e$B$r;2>H$7$F2<$5$$!#\e(B
+
@node The First Time
@section \e$B0lHV=i$a\e(B
@cindex first time usage
* Direct Functions:: \e$B%5!<%P!<$KD>@\@\B3$9$k\e(B
* Indirect Functions:: \e$B%5!<%P!<$K4V@\E*$K@\B3$9$k\e(B
* Common Variables:: \e$B$$$/$D$+$N@\B3MQ$N4X?t$,;2>H$9$kJQ?t\e(B
+* NNTP marks:: @acronym{NNTP} \e$B%5!<%P!<MQ$N0u$NJ]B8\e(B
@end menu
@node Direct Functions
@vindex nntp-via-shell-prompt
\e$BCf4V$N%[%9%H$G$N%7%'%k$N%W%m%s%W%H$K9gCW$9$k@55,I=8=$G$9!#%G%#%U%)%k%H\e(B
\e$B$O\e(B @samp{bash\\|\$ *\r?$\\|> *\r?} \e$B$G$9!#\e(B
-
-@item nntp-marks-is-evil
-@vindex nntp-marks-is-evil
-\e$BHs\e(B-@code{nil} \e$B$@$C$?$i!"$3$N%P%C%/%(%s%I$O\e(B @sc{marks} \e$B%U%!%$%k$rL5;k$7$^\e(B
-\e$B$9!#%G%#%U%)%k%H$O\e(B @code{nil} \e$B$G$9!#\e(B
-
-@item nntp-marks-directory
-@vindex nntp-marks-directory
-@acronym{NNTP} \e$B%0%k!<%W$N\e(B @sc{marks} \e$B$,3JG<$5$l$k%G%#%l%/%H%j$G$9!#\e(B
@end table
@code{nntp-end-of-line} \e$B$NCM$r\e(B @samp{\n} \e$B$KJQ99$9$kI,MW$,$"$k$G$"$m$&$3\e(B
\e$B$O\e(B @samp{("-8")} \e$B$G$9!#\e(B
@end table
+@node NNTP marks
+@subsubsection NNTP marks
+@cindex storing NNTP marks
+
+Gnus \e$B$O\e(B @acronym{NNTP} \e$B%5!<%P!<MQ$N0u\e(B (marks) \e$B$r0u%U%!%$%k$KJ]B8$7$^$9!#\e(B
+\e$B0u%U%!%$%k$O$"$k%0%k!<%W$G@_Dj$7$?0u$r5-O?$7!"$=$l$>$l$N%U%!%$%k$O!"BP1~\e(B
+\e$B$9$k%5!<%P!<$N$=$l$>$l$KBP$7$F@lMQ$G$9!#0u%U%!%$%k$O!"%K%e!<%9%5!<%P!<$K\e(B
+\e$B;w$F$$$k8EE5E*$J3,AX\e(B
+\e$B$G\e(B @file{~/News/marks} (@code{nntp-marks-directory}) \e$B$KJ]B8$5$l$^$9!#Nc\e(B
+\e$B$($P\e(B news.gmane.org \e$B%5!<%P!<$K$*$1$k\e(B @samp{gmane.discuss} \e$B%0%k!<%W$N$?$a\e(B
+\e$B$N0u%U%!%$%k\e(B
+\e$B$O\e(B @file{~/News/marks/news.gmane.org/gmane/discuss/.marks} \e$B$KJ]B8$5$l$^\e(B
+\e$B$9!#\e(B
+
+\e$B0u%U%!%$%k$OLr$KN)$A$^$9!#\e(B@file{~/News/marks} \e$B%G%#%l%/%H%j$O\e(B (rsync\e$B!"\e(B
+scp \e$B$^$?$OB>$N2?$+$r;H$C$F\e(B) Gnus \e$B$rAv$i$;$kJL$N%[%9%H$K%3%T!<$9$k$3$H$,\e(B
+\e$B$G$-!"$I$N5-;v$rFI$s$G0u$rIU$1$?$+$r$=$A$i$G:F8=$7$^$9!#\e(B
+@file{~/News/marks} \e$B$N%G!<%?$O!"\e(B@file{~/.newsrc.eld} \e$B$K$"$kF1$8$b$N$h$j\e(B
+\e$B$bM%@h$5$l$^$9!#\e(B
+
+\e$B0u%U%!%$%k$O!"$=$l$>$l$N%5!<%P!<$4$H$K!"Hs>o$KFC2=$5$l$k$3$H$KCm0U$7$F2<\e(B
+\e$B$5$$!#\e(BGnus \e$B$O5-;vHV9f$r5-21$9$k$N$G!"N>J}$N%[%9%H$GF1$8%5!<%P!<$r;H$C$F\e(B
+\e$B$$$J$$$H!"J*;v$O2u$l$F$7$^$&$G$7$g$&\e(B (\e$BBgDq$N%5!<%P!<$OB>$N$I$s$J%5!<%P!<\e(B
+\e$B$HF1$85-;vHV9f$r;H$$$^$;$s\e(B)\e$B!#$7$+$7!"$"$k%[%9%H$G%5!<%P!<\e(B A\e$B!"\e(BB\e$B!"\e(BC \e$B$r;H$$!"\e(B
+\e$BJL$N%[%9%H$G%5!<%P!<\e(B A\e$B!"\e(BD\e$B!"\e(BE \e$B$r;H$&>l9g$K$O!"\e(BA \e$B$N$?$a$N0u%U%!%$%k$rF1$8\e(B
+\e$B$K$9$k$3$H$,$G$-!"Fs$D$N%[%9%H4V$G$=$N%5!<%P!<$OF14|$7$^$9!#\e(B
+
+@acronym{NNTP} \e$B0u$N;HMQ$O@-G=$NNt2=$r>7$-!"\e(BGnus \e$B$r$N$m$/46$8$5$;$k2DG=@-\e(B
+\e$B$,$"$j$^$9!#$=$&$$$&>l9g$O\e(B @code{nntp-marks-is-evil} \e$BJQ?t$r\e(B @code{t} \e$B$K\e(B
+\e$B@_Dj$7$F$_$F2<$5$$!#$9$k$H!"0u$O\e(B @file{~/.newsrc.eld} (\e$B$@$1\e(B) \e$B$K3JG<$5$l\e(B
+\e$B$k$G$7$g$&!#\e(B
+
+\e$B4XO"$9$kJQ?t\e(B:
+
+@table @code
+@item nntp-marks-is-evil
+@vindex nntp-marks-is-evil
+\e$BHs\e(B-@code{nil} \e$B$@$C$?$i!"$3$N%P%C%/%(%s%I$O0u%U%!%$%k$rL5;k$7$^$9!#%G%#%U%)\e(B
+\e$B%k%H$O\e(B @code{nil} \e$B$G$9!#\e(B
+
+@item nntp-marks-directory
+@vindex nntp-marks-directory
+@acronym{NNTP} \e$B%0%k!<%W$N0u$,3JG<$5$l$k%G%#%l%/%H%j$G$9!#\e(B
+@end table
+
@node News Spool
@subsection \e$B%K%e!<%9%9%W!<%k\e(B
@cindex nnspool
* 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
(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
* 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
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}
@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
projects / elisp / gnus.git- / commitdiff