Re: example queries for nnir

[Harry Putnam <reader@newsguy.com>]

Kai.Grossjohann@CS.Uni-Dortmund.DE (Kai Großjohann) writes:


[...]

> 
> My suggestion meant that you put all the words from the body into the
> global field, and no other words into the global field.  Hence
> searching the global field is the same as searching the body.


Hoookay now I get it... click!

> 
> > > 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 not noticed those examples which probably means many
> > new users would not either.
> 
> Hm.  Okay.  I have tried to explicitly include a pointer to the
> docstrings in the opening comments, but apparently this was not
> explicit enough.  Do you think a wording along the lines of `type C-h
> v nnir-search-engine RET for more information' would be clear enough?

Looking at version 1.57. It looks very clear... I even understood it..
he he

> Do you think it would be better to document it twice?  What about the
> newly changed wording in the opening comments?

After looking at the new stuff, and understanding better the reasoning
involved, I guess I was making a lot of fuss about nothing.  It seems
quite clear how to proceed now. 

> 
> > 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.
> 
> Okay.  FWIW, I have tried to make the variable documentation more
> explicit, too.

I see the new documentation.  Seems much more complete and usefull.
Thanks for being so responsive to this, even though I lack much skill
in this stuff.

Is that really true that wais needs:
`nnir-wais-remove-prefix'?  It doesn't default to /home/$USER/Mail/?

I've only been using:
; (setq nnir-wais-database "/home/reader/.wais/mail1")
; (setq nnir-search-engine `wais)
in ~/.gnus when trying to work with wais.
Maybe part of my troubles.

This new documentation you've done is really well done, I hope it
turns out to be worth the work you put in.