Re: FR: headline iteration API

["Eddward DeVilla" <eddward@gmail.com>]

Are the functions behind C-c C-N, C-c C-p, C-c C-f, C-c C-b & C-c C-u
available?  Seems you could add a function for going to the first
child.  As long as that, C-c C-f & C-c C-b all return something to let
you know there isn't a next, this should be pretty complete.

I guess all you would need would be the following functions which
would move to the correct place or return something to say there isn't
a next/parent/child/sibling etc to signal the end of iteration.

 - doc traversal
    - first-item
      Go to the first item in the file.
    - current-item
      Go to the beginning of the item containing the cursor.
    - next-item
      Go to the item after the current one.
    - previous-item
      Go to item before the current one

 - tree traversal
    - parent-item
      Go to the parent item of the current item
    - first-child-item
      Go to the first item contained in the current item
    - next-sibling-item
      Go to the next item that has the same parent
    - previous-sibling-item
      Go to the previous item that has the same parent

This ought to be enough to try to implement anything else on top of
it.  Did I miss something?

Edd


On Wed, Jun 11, 2008 at 6:06 AM, Adam Spiers <orgmode@adamspiers.org> wrote:
> On Wed, Jun 11, 2008 at 08:57:39AM +0200, Dominik, C. wrote:
>> Hi Adam and others,
>>
>> I do like the idea of an API to iterate of entries and outline trees.
>> For now, I am following this discussion to see what ideas pop up.
>> When I find the time, something will be implemented.
>
> Great.  As you can see from my other post, another use case just
> popped up.
>
> Am I right in thinking that you must already have a lot of the code
> for this?  Presumably agenda generation and export must both do
> headline iteration in a similar manner?
>
> Full-blown reporting would be seriously cool.  Think: pretty coloured
> graphs showing how the contents of your TODO lists vary over the days,
> weeks, months ... :-)  Very useful for trending, planning, ensuring
> that the various areas of your life are kept in balance according to
> your "30,000-50,000 foot views", as David Allen calls them.
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Remember: use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>