From cde6d39d5aa0552740b6984b4149d963c055cdaf Mon Sep 17 00:00:00 2001 From: Douglas RAILLARD Date: Tue, 23 Apr 2019 10:13:32 +0100 Subject: [PATCH 1/2] doc: exekall: add details on non-reusable types --- tools/exekall/doc/man/man.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/tools/exekall/doc/man/man.rst b/tools/exekall/doc/man/man.rst index 32f0cd076..780479d33 100644 --- a/tools/exekall/doc/man/man.rst +++ b/tools/exekall/doc/man/man.rst @@ -130,7 +130,8 @@ Execution Executing an expression means evaluating each node if it has not already been evaluated. If an operator is not reusable, it will always be called when a value is requested from it, even if some existing values computed with the same -parameters exist. +parameters exist. By default, all operators are reusable, but some types can be +flagged as non-reusable by the customization module (see :ref:`customize`). Operators are allowed to be generator functions as well. In that case, the engine will iterate over the generator, and will execute the downstream @@ -273,6 +274,8 @@ why. Most common issues are: file directly to ``exekall run``. * Wrong goal selected using ``--goal``. +.. _customize: + CUSTOMIZING EXEKALL +++++++++++++++++++ -- GitLab From e783c36e3fdd03a4019a6138f4bc23add5d5b27e Mon Sep 17 00:00:00 2001 From: Douglas RAILLARD Date: Wed, 24 Apr 2019 11:09:15 +0100 Subject: [PATCH 2/2] doc: update man page --- doc/man1/exekall.1 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/man1/exekall.1 b/doc/man1/exekall.1 index 6767180cf..f4d8387c3 100644 --- a/doc/man1/exekall.1 +++ b/doc/man1/exekall.1 @@ -311,7 +311,8 @@ The expression execution engine logs when a given value is computed or reused. Executing an expression means evaluating each node if it has not already been evaluated. If an operator is not reusable, it will always be called when a value is requested from it, even if some existing values computed with the same -parameters exist. +parameters exist. By default, all operators are reusable, but some types can be +flagged as non\-reusable by the customization module (see \fI\%CUSTOMIZING EXEKALL\fP). .sp Operators are allowed to be generator functions as well. In that case, the engine will iterate over the generator, and will execute the downstream -- GitLab