Re: Re: Question about searches (ultimately for agenda)

[Carsten Dominik <carsten.dominik@gmail.com>]

On Dec 19, 2009, at 5:35 AM, Mueen Nawaz wrote:

> On 12/17/09 13:26, Carsten Dominik wrote:
>> Yes, so that the search only continues after that entry. But yes, you
>> are right, this can fail for the final entry in a file.
>>
>> Try
>>
>> '(when (org-entry-is-done) (outline-next-heading) (point))
>
> 	Seems to work.
>
>>> Also, I'm pretty weak with Emacs Lisp. What does (point) do?  
>>> Google's
>>> no help (obviously).
>>
>> Point returns the buffer position of he cursor, in this case the
>> position where the next entry starts.
>
> 	OK. I guess I don't understand why we need to know where the point  
> is.

The agenda skip function is called to check if an entry should be  
skipped.  At each entry that matches the current query definition  
while sweeping an agenda file, this function will be called to give  
you a final chance to say NO to this entry.  If it returns nil, that  
means, OK, take the entry and put it into the agenda.  If it returns  
something else, that must be the location from where to resume search  
for another match of your query.

For example it can return the location of the end of the current entry  
to make search continue from there.  Or the location of the end of the  
entire subtree end to make search continue from there.  You could also  
return (point-at-eob) to make sure that after skipping this entry, the  
search in this buffer will find nothing more.  You you also make it  
return 1 o start from the beginning of the bugger an in this way end  
up in an infinite loop :-)

Clearer now?

> Is this returning the value of the point in whatever buffer I am  
> when I /execute/ the agenda command? Or is this more like the  
> function is sweeping the point across all agenda files to find  
> headlines? Or...?
>
>
>
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

- Carsten