aboutsummaryrefslogtreecommitdiffstats
path: root/doc/misc
diff options
context:
space:
mode:
authorRobert Pluim2019-11-20 11:55:42 +0100
committerRobert Pluim2019-11-20 12:05:11 +0100
commit2709b1e4e5fb370f0edefdd467956b5be11e2401 (patch)
tree4adf61b75b37685277a6fa7d433d5c50ece3fa00 /doc/misc
parent123c775aa7a92fc323f88c2e4b6e8185d4c369b4 (diff)
downloademacs-2709b1e4e5fb370f0edefdd467956b5be11e2401.tar.gz
emacs-2709b1e4e5fb370f0edefdd467956b5be11e2401.zip
Remove info references to gmane web search
* doc/misc/gnus.texi (Foreign Groups, Web Searches, What is nnir?): (Setting up nnir, Associating Engines, The imap Engine): (Customizations): Remove references to gmane web search.
Diffstat (limited to 'doc/misc')
-rw-r--r--doc/misc/gnus.texi92
1 files changed, 15 insertions, 77 deletions
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index 8ab1cf9f68f..e43aa92c997 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -2628,9 +2628,6 @@ type. @xref{Document Groups}.
2628Create one of the groups mentioned in @code{gnus-useful-groups} 2628Create one of the groups mentioned in @code{gnus-useful-groups}
2629(@code{gnus-group-make-useful-group}). 2629(@code{gnus-group-make-useful-group}).
2630 2630
2631@c FIXME: Gmane.org is no longer working; fix the Gmane referrences
2632@c in this file accordingly.
2633
2634@item G w 2631@item G w
2635@kindex G w @r{(Group)} 2632@kindex G w @r{(Group)}
2636@findex gnus-group-make-web-group 2633@findex gnus-group-make-web-group
@@ -2641,7 +2638,7 @@ Make an ephemeral group based on a web search
2641(@code{gnus-group-make-web-group}). If you give a prefix to this 2638(@code{gnus-group-make-web-group}). If you give a prefix to this
2642command, make a solid group instead. You will be prompted for the 2639command, make a solid group instead. You will be prompted for the
2643search engine type and the search string. Valid search engine types 2640search engine type and the search string. Valid search engine types
2644include @code{google}, @code{dejanews}, and @code{gmane}. 2641include @code{google} and @code{dejanews}.
2645@xref{Web Searches}. 2642@xref{Web Searches}.
2646 2643
2647If you use the @code{google} search engine, you can limit the search 2644If you use the @code{google} search engine, you can limit the search
@@ -2694,25 +2691,6 @@ The following commands create ephemeral groups. They can be called not
2694only from the Group buffer, but in any Gnus buffer. 2691only from the Group buffer, but in any Gnus buffer.
2695 2692
2696@table @code 2693@table @code
2697@item gnus-read-ephemeral-gmane-group
2698@findex gnus-read-ephemeral-gmane-group
2699@vindex gnus-gmane-group-download-format
2700Read an ephemeral group on Gmane.org. The articles are downloaded via
2701HTTP using the URL specified by @code{gnus-gmane-group-download-format}.
2702Gnus will prompt you for a group name, the start article number and an
2703the article range.
2704
2705@item gnus-read-ephemeral-gmane-group-url
2706@findex gnus-read-ephemeral-gmane-group-url
2707This command is similar to @code{gnus-read-ephemeral-gmane-group}, but
2708the group name and the article number and range are constructed from a
2709given @acronym{URL}. Supported @acronym{URL} formats include:
2710@indicateurl{http://thread.gmane.org/gmane.foo.bar/12300/focus=12399},
2711@indicateurl{http://thread.gmane.org/gmane.foo.bar/12345/},
2712@indicateurl{http://article.gmane.org/gmane.foo.bar/12345/},
2713@indicateurl{http://permalink.gmane.org/gmane.foo.bar/12345/}, and
2714@indicateurl{http://news.gmane.org/group/gmane.foo.bar/thread=12345}.
2715
2716@item gnus-read-ephemeral-emacs-bug-group 2694@item gnus-read-ephemeral-emacs-bug-group
2717@findex gnus-read-ephemeral-emacs-bug-group 2695@findex gnus-read-ephemeral-emacs-bug-group
2718Read an Emacs bug report in an ephemeral group. Gnus will prompt for 2696Read an Emacs bug report in an ephemeral group. Gnus will prompt for
@@ -17019,7 +16997,6 @@ before you restore the data.
17019@cindex nnweb 16997@cindex nnweb
17020@cindex Google 16998@cindex Google
17021@cindex dejanews 16999@cindex dejanews
17022@cindex gmane
17023@cindex Usenet searches 17000@cindex Usenet searches
17024@cindex searching the Usenet 17001@cindex searching the Usenet
17025 17002
@@ -17060,7 +17037,7 @@ Virtual server variables:
17060@item nnweb-type 17037@item nnweb-type
17061@vindex nnweb-type 17038@vindex nnweb-type
17062What search engine type is being used. The currently supported types 17039What search engine type is being used. The currently supported types
17063are @code{google}, @code{dejanews}, and @code{gmane}. Note that 17040are @code{google} and @code{dejanews}. Note that
17064@code{dejanews} is an alias to @code{google}. 17041@code{dejanews} is an alias to @code{google}.
17065 17042
17066@item nnweb-search 17043@item nnweb-search
@@ -21167,9 +21144,9 @@ through mail and news repositories. Different backends (like
21167@dfn{engines} in @code{nnir} lingo), but all use the same basic search 21144@dfn{engines} in @code{nnir} lingo), but all use the same basic search
21168interface. 21145interface.
21169 21146
21170The @code{nnimap} and @code{gmane} search engines should work with no 21147The @code{nnimap} search engine should work with no configuration.
21171configuration. Other engines require a local index that needs to be 21148Other engines require a local index that needs to be created and
21172created and maintained outside of Gnus. 21149maintained outside of Gnus.
21173 21150
21174 21151
21175@node Basic Usage 21152@node Basic Usage
@@ -21215,22 +21192,20 @@ special search features for each engine separately.
21215@node Setting up nnir 21192@node Setting up nnir
21216@subsection Setting up nnir 21193@subsection Setting up nnir
21217 21194
21218To set up nnir you may need to do some prep work. Firstly, you may need 21195To set up nnir you may need to do some prep work. Firstly, you may
21219to configure the search engines you plan to use. Some of them, like 21196need to configure the search engines you plan to use. Some of them,
21220@code{imap} and @code{gmane}, need no special configuration. Others, 21197like @code{imap}, need no special configuration. Others, like
21221like @code{namazu} and @code{swish}, require configuration as described 21198@code{namazu} and @code{swish}, require configuration as described
21222below. Secondly, you need to associate a search engine with a server or 21199below. Secondly, you need to associate a search engine with a server
21223a backend. 21200or a backend.
21224 21201
21225If you just want to use the @code{imap} engine to search @code{nnimap} 21202If you just want to use the @code{imap} engine to search @code{nnimap}
21226servers, and the @code{gmane} engine to search @code{gmane} then you 21203servers then you don't have to do anything. But you might want to
21227don't have to do anything. But you might want to read the details of the 21204read the details of the query language anyway.
21228query language anyway.
21229 21205
21230@menu 21206@menu
21231* Associating Engines:: How to associate engines. 21207* Associating Engines:: How to associate engines.
21232* The imap Engine:: Imap configuration and usage. 21208* The imap Engine:: Imap configuration and usage.
21233* The gmane Engine:: Gmane configuration and usage.
21234* The swish++ Engine:: Swish++ configuration and usage. 21209* The swish++ Engine:: Swish++ configuration and usage.
21235* The swish-e Engine:: Swish-e configuration and usage. 21210* The swish-e Engine:: Swish-e configuration and usage.
21236* The namazu Engine:: Namazu configuration and usage. 21211* The namazu Engine:: Namazu configuration and usage.
@@ -21262,11 +21237,8 @@ engine for all servers using the @code{nnimap} backend. In this case you
21262can customize the variable @code{nnir-method-default-engines}. This is 21237can customize the variable @code{nnir-method-default-engines}. This is
21263an alist of pairs of the form @code{(backend . engine)}. By default this 21238an alist of pairs of the form @code{(backend . engine)}. By default this
21264variable is set to use the @code{imap} engine for all servers using the 21239variable is set to use the @code{imap} engine for all servers using the
21265@code{nnimap} backend, and the @code{gmane} backend for @code{nntp} 21240@code{nnimap} backend. But if you wanted to use @code{namazu} for all
21266servers. (Don't worry, the @code{gmane} search engine won't actually try 21241your servers with an @code{nnimap} backend you could change this to
21267to search non-gmane @code{nntp} servers.) But if you wanted to use
21268@code{namazu} for all your servers with an @code{nnimap} backend you
21269could change this to
21270 21242
21271@lisp 21243@lisp
21272'((nnimap . namazu) 21244'((nnimap . namazu)
@@ -21321,39 +21293,6 @@ customize @code{nnir-imap-default-search-key}. For example to use
21321(setq nnir-imap-default-search-key "Imap") 21293(setq nnir-imap-default-search-key "Imap")
21322@end lisp 21294@end lisp
21323 21295
21324@node The gmane Engine
21325@subsubsection The gmane Engine
21326
21327The @code{gmane} engine requires no configuration.
21328
21329Gmane queries follow a simple query language:
21330
21331@table @samp
21332@item Boolean query operators
21333AND, OR, NOT (or AND NOT), and XOR are supported, and brackets can be
21334used to control operator precedence, e.g., (emacs OR xemacs) AND linux.
21335Note that operators must be written with all capital letters to be
21336recognized.
21337
21338@item Required and excluded terms
21339+ and @minus{} can be used to require or exclude terms, e.g., football
21340@minus{}american
21341
21342@item Unicode handling
21343The search engine converts all text to utf-8, so searching should work
21344in any language.
21345
21346@item Stopwords
21347Common English words (like 'the' and 'a') are ignored by default. You
21348can override this by prefixing such words with a + (e.g., +the) or
21349enclosing the word in quotes (e.g., "the").
21350
21351@end table
21352
21353The query can be limited to articles by a specific author using a
21354prefix-arg. After inputting the query this will prompt for an author
21355name (or part of a name) to match.
21356
21357@node The swish++ Engine 21296@node The swish++ Engine
21358@subsubsection The swish++ Engine 21297@subsubsection The swish++ Engine
21359 21298
@@ -21509,7 +21448,6 @@ Alist of pairs of server backends and search engines. The default
21509associations are 21448associations are
21510@example 21449@example
21511(nnimap . imap) 21450(nnimap . imap)
21512(nntp . gmane)
21513@end example 21451@end example
21514 21452
21515@item nnir-ignored-newsgroups 21453@item nnir-ignored-newsgroups