diff options
| author | Robert Pluim | 2019-11-20 11:55:42 +0100 |
|---|---|---|
| committer | Robert Pluim | 2019-11-20 12:05:11 +0100 |
| commit | 2709b1e4e5fb370f0edefdd467956b5be11e2401 (patch) | |
| tree | 4adf61b75b37685277a6fa7d433d5c50ece3fa00 /doc/misc | |
| parent | 123c775aa7a92fc323f88c2e4b6e8185d4c369b4 (diff) | |
| download | emacs-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.texi | 92 |
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}. | |||
| 2628 | Create one of the groups mentioned in @code{gnus-useful-groups} | 2628 | Create 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 |
| 2642 | command, make a solid group instead. You will be prompted for the | 2639 | command, make a solid group instead. You will be prompted for the |
| 2643 | search engine type and the search string. Valid search engine types | 2640 | search engine type and the search string. Valid search engine types |
| 2644 | include @code{google}, @code{dejanews}, and @code{gmane}. | 2641 | include @code{google} and @code{dejanews}. |
| 2645 | @xref{Web Searches}. | 2642 | @xref{Web Searches}. |
| 2646 | 2643 | ||
| 2647 | If you use the @code{google} search engine, you can limit the search | 2644 | If 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 | |||
| 2694 | only from the Group buffer, but in any Gnus buffer. | 2691 | only 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 | ||
| 2700 | Read an ephemeral group on Gmane.org. The articles are downloaded via | ||
| 2701 | HTTP using the URL specified by @code{gnus-gmane-group-download-format}. | ||
| 2702 | Gnus will prompt you for a group name, the start article number and an | ||
| 2703 | the article range. | ||
| 2704 | |||
| 2705 | @item gnus-read-ephemeral-gmane-group-url | ||
| 2706 | @findex gnus-read-ephemeral-gmane-group-url | ||
| 2707 | This command is similar to @code{gnus-read-ephemeral-gmane-group}, but | ||
| 2708 | the group name and the article number and range are constructed from a | ||
| 2709 | given @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 |
| 2718 | Read an Emacs bug report in an ephemeral group. Gnus will prompt for | 2696 | Read 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 |
| 17062 | What search engine type is being used. The currently supported types | 17039 | What search engine type is being used. The currently supported types |
| 17063 | are @code{google}, @code{dejanews}, and @code{gmane}. Note that | 17040 | are @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 |
| 21168 | interface. | 21145 | interface. |
| 21169 | 21146 | ||
| 21170 | The @code{nnimap} and @code{gmane} search engines should work with no | 21147 | The @code{nnimap} search engine should work with no configuration. |
| 21171 | configuration. Other engines require a local index that needs to be | 21148 | Other engines require a local index that needs to be created and |
| 21172 | created and maintained outside of Gnus. | 21149 | maintained 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 | ||
| 21218 | To set up nnir you may need to do some prep work. Firstly, you may need | 21195 | To set up nnir you may need to do some prep work. Firstly, you may |
| 21219 | to configure the search engines you plan to use. Some of them, like | 21196 | need to configure the search engines you plan to use. Some of them, |
| 21220 | @code{imap} and @code{gmane}, need no special configuration. Others, | 21197 | like @code{imap}, need no special configuration. Others, like |
| 21221 | like @code{namazu} and @code{swish}, require configuration as described | 21198 | @code{namazu} and @code{swish}, require configuration as described |
| 21222 | below. Secondly, you need to associate a search engine with a server or | 21199 | below. Secondly, you need to associate a search engine with a server |
| 21223 | a backend. | 21200 | or a backend. |
| 21224 | 21201 | ||
| 21225 | If you just want to use the @code{imap} engine to search @code{nnimap} | 21202 | If you just want to use the @code{imap} engine to search @code{nnimap} |
| 21226 | servers, and the @code{gmane} engine to search @code{gmane} then you | 21203 | servers then you don't have to do anything. But you might want to |
| 21227 | don't have to do anything. But you might want to read the details of the | 21204 | read the details of the query language anyway. |
| 21228 | query 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 | |||
| 21262 | can customize the variable @code{nnir-method-default-engines}. This is | 21237 | can customize the variable @code{nnir-method-default-engines}. This is |
| 21263 | an alist of pairs of the form @code{(backend . engine)}. By default this | 21238 | an alist of pairs of the form @code{(backend . engine)}. By default this |
| 21264 | variable is set to use the @code{imap} engine for all servers using the | 21239 | variable 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 |
| 21266 | servers. (Don't worry, the @code{gmane} search engine won't actually try | 21241 | your servers with an @code{nnimap} backend you could change this to |
| 21267 | to 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 | ||
| 21269 | could 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 | |||
| 21327 | The @code{gmane} engine requires no configuration. | ||
| 21328 | |||
| 21329 | Gmane queries follow a simple query language: | ||
| 21330 | |||
| 21331 | @table @samp | ||
| 21332 | @item Boolean query operators | ||
| 21333 | AND, OR, NOT (or AND NOT), and XOR are supported, and brackets can be | ||
| 21334 | used to control operator precedence, e.g., (emacs OR xemacs) AND linux. | ||
| 21335 | Note that operators must be written with all capital letters to be | ||
| 21336 | recognized. | ||
| 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 | ||
| 21343 | The search engine converts all text to utf-8, so searching should work | ||
| 21344 | in any language. | ||
| 21345 | |||
| 21346 | @item Stopwords | ||
| 21347 | Common English words (like 'the' and 'a') are ignored by default. You | ||
| 21348 | can override this by prefixing such words with a + (e.g., +the) or | ||
| 21349 | enclosing the word in quotes (e.g., "the"). | ||
| 21350 | |||
| 21351 | @end table | ||
| 21352 | |||
| 21353 | The query can be limited to articles by a specific author using a | ||
| 21354 | prefix-arg. After inputting the query this will prompt for an author | ||
| 21355 | name (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 | |||
| 21509 | associations are | 21448 | associations 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 |