From: Lars Ingebrigtsen <larsi@gnus.org>
To: Michael Heerdegen <michael_heerdegen@web.de>
Cc: "Gijs Hillenius" <gijs@hillenius.net>, emacs-devel@gnu.org
Subject: Re: diary-lib.el how about adding diary-schedule
Date: Thu, 26 Aug 2021 21:48:18 +0200 [thread overview]
Message-ID: <87sfywt2bh.fsf@gnus.org> (raw)
In-Reply-To: <87czq0s02r.fsf@web.de> (Michael Heerdegen's message of "Thu, 26 Aug 2021 17:22:04 +0200")
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
prev parent reply other threads:[~2021-08-26 19:48 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-08-20 9:57 diary-lib.el how about adding diary-schedule Gijs Hillenius
2021-08-21 13:09 ` Lars Ingebrigtsen
2021-08-22 7:33 ` Gijs Hillenius
2021-08-22 21:59 ` Lars Ingebrigtsen
2021-08-24 14:37 ` Michael Heerdegen
2021-08-25 7:39 ` Gijs Hillenius
2021-08-25 10:55 ` Michael Heerdegen
2021-08-26 15:22 ` Michael Heerdegen
2021-08-26 19:48 ` Lars Ingebrigtsen [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87sfywt2bh.fsf@gnus.org \
--to=larsi@gnus.org \
--cc=emacs-devel@gnu.org \
--cc=gijs@hillenius.net \
--cc=michael_heerdegen@web.de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).