Re: diary-lib.el how about adding diary-schedule

[Lars Ingebrigtsen]

Michael Heerdegen <michael_heerdegen@web.de> writes:

> It could say clearer that DATE is bound
> as a (dynamical) variable, and it should also say that the variable
> ENTRY is also provided (bound to the text found after the expression in
> the diary file - see the docstring of `diary-list-sexp-entries' which
> explains this better.)
>
> Maybe also say that the predefined diary sexp functions use these
> variables implicitly, so that users are not confused about the fact that
> most diary sexps don't contain a reference to DATE.

Yup, sounds like a good idea.

> (3) Something else?  What I don't like about the diary part of the
> manual is that it tells so many details before you get to the above
> paragraph that most people think this is complicated magic.  Whereby
> diary sexps are only trivial Elisp sexps that can refer to the variables
> DATE and ENTRY and whose return value is interpreted by the
> diary/calendar (how the return value is actually interpreted is
> explained quite well OTOH).
>
> What do you think?

Well, the node starts with some examples, and that shows users how
simple these are, really...  we don't get into all the details until
after that.

> I also ask Lars because I very much hope he is motivated to make the
> change, should we agree about something.  This is because I don't speak
> texinfo, and I will soon be on vacation.

I you have a new text here, I can do the texification.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no