\e$B$3$l$,>e$G?($l$?6h@Z$jJ8;z$G$9!#%G%#%U%)%k%H$G$O\e(B @samp{^L} (\e$B%U%)!<%`\e(B
\e$B%U%#!<%I!"2~JG\e(B) \e$B$G$9!#\e(B
-@c TRANSLATEME
@cindex IDNA
-@cindex internationalized domain names
+@cindex \e$B9q:]2=%I%a%$%sL>\e(B
@vindex gnus-use-idna
@item gnus-use-idna
-This variable controls whether Gnus performs IDNA decoding of
-internationalized domain names inside @sc{From:}, @sc{To:} and
-@sc{Cc:} headers. This requires GNU Libidn
-(@url{http://www.gnu.org/software/libidn/}, and this variable is only
-enabled if you have installed it.
+\e$B$3$NJQ?t$O\e(B @sc{From:}\e$B!"\e(B@sc{To:} \e$B$*$h$S\e(B @sc{Cc:} \e$B%X%C%@!<$K$"$k9q:]2=%I%a\e(B
+\e$B%$%sL>$r!"\e(Bgnus \e$B$,\e(B IDNA \e$B%G%3!<%I$9$k$+$I$&$+$r@)8f$7$^$9!#$3$l$K$O\e(B GNU
+Libidn (@url{http://www.gnu.org/software/libidn/}) \e$B$,I,MW$G!"$3$NJQ?t$O\e(B
+\e$B$=$l$r%$%s%9%H!<%k$7$F$"$k>l9g$@$1M-8z$K$J$j$^$9!#\e(B
@end table
@node Composing Messages
\e$B$9!#\e(B
@item
-@c TRANSLATEME
-\e$B%@%&%s%m!<%IJ}?K$r7hDj$7$^$9!#\e(BIt's fairly simple once you decide whether
-you are going to use agent categories, topic parameters, and/or group
-parameters to implement your policy. If you're new to gnus, it
-is probably best to start with a category @xref{Agent Categories}.
+\e$B%@%&%s%m!<%IJ}?K$r7hDj$7$^$9!#$"$J$?$NJ}?K$r<BAu$9$k$?$a$K%(!<%8%'%s%HJ,\e(B
+\e$BN`!"%H%T%C%/%Q%i%a!<%?!"%0%k!<%W%Q%i%a!<%?$N$I$l$r;H$&$+$r$$$C$?$s7h$a$F\e(B
+\e$B$7$^$($P!"$3$l$O$+$J$j4JC1$G$9!#$"$J$?$,\e(B gnus \e$B$N=i?4<T$J$i$P!"$?$V$sJ,N`\e(B
+\e$B$G;O$a$k$N$,:GNI$G$7$g$&\e(B @xref{Agent Categories}\e$B!#\e(B
-Both topic parameters (@pxref{Topic Parameters}) and agent categories
-(@pxref{Agent Categories}) provide for setting a policy that applies
-to multiple groups. Which you use is entirely up to you. Topic
-parameters do override categories so, if you mix the two, you'll have
-to take that into account. If you have a few groups that deviate from
-your policy, you can use grou parameters (@pxref{Group Parameters}) to
-configure them.
+\e$B%H%T%C%/%Q%i%a!<%?\e(B (@pxref{Topic Parameters}) \e$B$H%(!<%8%'%s%HJ,\e(B
+\e$BN`\e(B (@pxref{Agent Categories}) \e$B$NN>J}$O!"B??t$N%0%k!<%W$KE,MQ$9$kJ}?K$N@_\e(B
+\e$BDj$rMQ0U$7$F$$$^$9!#$I$l$r;H$&$+$O40A4$K$"$J$?$N@UG$$G$9!#N>J}$r:.$<$F;H\e(B
+\e$B$&>l9g$O!"%H%T%C%/%Q%i%a!<%?$OJ,N`$rL58z$K$9$k$3$H$r9MN8$KF~$l$J$1$l$P$J\e(B
+\e$B$i$J$$$G$7$g$&!#$"$J$?$NJ}?K$K$=$0$o$J$$>/?t$N%0%k!<%W$,$"$k$N$J$i$P!"$=\e(B
+\e$B$l$i$N@_Dj$rJQ99$9$k$?$a$K%0%k!<%W%Q%i%a!<\e(B
+\e$B%?\e(B (@pxref{Group Parameters}) \e$B$r;H$&$3$H$,$G$-$^$9!#\e(B
@item
\e$B$($($H\e(B@dots{}\e$B!"0J>e$G$9!#\e(B
\e$B$O\e(B @code{\e$B=i4|\e(B} \e$BJ,N`$KB0$7$^$9!#\e(BGnus \e$B$OJ,N`$N:n@.$H4IM}$N$?$a$NFH<+$N%P%C\e(B
\e$B%U%!!<$r;}$C$F$$$^$9!#\e(B
-@c TRANSLATEME
-If you prefer, you can also use group parameters (@pxref{Group
-Parameters}) and topic parameters (@pxref{Topic Parameters}) for an
-alternative approach to controlling the agent. The only real
-difference is that categories are specific to the agent (so there is
-less to learn) while group and topic parameters include the kitchen
-sink.
-
-Since you can set agent parameters in several different places we have
-a rule to decide which source to believe. This rule specifies that
-the parameter sources are checked in the following order: group
-parameters, topic parameters, agent category, and finally customizable
-variables. So you can mix all of these sources to produce a wide range
-of behavior, just don't blame me if you don't remember where you put
-your settings.
+\e$B$b$7$=$&$7$?$1$l$P!"%0%k!<%W%Q%i%a!<%?\e(B (@pxref{Group Parameters}) \e$B$H%H%T%C\e(B
+\e$B%/%Q%i%a!<%?\e(B (@pxref{Topic Parameters}) \e$B$r!"%(!<%8%'%s%H$r@)8f$9$kBeBX<j\e(B
+\e$BCJ$K;H$&$3$H$,$G$-$^$9!#<B:]$K0c$&$N$O!"%0%k!<%W$H%H%T%C%/%Q%i%a!<%?$,2?\e(B
+\e$B$G$b$+$s$G$b\e(B (kitchen sink) \e$B4^$`$N$KBP$7$F!"J,N`$O%(!<%8%'%s%H$KFC2=$7$F\e(B
+\e$B$$$k\e(B (\e$B$7$?$,$C$F$"$^$j3X$P$J$/$F$bNI$$\e(B) \e$B$H$$$&$3$H$@$1$G$9!#\e(B
+
+\e$B%(!<%8%'%s%H%Q%i%a!<%?$OJ#?t$N0c$&>l=j$G@_Dj$9$k$3$H$,$G$-$k$N$G!"$I$N%=!<\e(B
+\e$B%9$,?.MQ$G$-$k$+$r7h$a$k$?$a$N5,B'$r@_$1$^$7$?!#$3$N5,B'$O!"%Q%i%a!<%?$N\e(B
+\e$B%=!<%9$,<!$N=g=x$GD4$Y$i$l$k$3$H$rDj$a$^$9\e(B: \e$B%0%k!<%W%Q%i%a!<%?!"%H%T%C%/\e(B
+\e$B%Q%i%a!<%?!"%(!<%8%'%s%HJ,N`!"$=$7$F:G8e$O%+%9%?%^%$%:$G$-$kJQ?t72$G$9!#\e(B
+\e$B$7$?$,$C$F!"9-$$HO0O$GF0:n$r5/$3$5$;$k$?$a$K$3$l$i$N%=!<%9$r$9$Y$F:.9g$9\e(B
+\e$B$k$3$H$,$G$-$^$9!#$I$3$K@_Dj$rCV$$$?$N$+$rK:$l$F$7$^$C$?$+$i$H$$$C$F!";d\e(B
+\e$B$r@U$a$J$$$G2<$5$$$h!#\e(B
@menu
* Category Syntax:: \e$BJ,N`$H$O$I$s$J$b$N$+\e(B
@node Category Syntax
@subsubsection \e$BJ,N`$NJ8K!\e(B
-@c TRANSLATEME
-\e$BJ,N`$O\e(B ** \e$B$N$b$N$+$i$J$j$^$9!#\e(B
-A category consists of a name, the list of groups belonging to the
-category, and a number of optional parameters that override the
-customizable variables. The complete list of agent parameters are
-listed below.
+\e$BJ,N`$O!"L>A0!"$=$NJ,N`$KB0$9$k%0%k!<%W$N%j%9%H!"$*$h$S%+%9%?%^%$%:2DG=$J\e(B
+\e$BJQ?t$r>e=q$-$9$kB?$/$NG$0U$J%Q%i%a!<%?$+$i@.$j$^$9!#%(!<%8%'%s%H%Q%i%a!<\e(B
+\e$B%?$N40A4$J%j%9%H$r0J2<$K<($7$^$9!#\e(B
@table @code
@item gnus-agent-cat-name
\e$B5,B'!#\e(B(\e$B$3$N%@%&%s%m!<%I%9%3%"\e(B (@dfn{download score}) \e$B$ODL>o$N%9%3%"$H$O\e(B
\e$BI,$:$7$b4X78$,L5$$$3$H$KCm0U$7$F$/$@$5$$!#\e(B)
-@c TRANSLATEME
@item gnus-agent-cat-enable-expiration
-a boolean indicating whether the agent should expire old articles in
-this group. Most groups should be expired to conserve disk space. In
-fact, its probably safe to say that the gnus.* hierarchy contains the
-only groups that should not be expired.
+\e$B$3$N%0%k!<%W$N8E$$5-;v$r%(!<%8%'%s%H$,4|8B@Z$l>C5n$9$Y$-$+$I$&$+$r<($9\e(B
+\e$B%V!<%kJQ?t!#BgDq$N%0%k!<%W$O%G%#%9%/6u4V$rO2Hq$7$J$$$?$a$K4|8B@Z$l>C5n$5\e(B
+\e$B$l$k$Y$-$G$9!#$$$d!"<B:]$K$O\e(B gnus.* \e$B3,AX$O4|8B@Z$l>C5n$5$l$k$Y$-$G$O$J\e(B
+\e$B$$%0%k!<%W$@$1$r4^$s$G$$$k$H8@$C$F$b!"$?$V$s:9$7;Y$($"$j$^$;$s!#\e(B
@item gnus-agent-cat-days-until-old
-an integer indicating the number of days that the agent should wait
-before deciding that a read article is safe to expire.
+\e$B4{FI$N5-;v$r4|8B@Z$l>C5n$7$F$b:9$7;Y$($J$$$3$H$rH=CG$9$kA0$K!"%(!<%8%'%s\e(B
+\e$B%H$,BT$C$F$$$k$Y$-F|?t$r<($9@0?t!#\e(B
@item gnus-agent-cat-low-score
-an integer that overrides the value of @code{gnus-agent-low-score}.
+@code{gnus-agent-low-score} \e$B$r>e=q$-$9$k@0?t!#\e(B
@item gnus-agent-cat-high-score
-an integer that overrides the value of @code{gnus-agent-high-score}.
+@code{gnus-agent-high-score} \e$B$r>e=q$-$9$k@0?t!#\e(B
@item gnus-agent-cat-length-when-short
-an integer that overrides the value of
-@code{gnus-agent-short-article}.
+@code{gnus-agent-short-article} \e$B$r>e=q$-$9$k@0?t!#\e(B
@item gnus-agent-cat-length-when-long
-an integer that overrides the value of @code{gnus-agent-long-article}.
+@code{gnus-agent-long-article} \e$B$r>e=q$-$9$k@0?t!#\e(B
@end table
-The name of a category can not be changed once the category has been
-created.
+\e$B$$$C$?$sJ,N`$,:n$i$l$?$i!"J,N`$NL>A0$rJQ$($k$3$H$O$G$-$^$;$s!#\e(B
-Each category maintains a list of groups that are exclusive members of
-that category. The exclusivity rule is automatically enforced, add a
-group to a new category and it is automatically removed from its old
-category.
+\e$B$=$l$>$l$NJ,N`$O!"$=$NJ,N`$N8B$i$l$?%a%s%P!<$G$"$k%0%k!<%W$N%j%9%H$r0];}\e(B
+\e$B$7$^$9!#8B$i$l$?5,B'$O<+F0E*$K<99T$5$l$^$9!#?7$7$$J,N`$K%0%k!<%W$rDI2C$9\e(B
+\e$B$k$H!"$=$l$O8E$$J,N`$+$i<+F0E*$K<h$j=|$+$l$^$9!#\e(B
\e$B=R8l$N0lHVC1=c$J7A<0$O\e(B @code{true} \e$B$d\e(B @code{false} \e$B$N$h$&$JC1FH$N=R8l$+\e(B
\e$B$i$J$j$^$9!#$3$l$i$NFs$D$O$=$l$>$l!"A4$F$N2DG=$J5-;v$r%@%&%s%m!<%I$9$k$+!"\e(B
\e$B0J2<$N=R8l$O$"$i$+$8$aDj5A$5$l$F$$$^$9$,!"$3$l$i$N$I$l$b$"$J$?$N$d$j$?$$\e(B
\e$B$3$H$K0lCW$7$J$1$l$P!"<+J,$GFH<+$N$b$N$r=q$/$3$H$b$G$-$^$9!#\e(B
-@c TRANSLATEME
-When evaluating each of these predicates, the named constant will be
-bound to the value determined by calling
-@code{gnus-agent-find-parameter} on the appropriate parameter. For
-example, gnus-agent-short-article will be bound to
-@code{(gnus-agent-find-parameter group 'agent-short-article)}. This
-means that you can specify a predicate in your category then tune that
-predicate to individual groups.
+\e$B$=$l$>$l$N$3$l$i$N=R8l$rI>2A$9$k$H$-!"L>A0$,IU$1$i$l$?Dj?t$O!"E,@Z$J%Q%i\e(B
+\e$B%a!<%?$N85$K\e(B @code{gnus-agent-find-parameter} \e$B$r8F$V$3$H$K$h$C$F7hDj$5$l\e(B
+\e$B$?CM$GB+G{$5$l$^$9!#Nc$(\e(B
+\e$B$P\e(B gnus-agent-short-article \e$B$O\e(B @code{(gnus-agent-find-parameter group
+'agent-short-article)} \e$B$KB+G{$5$l$^$9!#$3$l$O!"$"$J$?$,$"$J$?$NJ,N`$G=R\e(B
+\e$B8l$r;XDj$7$F$+$i!"$=$N=R8l$r8D!9$N%0%k!<%W$K$D$$$FD4@0$G$-$k$3$H$r0UL#$7\e(B
+\e$B$^$9!#\e(B
@table @code
@item short
@findex gnus-category-exit
\e$B%0%k!<%W%P%C%U%!!<$KLa$k\e(B (@code{gnus-category-exit})\e$B!#\e(B
-@c TRANSLATEME
@item e
-@kindex e (Category)
+@kindex e (\e$BJ,N`\e(B)
@findex gnus-category-customize-category
+\e$BA*Br$5$l$?J,N`$N%Q%i%a!<%?$r0l3g$7$F@_Dj$9$k$?$a$K!"%+%9%?%^%$%:%P%C%U%!\e(B
+\e$B$r;H$$$^$9\e(B (@code{gnus-category-customize-category})\e$B!#\e(B
+
Use a customization buffer to set all of the selected category's
parameters at one time (@code{gnus-category-customize-category}).
@vindex gnus-agent-high-score
\e$B$3$NCM$h$jBg$-$$%9%3%"$r;}$D5-;v$O9b%9%3%"$G$"$k!#=i4|@_DjCM$O\e(B 0\e$B!#\e(B
-@c TRANSLATEME
@item gnus-agent-expire-days
@vindex gnus-agent-expire-days
-The number of days that a @samp{read} article must stay in the agent's
-local disk before becoming eligible for expiration (While the name is
-the same, this doesn't mean expiring the article on the server. It
-just means deleting the local copy of the article). What is also
-important to understand is that the counter starts with the time the
-article was written to the local disk and not the time the article was
-read.
-Default 7.
+\e$B4|8B@Z$l>C5n$K$U$5$o$7$/$J$k$^$G4{FI5-;v$r%(!<%8%'%s%H$N%m!<%+%k%G%#%9%/\e(B
+\e$B$KN1$a$F$*$/F|?t\e(B (\e$B$G$bL>A0$,F1$8$@$C$?$i!"$3$l$O$=$N%5!<%P!<$K$*$1$k4|8B\e(B
+\e$B@Z$l>C5n$r0UL#$7$^$;$s!#$=$l$OC1$K5-;v$N%m!<%+%k$JJ#@=$r>C$9$3$H$r0UL#$7\e(B
+\e$B$^$9\e(B)\e$B!#$5$i$KM}2r$9$Y$-Bg;v$J$3$H$O!"5-;v$,FI$^$l$?;~$G$O$J$/%m!<%+%k%G%#\e(B
+\e$B%9%/$K5-;v$,=q$+$l$?;~$+$i7W?t$,;O$^$k$H$$$&$3$H$G$9!#%G%#%U%)%k%H$O\e(B 7\e$BF|!#\e(B
@item gnus-agent-enable-expiration
@vindex gnus-agent-enable-expiration
-Determines whether articles in a group are, by default, expired or
-retained indefinitely. The default is @code{ENABLE} which means that
-you'll have to disable expiration when desired. On the other hand,
-you could set this to @code{DISABLE}. In that case, you would then
-have to enable expiration in selected groups.
+\e$B%0%k!<%W$N5-;v$,!"%G%#%U%)%k%H$G4|8B@Z$l>C5n$5$l$k$+!"L54|8B$KJ];}$5$l$k\e(B
+\e$B$+$r7hDj$7$^$9!#%G%#%U%)%k%H$O\e(B @code{ENABLE} \e$B$G!"K>$`$J$i$P4|8B@Z$l>C5n\e(B
+\e$B$r$5$;$J$$$h$&$K$7$J$1$l$P$J$i$J$$$3$H$r0UL#$7$^$9!#0lJ}!"$3$l\e(B
+\e$B$r\e(B @code{DISABLE} \e$B$K@_Dj$9$k$3$H$,$G$-$^$9!#$=$N>l9g!"A*Br$5$l$?%0%k!<%W\e(B
+\e$B$G$N4|8B@Z$l>C5n$rM-8z$K$7$J$1$l$P$J$j$^$;$s!#\e(B
@end table
@node Agent Commands
\e$B$s$,!"$9$G$K%(!<%8%'%s%H$K%@%&%s%m!<%I$7$?5-;v$,$"$k$J$i$P!"\e(Bgnus \e$B$O%5!<\e(B
\e$B%P!<$+$i:F$S5-;v$r%@%&%s%m!<%I$;$:$K!"<j85$K3JG<$5$l$?%3%T!<$r;H$$$^$9!#\e(B
-@c TRANSLATEME
-If you so desire, you can configure the agent (see @code{gnus-agent-cache}
-@pxref{Agent Variables}) to always download headers and articles while
-plugged. Gnus will almost certainly be slower, but it will be kept
-synchronized with the server. That last point probably won't make any
-sense if you are using a nntp or nnimap backend.
+\e$B$"$J$?$,$=$&K>$`$N$G$"$l$P!"\e(B@dfn{plugged} \e$B$J4|4V$O>o$K%X%C%@!<$H5-;v$r%@\e(B
+\e$B%&%s%m!<%I$9$k$h$&$K!"%(!<%8%'%s%H\e(B (@code{gnus-agent-cache} \e$B;2\e(B
+\e$B>H\e(B @pxref{Agent Variables}) \e$B$r@_Dj$9$k$3$H$,$G$-$^$9!#\e(Bgnus \e$B$O$[$H$s$I3N\e(B
+\e$B$+$K$b$C$HCY$/$J$j$^$9$,!"%5!<%P!<$H$NF14|$OJ]$?$l$^$9!#\e(B
+nntp \e$B$+\e(B nnimap \e$B%P%C%/%(%s%I$r;H$C$F$$$k>l9g$O!"$?$V$s$3$N:G8e$NE@$O0UL#\e(B
+\e$B$r$J$5$J$$$G$7$g$&!#\e(B
@node Agent Expiry
@subsection \e$B%(!<%8%'%s%H4|8B@Z$l>C5n\e(B
\e$B$NJQ?t$NB>$NA*Br;h$K$O\e(B @code{denied} \e$B$H\e(B @code{offline} \e$B$,$"$j!"%(!<%8%'\e(B
\e$B%s%H$,;H$o$l$k>l9g$O8e<T$@$1$,M-8z$G$9!#\e(B
-@c TRANSLATEME
@item gnus-auto-goto-ignores
@vindex gnus-auto-goto-ignores
-Another variable that isn't a Agent variable, yet so closely related
-that most will look for it here, this variable tells the summary
-buffer how to maneuver around undownloaded (only headers stored in the
-agent) and unfetched (neither article nor headers stored) articles.
-
-The legal values are @code{nil} (maneuver to any article),
-@code{undownloaded} (maneuvering while unplugged ignores articles that
-have not been fetched), @code{always-undownloaded} (maneuvering always
-ignores articles that have not been fetched), @code{unfetched}
-(maneuvering ignores articles whose headers have not been fetched).
+\e$BBgDq$N?M$O!"%(!<%8%'%s%HJQ?t$G$O$J$$$,L)@\$K4XO"$9$k$b$&0l$D$NJQ?t$r$3$3\e(B
+\e$B$GC5$9$G$7$g$&!#$3$NJQ?t$O!"%@%&%s%m!<%I$5$l$F$$$J$$\e(B (\e$B%X%C%@!<$@$1$,%(!<\e(B
+\e$B%8%'%s%H$K3JG<$5$l$?\e(B)\e$B!"$=$7$F<h$j9~$^$l$F$$$J$$\e(B (\e$B5-;v$b%X%C%@!<$b3JG<$5\e(B
+\e$B$l$F$$$J$$\e(B) \e$B5-;v$r$I$&A`:n$9$k$+$r35N,%P%C%U%!$KEA$($^$9!#\e(B
+
+\e$B@5Ev$JCM$O\e(B @code{nil} (\e$B$I$N5-;v$bA`:n$9$k\e(B)\e$B!"\e(B
+@code{undownloaded} (@dfn{unplugged} \e$B$J4|4V$NA`:n$O<h$j9~$^$l$F$$$J$$5-\e(B
+\e$B;v$rL5;k$9$k$3$H\e(B)\e$B!"\e(B@code{always-undownloaded} (\e$BA`:n$O<h$j9~$^$l$F$$$J$$\e(B
+\e$B5-;v$r>o$KL5;k$9$k$3$H\e(B)\e$B!"\e(B@code{unfetched} (\e$BA`:n$O%X%C%@!<$,<h$j9~$^$l$F\e(B
+\e$B$$$J$$5-;v$rL5;k$9$k$3$H\e(B) \e$B$G$9!#\e(B(\e$BLuCm\e(B: \e$B$&!<$`\e(B Kevin \e$B$5$s$O2?$r8@$C$F$k$s\e(B
+\e$B$@\e(B?)
@end table
@node Example Setup
projects / elisp / gnus.git- / commitdiff