diff --git a/gists.org b/gists.org index e91ed45..2bd0132 100644 --- a/gists.org +++ b/gists.org @@ -124,16 +124,16 @@ My vertico-repeat setup. (minibuffer-setup . vertico-repeat-save)) #+end_src -* Execute code on task state changes :emacs:org: +* Evaluate code on task state changes :emacs:org: -#+begin_src org :tangle gists/execute-code-on-task-state-change.org - The function below executes Lisp forms stored in properties of a task, when it changes to a certain state. The function is supposed to be added to the =org-after-todo-state-change-hook=. +#+begin_src org :tangle gists/evaluate-code-on-task-state-change.org + The function below evaluates Lisp forms stored in properties of a task, when it changes to a certain state. The function is supposed to be added to the =org-after-todo-state-change-hook=. - The property should be named =ON_= where =STATE= is a state defined in =org-todo-keywords=. See also the example task below (open this file in [[https://apps.bram85.nl/gitea/bram/gists/raw/branch/main/gists/execute-code-on-task-state-change.org][raw mode]] to see the properties). + The property should be named =ON_= where =STATE= is a state defined in =org-todo-keywords=. See also the example task below (open this file in [[https://apps.bram85.nl/gitea/bram/gists/raw/branch/main/gists/evaluate-code-on-task-state-change.org][raw mode]] to see the properties). ,#+begin_src elisp (defun my/task-state-event-handler () - "Execute a Lisp form attached to the task whose state is being changed. + "Evaluate a Lisp form attached to the task whose state is being changed. When this function is added to org-after-todo-state-change-hook, it looks for a Lisp form stored in the property called ON_ diff --git a/gists/execute-code-on-task-state-change.org b/gists/evaluate-code-on-task-state-change.org similarity index 76% rename from gists/execute-code-on-task-state-change.org rename to gists/evaluate-code-on-task-state-change.org index 34b54da..77c26d1 100644 --- a/gists/execute-code-on-task-state-change.org +++ b/gists/evaluate-code-on-task-state-change.org @@ -1,10 +1,10 @@ -The function below executes Lisp forms stored in properties of a task, when it changes to a certain state. The function is supposed to be added to the =org-after-todo-state-change-hook=. +The function below evaluates Lisp forms stored in properties of a task, when it changes to a certain state. The function is supposed to be added to the =org-after-todo-state-change-hook=. -The property should be named =ON_= where =STATE= is a state defined in =org-todo-keywords=. See also the example task below (open this file in [[https://apps.bram85.nl/gitea/bram/gists/raw/branch/main/gists/execute-code-on-task-state-change.org][raw mode]] to see the properties). +The property should be named =ON_= where =STATE= is a state defined in =org-todo-keywords=. See also the example task below (open this file in [[https://apps.bram85.nl/gitea/bram/gists/raw/branch/main/gists/evaluate-code-on-task-state-change.org][raw mode]] to see the properties). #+begin_src elisp (defun my/task-state-event-handler () - "Execute a Lisp form attached to the task whose state is being changed. + "Evaluate a Lisp form attached to the task whose state is being changed. When this function is added to org-after-todo-state-change-hook, it looks for a Lisp form stored in the property called ON_