nnir
-* What is nnir:: nnir \e$B$O2?$r$9$k$+\e(B
+* What is nnir:: nnir \e$B$O2?$r$9$k$+\e(B?
* Basic Usage:: \e$B4JC1$J8!:w$N$7$+$?\e(B
* Setting up nnir:: nnir \e$B$N@_DjJ}K!\e(B
Setting up nnir
-* Associating Engines:: \e$B%(%s%8%s$H$N4XO"IU$1\e(B
+* Associating Engines:: \e$B%(%s%8%s$H4XO"IU$1$kJ}K!\e(B
Various
@chapter \e$B8!:w\e(B
@cindex searching
-@c TRANSLATEME>
-FIXME: Add a brief overview of Gnus search capabilities. A brief
-comparison of nnir, nnmairix, contrib/gnus-namazu would be nice
-as well.
+FIXME: Gnus \e$B$N8!:w5!G=$K4X$9$kC;$$35MW$rDI2C!#\e(Bnnir, nnmairix,
+contrib/gnus-namazu \e$B$N4J7i$JHf3S$b$^$?NI$7!#\e(B
-This chapter describes tools for searching groups and servers for
-articles matching a query and then retrieving those articles. Gnus
-provides a simpler mechanism for searching through articles in a summary buffer
-to find those matching a pattern. @xref{Searching for Articles}.
-@c TRANSLATEME<
+\e$B$3$N>O$O!"$"$k8l$K9gCW$9$k5-;v$r%0%k!<%W$*$h$S%5!<%P!<$G8!:w$7$F$=$l$i$N\e(B
+\e$B5-;v$r<hF@$9$k$?$a$NF;6q$K$D$$$F@bL@$7$^$9!#\e(BGnus \e$B$O$=$l$i$N9gCW%Q%?!<%s\e(B
+\e$B$r35N,%P%C%U%!!<$N5-;v$?$A$rDL$7$F8!:w$9$k!"$h$jC1=c$J5!9=$rDs6!$7$^$9!#\e(B
+@xref{Searching for Articles}.
@menu
* nnir:: \e$B$$$m$s$J%(%s%8%s$G8!:w$9$k\e(B
* nnmairix:: Mairix \e$B$G8!:w$9$k\e(B
@end menu
-@c TRANSLATEME>
@node nnir
@section nnir
@cindex nnir
-This section describes how to use @code{nnir} to search for articles
-within gnus.
+\e$B$3$N9`$O\e(B @code{nnir} \e$B$r;H$C$F\e(B Gnus \e$B$N5-;v$r8!:w$9$k$d$jJ}$r@bL@$7$^$9!#\e(B
@menu
-* What is nnir:: What does nnir do?
-* Basic Usage:: How to perform simple searches.
-* Setting up nnir:: How to set up nnir.
+* What is nnir:: nnir \e$B$O2?$r$9$k$+\e(B?
+* Basic Usage:: \e$B4JC1$J8!:w$N$7$+$?\e(B
+* Setting up nnir:: nnir \e$B$N@_DjJ}K!\e(B
@end menu
@node What is nnir
-@subsection What is nnir
+@subsection nnir \e$B$H$O\e(B?
-@code{nnir} is a gnus interface to a number of tools for searching
-through mail and news repositories. Different backends (like
-@code{nnimap} and @code{nntp}) work with different tools (called
-@dfn{engines} in nnir lingo), but all use the same basic search
-interface.
+@code{nnir} \e$B$O%a!<%k$H%K%e!<%9$NAR8K$r8!:w$9$k$?$a$N?t$"$kF;6q$X\e(B
+\e$B$N\e(B Gnus \e$B$N%$%s%?!<%U%'!<%9$G$9!#0[$J$k%P%C%/%(%s\e(B
+\e$B%I\e(B (\e$BNc$($P\e(B @code{nnimap} \e$B$H\e(B @code{nntp}) \e$B$O0[$J$kF;6q\e(B (nnir \e$BMQ8l$G8@$&$H\e(B
+\e$B$3$m$N\e(B @dfn{\e$B%(%s%8%s\e(B}) \e$B$GF0:n$7$^$9$,!"$9$Y$FF1$84pK\E*$J8!:w%$%s%?!<%U%'!<\e(B
+\e$B%9$r;H$$$^$9!#\e(B
-The @code{nnimap} and @code{gmane} search engines should work with no
-configuration. Other engines require a local index that needs to be
-created and maintained outside of Gnus.
+@code{nnimap} \e$B$*$h$S\e(B @code{gmane} \e$B8!:w%(%s%8%s$O@_DjL5$7$GF0$/$O$:$G$9!#\e(B
+\e$BB>$N%(%s%8%s$O%m!<%+%k$J:w0z$rI,MW$H$7$^$9!#$=$l$O\e(B Gnus \e$B$N30$G:n$j!"$+$D\e(B
+\e$B0];}$7$J$1$l$P$J$j$^$;$s!#\e(B
@node Basic Usage
-@subsection Basic Usage
-
-In the group buffer typing @kbd{G G} will search the group on the
-current line by calling @code{gnus-group-make-nnir-group}. This prompts
-for a query string, creates an ephemeral @code{nnir} group containing
-the articles that match this query, and takes you to a summary buffer
-showing these articles. Articles may then be read, moved and deleted
-using the usual commands.
-
-The @code{nnir} group made in this way is an @code{ephemeral} group, and
-some changes are not permanent: aside from reading, moving, and
-deleting, you can't act on the original article. But there is an
-alternative: you can @emph{warp} to the original group for the article
-on the current line with @kbd{A W}, aka
-@code{gnus-warp-to-article}. Even better, the function
-@code{gnus-summary-refer-thread}, bound by default in summary buffers to
-@kbd{A T}, will first warp to the original group before it works its
-magic and includes all the articles in the thread. From here you can
-read, move and delete articles, but also copy them, alter article marks,
-whatever. Go nuts.
-
-You say you want to search more than just the group on the current line?
-No problem: just process-mark the groups you want to search. You want
-even more? Calling for an nnir search with the cursor on a topic heading
-will search all the groups under that heading.
-
-Still not enough? OK, in the server buffer
-@code{gnus-group-make-nnir-group} (now bound to @kbd{G}) will search all
-groups from the server on the current line. Too much? Want to ignore
-certain groups when searching, like spam groups? Just customize
-@code{nnir-ignored-newsgroups}.
-
-One more thing: individual search engines may have special search
-features. You can access these special features by giving a prefix-arg
-to @code{gnus-group-make-nnir-group}. If you are searching multiple
-groups with different search engines you will be prompted for the
-special search features for each engine separately.
+@subsection \e$B4pK\E*$J;H$$J}\e(B
+
+\e$B%0%k!<%W%P%C%U%!!<$G\e(B @kbd{G G} \e$B$r%?%$%W$9$k$H!"\e(B
+@code{gnus-group-make-nnir-group} \e$B$r8F$V$3$H$K$h$C$F8=:_9T$N%0%k!<%W$r8!\e(B
+\e$B:w$7$^$9!#$3$l$O8!:w8l$NF~NO$rB%$7$F!"$=$l$K9gCW$9$k5-;v$r4^$`0l;~E*$J\e(B
+@code{nnir} \e$B%0%k!<%W$r:n$j!"$=$l$i$N5-;v$,$"$k35N,%P%C%U%!!<$rI=<($7$^$9!#\e(B
+\e$B$=$&$7$?$i!"8e$O$$$D$b$N%3%^%s%I$r;H$C$F5-;v$rFI$s$@$j!"0\F0$7$?$j!":o=|\e(B
+\e$B$7$?$j$9$l$PNI$$$N$G$9!#\e(B
+
+\e$B$3$N$h$&$K:n$i$l$?\e(B @code{nnir} \e$B%0%k!<%W$O0l;~E*\e(B (@code{ephemeral}) \e$B$J%0\e(B
+\e$B%k!<%W$J$N$G!"4{FI!"0\F0$*$h$S:o=|$OJL$H$7$F!"$$$/$D$+$NJQ99$O1JB3$7$^$;\e(B
+\e$B$s!#$D$^$j85$N5-;v$K<j$r2C$($k$3$H$O$G$-$^$;$s!#$7$+$7Be$o$j$N<j$,$"$j$^\e(B
+\e$B$9!#\e(B@kbd{A W} (@code{gnus-warp-to-article}) \e$B$G!"8=:_9T$N5-;v$N85$N5-;v\e(B
+\e$B$K\e(B @emph{\e$B%o!<%W\e(B} \e$B$G$-$k$N$G$9!#$5$i$KNI$$$N$O35N,%P%C%U%!!<\e(B
+\e$B$G\e(B @kbd{A T} \e$B$K%G%#%U%)%k%H$G3d$jEv$F$i$l$F$$$k4X\e(B
+\e$B?t\e(B @code{gnus-summary-refer-thread} \e$B$G!"$=$l$O$=$NKbK!$r9T$J$&A0!":G=i$K\e(B
+\e$B85$N%0%k!<%W$K%o!<%W$7$F!"$=$N%9%l%C%I$K$"$k$9$Y$F$N5-;v$r4^$a$^$9!#$=$3\e(B
+\e$B$+$i5-;v$rFI$_!"0\F0$7!"$^$?:o=|$G$-$k$@$1$G$J$/!"$=$l$i$r%3%T!<$7$?$j!"\e(B
+\e$B0u$rJQ99$7$?$j!"$=$NB>2?$G$b$G$-$^$9!#$"$"!"F,$,$*$+$7$/$J$j$=$&\e(B (\e$B86\e(B
+\e$BE5\e(B: ``Go nuts'')\e$B!#\e(B
+
+\e$B8=:_9T$N%0%k!<%W$@$1$G$J$/!"B>$N%0%k!<%W$b8!:w$7$?$$$G$9$C$F\e(B? \e$BLdBj$"$j\e(B
+\e$B$^$;$s!#C1$K8!:w$7$?$$%0%k!<%W$K%W%m%;%90u$rIU$1$F$/$@$5$$!#$5$i$K$b$C\e(B
+\e$B$H\e(B? \e$B$=$l$J$i%H%T%C%/$N8+=P$7$K%+!<%=%k$rCV$$$F\e(B nnor \e$B8!:w$r<B9T$9$l$P!"\e(B
+\e$B$=$N8+=P$7$N2<$N$9$Y$F$N%0%k!<%W$r8!:w$7$F$/$l$k$G$7$g$&!#\e(B
+
+\e$B$^$@B-$j$J$$$s$G$9$+\e(B? \e$B$h$m$7$$!"%5!<%P!<%P%C%U%!!<\e(B
+\e$B$G\e(B @code{gnus-group-make-nnir-group} (\e$B8=:_$O\e(B @kbd{G} \e$B$K3d$jEv$F$i$l$F$$\e(B
+\e$B$k\e(B) \e$B$r;H$($P!"8=:_9T$N%5!<%P!<$K$"$k$9$Y$F$N%0%k!<%W$r8!:w$G$-$^$9!#B?$9\e(B
+\e$B$.$^$9$+\e(B? \e$B8!:w$9$k:]$K\e(B spam \e$B%0%k!<%W$N$h$&$J%0%k!<%W$rL5;k$7$?$$$H$$$&\e(B
+\e$B$3$H$G$9$M\e(B? \e$B$G$"$l$P\e(B @code{nnir-ignored-newsgroups} \e$B$r%+%9%?%^%$%:$7$F\e(B
+\e$B$/$@$5$$!#\e(B
+
+\e$B$5$i$K$b$&0l$D!#8D!9$N8!:w%(%s%8%s$OFCJL$J8!:w5!G=$r;}$C$F$$$k$+$b$7$l$^\e(B
+\e$B$;$s!#$=$l$i$NFCJL$J8!:w5!G=$O!"\e(B@code{gnus-group-make-nnir-group} \e$B$K@\F,\e(B
+\e$B0z?t$rM?$($k$3$H$K$h$C$FMxMQ$G$-$^$9!#$b$7J#?t$N%0%k!<%W$r0[$J$k8!:w%(%s\e(B
+\e$B%8%s$G8!:w$9$k$N$G$"$l$P!"$=$l$>$l$N%(%s%8%sKh$KJL$l$FFCJL$J8!:w5!G=$r;H\e(B
+\e$B$&$+$I$&$+$r?R$M$i$l$k$G$7$g$&!#\e(B
@node Setting up nnir
-@subsection Setting up nnir
+@subsection nnir \e$B$N@_DjJ}K!\e(B
-To set up nnir you may need to do some prep work. Firstly, you may need
-to configure the search engines you plan to use. Some of them, like
-@code{imap} and @code{gmane}, need no special configuration. Others,
-like @code{namazu} and @code{swish}, require configuration as described
-below. Secondly, you need to associate a search engine with a server or
-a backend.
+nnir \e$B$r@_Dj$9$k$K$O!"$$$/$i$+=`Hw:n6H$,I,MW$G$9!#$^$:!";H$*$&$H;W$C$F$$\e(B
+\e$B$k8!:w%(%s%8%s$r@_Dj$7$^$7$g$&!#$=$l$i$N$&$A$N$$$/$D$+!"Nc$(\e(B
+\e$B$P\e(B @code{imap} \e$B$H\e(B @code{gmane} \e$B$K$D$$$F$OFCJL$J@_Dj$OMW$j$^$;$s!#B>$N!"\e(B
+\e$BNc$($P\e(B @code{namazu} \e$B$H\e(B @code{swish} \e$B$K$D$$$F$O8e=R$N@_Dj$,I,MW$G$9!#<!\e(B
+\e$B$K!"%5!<%P!<$^$?$O%P%C%/%(%s%I$H8!:w%(%s%8%s$r4XO"IU$1$kI,MW$,$"$j$^$9!#\e(B
-If you just want to use the @code{imap} engine to search @code{nnimap}
-servers, and the @code{gmane} engine to search @code{gmane} then you
-don't have to do anything. But you might want to read the details of the
-query language anyway.
+\e$B$b$7C1$K\e(B @code{nnimap} \e$B%5!<%P!<$r8!:w$9$k$?$a$K\e(B @code{imap} \e$B%(%s%8%s$r!"\e(B
+\e$B$=$7$F\e(B @code{gmane} \e$B$r8!:w$9$k$?$a$K\e(B @code{gmane} \e$B%(%s%8%s$r;H$$$?$$$N$G\e(B
+\e$B$"$l$P!"2?$b$9$kI,MW$O$"$j$^$;$s!#$7$+$7$J$,$i8!:w8l$N=q$-J}$N>\:Y@bL@$O!"\e(B
+\e$B$H$K$+$/FI$`I,MW$,$"$k$G$7$g$&!#\e(B
@menu
-* Associating Engines:: How to associate engines.
-* The imap Engine:: Imap configuration and usage.
-* The gmane Engine:: Gmane configuration and usage.
-* The swish++ Engine:: Swish++ configuration and usage.
-* The swish-e Engine:: Swish-e configuration and usage.
-* The namazu Engine:: Namazu configuration and usage.
-* The hyrex Engine:: Hyrex configuration and usage.
-* Customizations:: User customizable settings.
+* Associating Engines:: \e$B%(%s%8%s$H4XO"IU$1$kJ}K!\e(B
+* The imap Engine:: Imap \e$B$N@_Dj$H;H$$J}\e(B
+* The gmane Engine:: Gmane \e$B$N@_Dj$H;H$$J}\e(B
+* The swish++ Engine:: Swish++ \e$B$N@_Dj$H;H$$J}\e(B
+* The swish-e Engine:: Swish-e \e$B$N@_Dj$H;H$$J}\e(B
+* The namazu Engine:: Namazu \e$B$N@_Dj$H;H$$J}\e(B
+* The hyrex Engine:: Hyrex \e$B$N@_Dj$H;H$$J}\e(B
+* Customizations:: \e$B%+%9%?%^%$%:$G$-$k@_Dj\e(B
@end menu
@node Associating Engines
-@subsubsection Associating Engines
+@subsubsection \e$B%(%s%8%s$H$N4XO"IU$1\e(B
-When searching a group, @code{nnir} needs to know which search engine to
-use. You can configure a given server to use a particular engine by
-setting the server variable @code{nnir-search-engine} to the engine
-name. For example to use the @code{namazu} engine to search the server
-named @code{home} you can use
+\e$B%0%k!<%W$r8!:w$9$k$H$-$K\e(B @code{nnir} \e$B$O$I$N8!:w%(%s%8%s$r;H$&$+$rCN$C$F\e(B
+\e$B$$$kI,MW$,$"$j$^$9!#%5!<%P!<JQ?t\e(B @code{nnir-search-engine} \e$B$r%(%s%8%s$N\e(B
+\e$BL>A0$K@_Dj$9$k$3$H$K$h$C$F!"=jDj$N%5!<%P!<$,FCDj$N%(%s%8%s$r;H$&$h$&$K@_\e(B
+\e$BDj$7$F$/$@$5$$!#Nc$($P\e(B @code{home} \e$B$H$$$&L>A0$N%5!<%P!<$r8!:w$9$k$?$a\e(B
+\e$B$K\e(B @code{namazu} \e$B%(%s%8%s$r;H$&$K$O0J2<$N$h$&$K$7$^$9\e(B:
@lisp
(setq gnus-secondary-select-methods '(
(nnir-search-engine namazu))))
@end lisp
-Alternatively you might want to use a particular engine for all servers
-with a given backend. For example, you might want to use the @code{imap}
-engine for all servers using the @code{nnimap} backend. In this case you
-can customize the variable @code{nnir-method-default-engines}. This is
-an alist of pairs of the form @code{(backend . engine)}. By default this
-variable is set to use the @code{imap} engine for all servers using the
-@code{nnimap} backend, and the @code{gmane} backend for @code{nntp}
-servers. (Don't worry, the @code{gmane} search engine won't actually try
-to search non-gmane @code{nntp} servers.) But if you wanted to use
-@code{namazu} for all your servers with an @code{nnimap} backend you
-could change this to
+\e$B$"$k$$$O!"0l$D$N%P%C%/%(%s%I$,$^$+$J$&$9$Y$F$N%5!<%P!<$N$?$a$K!"FCDj$N0l\e(B
+\e$B$D$N%(%s%8%s$r;H$&I,MW$,$"$k$+$b$7$l$^$;$s!#Nc$($P\e(B @code{nnimap} \e$B%P%C%/\e(B
+\e$B%(%s%I$r;H$&$9$Y$F$N%5!<%P!<$G\e(B @code{imap} \e$B%(%s%8%s$r;H$$$?$$>l9g$G$9!#\e(B
+\e$B$=$N>l9g$OJQ?t\e(B @code{nnir-method-default-engines} \e$B$r%+%9%?%^%$%:$7$F$/$@\e(B
+\e$B$5$$!#$3$l$O\e(B @code{(backend . engine)} \e$B7A<0$N%Z%"$NO"A[%j%9%H$G$9!#$3$N\e(B
+\e$BJQ?t$O%G%#%U%)%k%H$G$O\e(B @code{nnimap} \e$B%P%C%/%(%s%I$r;H$&$9$Y$F$N%5!<%P!<\e(B
+\e$B$G\e(B @code{imap} \e$B%(%s%8%s$r!"$=$7$F\e(B @code{nntp} \e$B%5!<%P!<$K\e(B
+\e$B$O\e(B @code{gmane} \e$B%(%s%8%s$r;H$&$h$&$K@_Dj$5$l$F$$$^$9!#\e(B(@code{gmane} \e$B8!:w\e(B
+\e$B%(%s%8%s$O\e(B gmane \e$B$G$O$J$$\e(B @code{nntp} \e$B%5!<%P!<$r<B:]$K8!:w$7$h$&$H$7$^$;\e(B
+\e$B$s$+$i!"$4?4G[$J$/!#\e(B) \e$B$G$b\e(B @code{nnimap} \e$B%P%C%/%(%s%I$r;H$&$9$Y$F$N%5!<\e(B
+\e$B%P!<$N$?$a$K\e(B @code{namazu} \e$B$r;H$$$?$+$C$?$N$G$"$l$P!"0J2<$N$h$&$KJQ99$9\e(B
+\e$B$k$3$H$,$G$-$^$9\e(B:
@lisp
'((nnimap . namazu)
@end lisp
@node The imap Engine
-@subsubsection The imap Engine
+@subsubsection Imap \e$B%(%s%8%s\e(B
-The @code{imap} engine requires no configuration.
+@code{imap} \e$B%(%s%8%s$O@_DjITMW$G$9!#\e(B
-Queries using the @code{imap} engine follow a simple query language.
-The search is always case-insensitive and supports the following
-features (inspired by the Google search input language):
+@code{imap} \e$B%(%s%8%s$r;H$&8!:w$K$O!"4JC1$J8!:w8l$N=q$-J}$,$"$j$^$9!#8!:w\e(B
+\e$B$O>o$KBgJ8;z$H>.J8;z$r6hJL$;$:!"0J2<$N5!G=$r;}$C$F$$$^$9\e(B (Google \e$B8!:w$N\e(B
+\e$B8!:w8l$N=q$-J}$KJo$C$F$$$^$9\e(B)\e$B!#\e(B
@table @samp
-@item Boolean query operators
-AND, OR, and NOT are supported, and parentheses can be used to control
-operator precedence, e.g. (emacs OR xemacs) AND linux. Note that
-operators must be written with all capital letters to be
-recognised. Also preceding a term with a - sign is equivalent to NOT
-term.
-
-@item Automatic AND queries
-If you specify multiple words then they will be treated as an AND
-expression intended to match all components.
-
-@item Phrase searches
-If you wrap your query in double-quotes then it will be treated as a
-literal string.
+@item \e$B%V!<%j%"%s1i;;;R\e(B
+AND\e$B!"\e(BOR\e$B!"$*$h$S\e(B NOT \e$B$r%5%]!<%H$7!"1i;;;R$NM%@h=g0L$r@)8f$9$k$?$a$K3g8L$r\e(B
+\e$B;H$&$3$H$,$G$-$^$9!#Nc$($P!V\e(B(emacs OR xemacs) AND linux\e$B!W$N$h$&$K!#1i;;\e(B
+\e$B;R$O$=$l$G$"$k$HG'CN$5$l$k$?$a$K!"$9$Y$FBgJ8;z$G=q$+$J$1$l$P$J$i$J$$$3$H\e(B
+\e$B$KCm0U$7$F$/$@$5$$!#$5$i$K!"8l$K@hN)$D\e(B - \e$B5-9f$O!V\e(BNOT \e$B8l!W$HEy2A$G$9!#\e(B
+
+@item \e$B<+F0\e(B AND \e$B8!:w\e(B
+\e$B$b$7J#?t$N8l$r;XDj$9$k$H!"$=$l$i$O$9$Y$F$NMWAG$K9gCW$9$k$3$H$r0U?^$7\e(B
+\e$B$?\e(B AND \e$B8!:w$H$7$F07$o$l$^$9!#\e(B
+
+@item \e$B=O8l8!:w\e(B
+\e$B$b$78!:w8l$r\e(B 2\e$B=E0zMQId$G0O$`$H!"$=$l$O$R$H$^$H$^$j$NJ8;zNs$H$7$F07$o$l$^\e(B
+\e$B$9!#\e(B
@end table
-By default the whole message will be searched. The query can be limited
-to a specific part of a message by using a prefix-arg. After inputting
-the query this will prompt (with completion) for a message part.
-Choices include ``Whole message'', ``Subject'', ``From'', and
-``To''. Any unrecognized input is interpreted as a header name. For
-example, typing @kbd{Message-ID} in response to this prompt will limit
-the query to the Message-ID header.
+\e$B%G%#%U%)%k%H$G$O%a%C%;!<%8A4BN$,8!:w$5$l$^$9!#@\F,0z?t$r;H$&$3$H$K$h$C$F!"\e(B
+\e$B8!:w$r%a%C%;!<%8$N;XDj$9$kItJ,$@$1$K@)8B$9$k$3$H$,$G$-!"$=$&$9$k$H8!:w8l\e(B
+\e$B$,F~NO$5$l$?8e$G!"%a%C%;!<%8$NItJ,$r\e(B (\e$BJd40IU$-$G\e(B) \e$B?R$M$i$l$^$9!#A*Br;h$K\e(B
+\e$B$O\e(B ``Whole message'' (\e$B%a%C%;!<%8A4BN\e(B)\e$B!"\e(B``Subject''\e$B!"\e(B``From''\e$B!"$*$h\e(B
+
\e$B$S
\e(B ``To''
\e$B$,$"$j$^$9!#$=$l0J30$O$I$s$JF~NO$b%X%C%@!<L>$G$"$k$H2r<a$5$l$^
\e(B
+\e$B$9!#Nc$($P$3$NLd$$$K\e(B @kbd{Message-ID} \e$B$H%?%$%W$7$F1~$($k$H!"8!:w\e(B
+\e$B$O\e(B Message-ID \e$B%X%C%@!<$@$1$K@)8B$5$l$^$9!#\e(B
-Finally selecting ``Imap'' will interpret the query as a raw
-@acronym{IMAP} search query. The format of such queries can be found in
-RFC3501.
+
\e$B:G=*E*$K
\e(B ``Imap''
\e$B$rA*$V$H!"$=$l$O@8$N
\e(B @acronym{IMAP}
\e$B8!:w$H2r<a$5$l$^$9!#
\e(B
+\e$B$=$N$h$&$J8!:w$N%U%)!<%^%C%H$O\e(B RFC3501 \e$B$G8+$D$+$k$O$:$G$9!#\e(B
-If you don't like the default of searching whole messages you can
-customize @code{nnir-imap-default-search-key}. For example to use
-@acronym{IMAP} queries by default
+\e$B$b$7%G%#%U%)%k%H$N%a%C%;!<%8A4BN8!:w$,9%$_$G$J$$$N$G$"$l\e(B
+\e$B$P\e(B @code{nnir-imap-default-search-key} \e$B$r%+%9%?%^%$%:$7$F$/$@$5$$!#%G%#\e(B
+\e$B%U%)%k%H$G\e(B @acronym{IMAP} \e$B8!:w$r;H$$$?$$>l9g$O!"$3$&$7$F$/$@$5$$\e(B:
@lisp
(setq nnir-imap-default-search-key "Imap")
@end lisp
@node The gmane Engine
-@subsubsection The gmane Engine
+@subsubsection Gmane \e$B%(%s%8%s\e(B
-The @code{gmane} engine requires no configuration.
+@code{gmane} \e$B%(%s%8%s$O@_DjITMW$G$9!#\e(B
-Gmane queries follow a simple query language:
+@code{gmane} \e$B%(%s%8%s$r;H$&8!:w$K$O!"4JC1$J8!:w8l$N=q$-J}$,$"$j$^$9!#\e(B
@table @samp
-@item Boolean query operators
-AND, OR, NOT (or AND NOT), and XOR are supported, and brackets can be
-used to control operator precedence, e.g. (emacs OR xemacs) AND linux.
-Note that operators must be written with all capital letters to be
-recognised.
+@item \e$B%V!<%j%"%s1i;;;R\e(B
+AND\e$B!"\e(BOR\e$B!"\e(BNOT (\e$B$^$?$O\e(B AND NOT) \e$B$*$h$S\e(B XOR \e$B$r%5%]!<%H$7!"1i;;;R$NM%@h=g0L\e(B
+\e$B$r@)8f$9$k$?$a$K3g8L$r;H$&$3$H$,$G$-$^$9!#Nc$($P!V\e(B(emacs OR xemacs) AND
+linux\e$B!W$N$h$&$K!#1i;;;R$O$=$l$G$"$k$HG'CN$5$l$k$?$a$K!"$9$Y$FBgJ8;z$G=q\e(B
+\e$B$+$J$1$l$P$J$i$J$$$3$H$KCm0U$7$F$/$@$5$$!#\e(B
-@item Required and excluded terms
-+ and - can be used to require or exclude terms, e.g. football -american
+@item \e$BI,?\$N!"$^$?$O=|30$9$Y$-8l\e(B
++ \e$B$H\e(B - \e$B$O8l$,I,?\$G$"$k$+!"$^$?$O=|30$9$Y$-$+$r;XDj$7$^$9!#Nc$(\e(B
+\e$B$P\e(B: \e$B!V\e(Bfootball -american\e$B!W\e(B
-@item Unicode handling
-The search engine converts all text to utf-8, so searching should work
-in any language.
+@item Unicode \e$B$N<h07$$\e(B
+\e$B8!:w%(%s%8%s$O$9$Y$F$N%F%-%9%H$r\e(B utf-8 \e$B$KJQ49$9$k$N$G!"$I$s$J8@8l$G$b8!\e(B
+\e$B:w$G$-$k$O$:$G$9!#\e(B
@item Stopwords
-Common English words (like 'the' and 'a') are ignored by default. You
-can override this by prefixing such words with a + (e.g. +the) or
-enclosing the word in quotes (e.g. "the").
+\e$B$"$j$U$l$?1QC18l\e(B ('the' \e$B$d\e(B 'a' \e$B$N$h$&$J$b$N\e(B) \e$B$O%G%#%U%)%k%H$GL5;k$5$l$^\e(B
+\e$B$9!#$=$N$h$&$JC18l$G$b\e(B + \e$B$rA0CV$-\e(B (\e$BNc\e(B: +the) \e$B$7$?$j!"0zMQId$G0O\e(B
+\e$B$`\e(B (\e$BNc\e(B: "the") \e$B$3$H$K$h$C$F8!:wBP>]$K$9$k$3$H$,$G$-$^$9!#\e(B
@end table
-The query can be limited to articles by a specific author using a
-prefix-arg. After inputting the query this will prompt for an author
-name (or part of a name) to match.
+\e$B@\F,0z?t$r;H$&$3$H$K$h$C$F!"8!:w$r;XDj$7$?Cx<T$K$h$k5-;v$K8BDj$9$k$3$H$,\e(B
+\e$B$G$-$^$9!#$=$&$9$k$H8!:w8l$,F~NO$5$l$?8e$G!"9gCW$9$kCx<TL>\e(B (\e$B$^$?$OL>A0$N\e(B
+\e$B0lIt\e(B) \e$B$,?R$M$i$l$^$9!#\e(B
@node The swish++ Engine
-@subsubsection The swish++ Engine
+@subsubsection Swish++ \e$B%(%s%8%s\e(B
-FIXEM: Say something more here.
+FIXEM: \e$B$3$3$G2?$+$b$C$H8@$&!#\e(B
-Documentation for swish++ may be found at the swish++ sourceforge page:
-@uref{http://swishplusplus.sourceforge.net}
+Swish++ \e$B$N;qNA$O\e(B sourceforge \e$B$N\e(B swish++ \e$B$N%Z!<%8$G8+$D$+$k$G$7$g\e(B
+\e$B$&\e(B: @uref{http://swishplusplus.sourceforge.net}
@table @code
@item nnir-swish++-program
-The name of the swish++ executable. Defaults to @code{search}
+Swish++ \e$B$N<B9T7A<0$NL>A0!#%G%#%U%)%k%H$O\e(B @code{search} \e$B$G$9!#\e(B
@item nnir-swish++-additional-switches
-A list of strings to be given as additional arguments to
-swish++. @code{nil} by default.
+Swish++ \e$B$KDI2C$N0z?t$H$7$FM?$($i$l$kJ8;zNs$N%j%9%H!#%G%#%U%)%k%H\e(B
+\e$B$O\e(B @code{nil} \e$B$G$9!#\e(B
@item nnir-swish++-remove-prefix
-The prefix to remove from each file name returned by swish++ in order
-to get a group name. By default this is @code{$HOME/Mail}.
+\e$B%0%k!<%WL>$rF@$k$?$a$K\e(B swish++ \e$B$,JV$9$=$l$>$l$N%U%!%$%kL>$+$i<h$j=|$/@\\e(B
+\e$BF,8l!#$3$l$O%G%#%U%)%k%H$G$O\e(B @code{$HOME/Mail} \e$B$G$9!#\e(B
@end table
@node The swish-e Engine
-@subsubsection The swish-e Engine
+@subsubsection Swish-e \e$B%(%s%8%s\e(B
-FIXEM: Say something more here.
+FIXEM: \e$B$3$3$G2?$+$b$C$H8@$&!#\e(B
-Documentation for swish-e may be found at the swish-e homepage
-@uref{http://swish-e.org}
+Swish-e \e$B$N;qNA$O\e(B swish-e \e$B%[!<%`%Z!<%8$G8+$D$+$k$G$7$g\e(B
+\e$B$&\e(B: @uref{http://swish-e.org}
@table @code
-
@item nnir-swish-e-program
-The name of the swish-e search program. Defaults to @code{swish-e}.
+Swish-e \e$B8!:w%W%m%0%i%`$NL>A0!#%G%#%U%)%k%H$O\e(B @code{swish-e} \e$B$G$9!#\e(B
@item nnir-swish-e-additional-switches
-A list of strings to be given as additional arguments to
-swish-e. @code{nil} by default.
+Swish-e \e$B$KDI2C$N0z?t$H$7$FM?$($i$l$kJ8;zNs$N%j%9%H!#%G%#%U%)%k%H\e(B
+\e$B$O\e(B @code{nil} \e$B$G$9!#\e(B
@item nnir-swish-e-remove-prefix
-The prefix to remove from each file name returned by swish-e in order
-to get a group name. By default this is @code{$HOME/Mail}.
-
+\e$B%0%k!<%WL>$rF@$k$?$a$K\e(B swish-e \e$B$,JV$9$=$l$>$l$N%U%!%$%kL>$+$i<h$j=|$/@\\e(B
+\e$BF,8l!#$3$l$O%G%#%U%)%k%H$G$O\e(B @code{$HOME/Mail} \e$B$G$9!#\e(B
@end table
@node The namazu Engine
-@subsubsection The namazu Engine
-
-Using the namazu engine requires creating and maintaining index files.
-One directory should contain all the index files, and nnir must be told
-where to find them by setting the @code{nnir-namazu-index-directory}
-variable.
-
-To work correctly the @code{nnir-namazu-remove-prefix} variable must
-also be correct. This is the prefix to remove from each file name
-returned by Namazu in order to get a proper group name (albeit with `/'
-instead of `.').
-
-For example, suppose that Namazu returns file names such as
-@samp{/home/john/Mail/mail/misc/42}. For this example, use the
-following setting: @code{(setq nnir-namazu-remove-prefix
-"/home/john/Mail/")} Note the trailing slash. Removing this prefix from
-the directory gives @samp{mail/misc/42}. @code{nnir} knows to remove
-the @samp{/42} and to replace @samp{/} with @samp{.} to arrive at the
-correct group name @samp{mail.misc}.
-
-Extra switches may be passed to the namazu search command by setting the
-variable @code{nnir-namazu-additional-switches}. It is particularly
-important not to pass any any switches to namazu that will change the
-output format. Good switches to use include `--sort', `--ascending',
-`--early' and `--late'. Refer to the Namazu documentation for further
-information on valid switches.
-
-Mail must first be indexed with the `mknmz' program. Read the documentation
-for namazu to create a configuration file. Here is an example:
+@subsubsection Namazu \e$B%(%s%8%s\e(B
+
+Namazu \e$B$r;H$&$K$O:w0z%U%!%$%k$r:n$C$F0];}$9$kI,MW$,$"$j$^$9!#$9$Y$F$N:w\e(B
+\e$B0z%U%!%$%k$O0l$D$N%G%#%l%/%H%j!<$KCV$$$F$"$k$O$:$G!"$=$N=j:_\e(B
+\e$B$r\e(B @code{nnir-namazu-index-directory} \e$BJQ?t$r@_Dj$9$k$3$H$K$h$C$F\e(B nnir \e$B$K\e(B
+\e$BEA$($J$1$l$P$J$j$^$;$s!#\e(B
+
+\e$B@5$7$/F/$+$;$k$K$O\e(B @code{nnir-namazu-remove-prefix} \e$BJQ?t$b@5$7$/$J$1$l$P\e(B
+\e$B$J$j$^$;$s!#$3$l$O!"@5$7$$%0%k!<%WL>$rF@$k$?$a$K\e(B Namazu \e$B$,JV$9$=$l$>$l$N\e(B
+\e$B%U%!%$%kL>$+$i<h$j=|$/@\F,8l$G$9\e(B (`.' \e$B$O\e(B `/' \e$B$KCV$-Be$o$j$^$9$,\e(B)\e$B!#\e(B
+
+\e$BNc$($P\e(B Namazu \e$B$,\e(B @samp{/home/john/Mail/mail/misc/42} \e$B$N$h$&$J%U%!%$%kL>\e(B
+\e$B$rJV$9$H$7$^$7$g$&!#$3$NNc$G$O<!$N@_Dj$r;H$C$F$/$@$5$$\e(B:
+
+@lisp
+(setq nnir-namazu-remove-prefix "/home/john/Mail/")
+@end lisp
+
+\e$B:G8e$N%9%i%C%7%e$KCm0U$7$F$/$@$5$$!#%G%#%l%/%H%j!<$+$i$3$N@\F,8l$r<h$j=|\e(B
+\e$B$/$H\e(B @samp{mail/misc/42} \e$B$K$J$j$^$9!#\e(B@code{nnir} \e$B$O@5$7$$%0%k!<%W\e(B
+\e$BL>\e(B @samp{mail.misc} \e$B$rF3$/$?$a$K\e(B @samp{/42} \e$B$r<h$j=|$$\e(B
+\e$B$F\e(B @samp{/} \e$B$r\e(B @samp{.} \e$B$GCV$-49$($k$Y$-$G$"$k$3$H$O>5CN$7$F$$$^$9!#\e(B
+
+\e$BB>$N%*%W%7%g%s$O\e(B @code{nnir-namazu-additional-switches} \e$B$r@_Dj$9$k$3$H$K\e(B
+\e$B$h$C$F\e(B namazu \e$B8!:w%3%^%s%I$KEO$5$l$^$9!#$H$j$o$1!"=PNO$N7A<0$rJQ99$7$F$7\e(B
+\e$B$^$&$I$s$J%*%W%7%g%s$b\e(B namazu \e$B$KEO$5$J$$$3$H$,=EMW$G$9!#;H$C$F$bNI$$%*%W\e(B
+\e$B%7%g%s$O\e(B `--sort'\e$B!"\e(B`--ascending'\e$B!"\e(B`--early' \e$B$*$h$S\e(B `--late' \e$B$G$9!#$5$i$J\e(B
+\e$B$kM-8z$J%*%W%7%g%s$K$D$$$F$O\e(B Namazu \e$B$N@bL@=q$r;2>H$7$F$/$@$5$$!#\e(B
+
+\e$B%a!<%k$O\e(B `mknmz' \e$B%W%m%0%i%`$G:G=i$K:w0zIU$1$5$l$J$1$l$P$J$j$^$;$s!#@_Dj\e(B
+\e$B%U%!%$%k$r:n$k$?$a$K$O\e(B namazu \e$B$N@bL@=q$rFI$s$G$/$@$5$$!#$3$3$KNc$,$"$j$^\e(B
+\e$B$9\e(B:
@cartouche
@example
- package conf; # Don't remove this line!
+ package conf; # \e$B$3$N9T$O>C$5$J$$$3$H\e(B!
- # Paths which will not be indexed. Don't use `^' or `$' anchors.
+ # \e$B:w0zIU$1$5$l$J$$%Q%9!#\e(B`^' \e$B$^$?$O\e(B `$' \e$B%"%s%+!<$r;H$o$J$$$3$H!#\e(B
$EXCLUDE_PATH = "spam|sent";
- # Header fields which should be searchable. case-insensitive
+ # \e$B8!:w$9$Y$-%X%C%@!<!&%U%#!<%k%I!#BgJ8;z\e(B/\e$B>.J8;z$N6hJL$OL5$$!#\e(B
$REMAIN_HEADER = "from|date|message-id|subject";
- # Searchable fields. case-insensitive
+ # \e$B8!:w$G$-$k%U%#!<%k%I!#BgJ8;z\e(B/\e$B>.J8;z$N6hJL$OL5$$!#\e(B
$SEARCH_FIELD = "from|date|message-id|subject";
- # The max length of a word.
+ # \e$B:G$bD9$$8l$ND9$5!#\e(B
$WORD_LENG_MAX = 128;
- # The max length of a field.
+ # \e$B:G$bD9$$%U%#!<%k%I$ND9$5!#\e(B
$MAX_FIELD_LENGTH = 256;
@end example
@end cartouche
-For this example, mail is stored in the directories @samp{~/Mail/mail/},
-@samp{~/Mail/lists/} and @samp{~/Mail/archive/}, so to index them go to
-the index directory set in @code{nnir-namazu-index-directory} and issue
-the following command:
+\e$BNc$($P%a!<%k$,\e(B @samp{~/Mail/mail/}\e$B!"\e(B@samp{~/Mail/lists/} \e$B$*$h\e(B
+\e$B$S\e(B @samp{~/Mail/archive/} \e$B%G%#%l%/%H%j!<$K3JG<$5$l$k$N$G$"$l$P!"$=$l$i$K\e(B
+\e$B:w0zIU$1$r$9$k$?$a$K$O\e(B @code{nnir-namazu-index-directory} \e$B$K@_Dj$5$l$F$$\e(B
+\e$B$k:w0z%G%#%l%/%H%j!<$K9T$C$F!"0J2<$N%3%^%s%I$rH/9T$7$^$9!#\e(B
@example
mknmz --mailnews ~/Mail/archive/ ~/Mail/mail/ ~/Mail/lists/
@end example
-For maximum searching efficiency you might want to have a cron job run
-this command periodically, say every four hours.
+\e$B:GBg$N8!:w8zN($rF@$k$?$a$K$O!"$3$N%3%^%s%I$rDj4|E*$K\e(B (\e$BNc$($P\e(B 4\e$B;~4VKh\e(B
+\e$B$K\e(B) \e$B<B9T$9$k\e(B cron \e$B%8%g%V$rAv$i$;$kI,MW$,$"$k$G$7$g$&!#\e(B
@node The hyrex Engine
-@subsubsection The hyrex Engine
-FIXME: Add documentation.
+@subsubsection Hyrex \e$B%(%s%8%s\e(B
+FIXME: \e$B@bL@$rDI2C$9$k!#\e(B
@node Customizations
-@subsubsection Custimozations
+@subsubsection \e$B%+%9%?%^%$%:\e(B
@table @code
@item nnir-method-default-engines
-Alist of server backend - search engine pairs. The default associations
-are
+\e$B%5!<%P!<$N%P%C%/%(%s%I$H8!:w%(%s%8%s$N%Z%"$h$j$J$kO"A[%j%9%H!#%G%#%U%)%k\e(B
+\e$B%H$N4XO"IU$1$O<!$NDL$j$G$9\e(B:
+
@example
(nnimap . imap)
(nntp . gmane)
@end example
@item nnir-ignored-newsgroups
-A regexp to match newsgroups in the active file that should be skipped
-when searching all groups on a server.
+\e$B0l$D$N%5!<%P!<$K$"$k$9$Y$F$N%0%k!<%W$r8!:w$9$k$H$-$K!"\e(Bactive \e$B%U%!%$%k$K\e(B
+\e$B$"$kFI$_Ht$P$9$Y$-%K%e!<%9%0%k!<%W$K9gCW$9$k@55,I=8=!#\e(B
@item nnir-summary-line-format
-The format specification to be used for lines in an nnir summary buffer.
-All the items from `gnus-summary-line-format' are available, along with
-three items unique to nnir summary buffers:
+nnir \e$B35N,%P%C%U%!!<$N9T$N$?$a$K;H$o$l$k=qK!;EMM!#\e(B
+@code{gnus-summary-line-format} \e$B$N$9$Y$F$N=qK!;EMM;X<(;R$H$H$b$K\e(B nnir \e$B35\e(B
+\e$BN,%P%C%U%!!<FH<+$N0J2<$N;0$D$N;X<(;R$r;H$&$3$H$,$G$-$^$9\e(B:
@example
-%Z Search retrieval score value (integer)
-%G Article original full group name (string)
-%g Article original short group name (string)
+%Z \e$B8!:w7k2L$N%9%3%"$NCM\e(B (\e$B@0?t\e(B)
+%G \e$B5-;v$,$"$C$?85$N40A4$J%0%k!<%WL>\e(B (\e$BJ8;zNs\e(B)
+%g \e$B5-;v$,$"$C$?85$NC;=L7A$N%0%k!<%WL>\e(B (\e$BJ8;zNs\e(B)
@end example
-If nil (the default) this will use @code{gnus-summary-line-format}.
+\e$B$b$7\e(B @code{nil} \e$B$@$C$?$i\e(B (\e$B$=$l$,%G%#%U%)%k%H\e(B)\e$B!"\e(B
+@code{gnus-summary-line-format} \e$B$r;H$$$^$9!#\e(B
@item nnir-retrieve-headers-override-function
-If non-nil, a function that retrieves article headers rather than using
-the gnus built-in function. This function takes an article list and
-group as arguments and populates the `nntp-server-buffer' with the
-retrieved headers. It should then return either 'nov or 'headers
-indicating the retrieved header format. Failure to retrieve headers
-should return @code{nil}
-
-If this variable is nil, or if the provided function returns nil for a
-search result, @code{gnus-retrieve-headers} will be called instead."
+\e$B$b$7\e(B @code{nil} \e$B$G$J$1$l$P!"\e(BGnus \e$B$KAH$_9~$^$l$F$$$k4X?t$r;H$o$:$K5-;v$N\e(B
+\e$B%X%C%@!<$r<hF@$9$k$?$a$N4X?t!#$3$N4X?t$O0z?t$H$7$F5-;v$N%j%9%H$H%0%k!<%W\e(B
+\e$B$r<h$j!"<hF@$7$?%X%C%@!<$G\e(B `nntp-server-buffer' \e$B$rK~$?$7$^$9!#$=$7$F!"<h\e(B
+\e$BF@$7$?%X%C%@!<$N7A<0$r<($9$?$a$K\e(B @code{nov} \e$B$^$?$O\e(B @code{headers} \e$B$rJV$5\e(B
+\e$B$J$1$l$P$J$j$^$;$s!#%X%C%@!<$N<hF@$K<:GT$7$?$H$-$O\e(B @code{nil} \e$B$rJV$7$^$9!#\e(B
+
+\e$B$b$7$3$NJQ?t$,\e(B @code{nil} \e$B$@$C$?$i!"$^$?$OMQ0U$7$?4X?t$,8!:w7k2L$H$7\e(B
+\e$B$F\e(B @code{nil} \e$B$rJV$7$?$i!"Be$o$j$K\e(B @code{gnus-retrieve-headers} \e$B$,8F$P$l\e(B
+\e$B$^$9!#\e(B
@end table
-@c TRANSLATEME<
@node nnmairix
@section nnmairix
projects / elisp / gnus-doc-ja.git / commitdiff