From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/31483 Path: main.gmane.org!not-for-mail From: Harry Putnam Newsgroups: gmane.emacs.gnus.general Subject: Re: example queries for nnir Date: 20 Jun 2000 16:32:46 -0700 Sender: owner-ding@hpc.uh.edu Message-ID: References: NNTP-Posting-Host: coloc-standby.netfonds.no Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: main.gmane.org 1035167888 14319 80.91.224.250 (21 Oct 2002 02:38:08 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Mon, 21 Oct 2002 02:38:08 +0000 (UTC) Return-Path: Original-Received: from karazm.math.uh.edu (karazm.math.uh.edu [129.7.128.1]) by mailhost.sclp.com (Postfix) with ESMTP id 5DF0AD051F for ; Tue, 20 Jun 2000 19:38:42 -0400 (EDT) Original-Received: from sina.hpc.uh.edu (lists@Sina.HPC.UH.EDU [129.7.3.5]) by karazm.math.uh.edu (8.9.3/8.9.3) with ESMTP id SAC28978; Tue, 20 Jun 2000 18:34:52 -0500 (CDT) Original-Received: by sina.hpc.uh.edu (TLB v0.09a (1.20 tibbs 1996/10/09 22:03:07)); Tue, 20 Jun 2000 18:33:43 -0500 (CDT) Original-Received: from mailhost.sclp.com (postfix@sclp3.sclp.com [204.252.123.139]) by sina.hpc.uh.edu (8.9.3/8.9.3) with ESMTP id SAA05912 for ; Tue, 20 Jun 2000 18:33:30 -0500 (CDT) Original-Received: from mail.networkone.net (mail.networkone.net [209.144.112.75]) by mailhost.sclp.com (Postfix) with SMTP id C95F6D051F for ; Tue, 20 Jun 2000 19:34:03 -0400 (EDT) Original-Received: (qmail 29258 invoked from network); 20 Jun 2000 23:34:02 -0000 Original-Received: from adsl-117-113.ln.networkone.net (HELO reader.ptw.com) (209.144.117.113) by mail.networkone.net with SMTP; 20 Jun 2000 23:34:02 -0000 Original-Received: (from reader@localhost) by reader.ptw.com (8.9.3/8.9.3) id QAA22092; Tue, 20 Jun 2000 16:34:00 -0700 Original-To: ding@gnus.org In-Reply-To: Kai.Grossjohann@CS.Uni-Dortmund.DE's message of "Tue, 20 Jun 2000 18:30:40 +0200" User-Agent: Gnus/5.0807 (Gnus v5.8.7) Emacs/20.5 Original-Lines: 168 Precedence: list X-Majordomo: 1.94.jlt7 Xref: main.gmane.org gmane.emacs.gnus.general:31483 X-Report-Spam: http://spam.gmane.org/gmane.emacs.gnus.general:31483 Kai.Grossjohann@CS.Uni-Dortmund.DE (Kai Gro=DFjohann) writes: [...] > >=20 > > So, there is no way to search just the body by itself? >=20 > This depends on the format file. In a `region...end' stanza, the BOTH > keyword means that the words are index both in the given field and in > the global field. If you put LOCAL there, the words are only put into > the given field, and not in the global field. Unless there is the possibility of a `body' field, how can the above allow a body only search? >=20 > Btw, I think `stemming SOUNDEX' is not a working combination. Use > just `SOUNDEX' instead. OK .. thanks > > [...] snipped good examples > >=20 > >=20 > > > > ;; . . . . . . . . . . . . . . . . . . . . . . . . . . . . The > > > > ;; second variable to set is `nnir-search-engine'. Choose one of t= he > > > > ;; engines listed in `nnir-engines'. > > >=20 > > > I have now included an explicit pointer to the variable > > > documentation. I have also tried to beef up the documentation for > > > nnir-engines. Did it help? New version on ftp server, > > > ftp://ls6-ftp.cs.uni-dortmund.de/pub/src/emacs/ > >=20 > > Checking that version, I see what is changed but it still doesn't make > > it clear how using the engines in that alist might look when included > > in nnir variables. >=20 > Are you saying that (setq nnir-search-engine 'wais) and (setq > nnir-search-engine 'imap) is not sufficient and that I should include > the full list of allowed symbols? Very sorry Kai, but I thought we were discussing the opening comments in nnir.el. Which should probably include the examples you refer to above. Those that appear in that actual code as documnet strings. I had n= ot noticed those examples which probably means many new users would not either. So no, I'm not saying all possible examples need to be shown only that the examples should appear with the discussion in opening comments as well. >=20 > > Going form this: > > nnir-engines's value is=20 > > ((glimpse nnir-run-glimpse > > ((group . "Group spec: "))) > > (wais nnir-run-waissearch nil) > > (excite nnir-run-excite-search nil) > > (imap nnir-run-imap nil)) > >=20 > > to this: > > (setq nnir-search-engine 'glimpse) > >=20 > > Is not apparent from nnir.el comments, unless you know a little lisp. >=20 > Hm. Okay. Hm. What can I do? List the allowed symbols for the > default value in the doc string? Tell the user what to type to learn > which symbols are allowed? Probably best to include the examples in the opening comments where the variable are first mentioned, *and* instruct how to see the doc string documentation. Sorry if this seems like over kill but it seems to me this should all be included where the discussion of nnir varilables takes place. > > Including some simple examples of actual settings might be more > > usefull. >=20 > I have tried to do this in the doc string for nnir-engines. Yes I see that now.. I had missed it in my previous post. > > Indicating which are default setting would help too. Nnir.el does > > this for the some of the variables pertaining to glimpse and wais > > already. >=20 > If you don't change a variable, type C-h v to get the default value. > If you change a variable, M-x find-variable RET might help. Yes, for experienced emacs users this is common knowledge but you seemed to feel it was necessary to mention some defaults in the opening nnir.el comments like: ;; . . . . . . . . . . . . . . . . . . . . . . . . The variable ;; `nnir-wais-remove-prefix' should contain a regex matching exactly ;; this prefix. It defaults to `$HOME/Mail/' (note the trailing ;; slash). and: ;; . . . . . . . . . . . . . . . . . .The `nnir-glimpse-home' ;; variable should be set to the value of the `-H' option which allows ;; one to search this Glimpse index. I have indexed my whole home ;; directory with Glimpse, so I assume a default of `$HOME'. I think this is a good practice and was only suggesting that any of the variables discussed in comments should also have any defaults pointed out. > > ## variable nnir-mail-backend example settings: > >=20 > > ## If gnus-secondary-select-methods is set to only one of either nnml > > ## or nnmh backend then nnir will default to that backend (Kai, is > > ## this true?) >=20 > No, the default value for nnir-mail-backend is (nnml ""), regardless > of the gnus-secondary-select-methods setting. >=20 > Should I change the default value to be (car > gnus-secondary-select-methods)?=20 Err no.... probably not since that would probably give confusing results to people with nnfolder or whatever. Probably sufficient to mention that `nnml ""' is the default. Also it is clearly pointed out in nnir.el comments that nnml and nnmh are the only backends supported. >=20 > > ## If more than one mail backend is used then nnir-mail-backend can be= =20 > > ## set like this (must be nnml or nnmh): > > ## (setq nnir-mail-backend '(BACKEND "NAME")) <=3D=3D(probably not ac= curate) > > ## (setq nnir-mail-backend '(nnml "my-server")) >=20 > Also see the documentation for nnir-mail-backend which says that it > might be best to get the value from gnus-secondary-select-methods. >=20 > You must include _all_ server parameters. >=20 > > ## variable nnir-search-engines example settings: > > ## (setq nnir-search-engine 'BACKEND) > > ## (setq nnir-search-engine 'glimpse) > > ## (setq nnir-search-engine 'wais) >=20 > I have included `wais' and `imap' examples in the documentation for > nnir-engines.=20 >=20 > > Similar examples following the sections on glimpse and wais, in there > > `setq' format for inclusion in gnus would be nice too: > > Something like: > >=20 > > (setq nnir-glimpse-remove-prefix "/PATH/DIRECTORY/") > >=20 > > or > >=20 > > (setq nnir-glimpse-home "/PATH/DIRECTORY/"/ >=20 > I have now tried to do this. What do you think about the new version? I don't see that in the opening comments. The variable documentation is superb now. I may be all wet thinking these examplse should also appear there but it seems to follow if it makes sense to have the discussion in the opening comments. Not a big issue I guess.