[fricas-devel] FricasUG metapatch: 7 and )set functions cache all all

[Riccardo GUIDA]

Mainly for Ralf...

------------------------------------------------------------------
https://github.com/fricas/fricas/blob/master/src/doc/htex/ug06.htex#L894
REPLACE:
What is the value for \spad{n = 7}?
BY:
What is the value for \spad{n = 3}?
MOTIVATION:
The line below contains facto(3)

------------------------------------------------------------------
https://github.com/fricas/fricas/blob/master/src/doc/htex/ug06.htex#L1218
REPLACE:
Use no list of names or ``all'' when you want to define the default
BY:
Use no list of names when you want to define the default
MOTIVATION:
IIUC, the original sentence suggests that the syntax is
)set functions cache (0|<n>|all) [f...|all]
while a test shows that the syntax is
)set functions cache (0|<n>|all) [f...]
Eg: the trailing ``all`` is interpreted as a function.
(1) -> )set functions cache 0 all
Caching for function all is turned off
(1) -> )set functions cache 3 all
function all will cache the last 3 values.
(1) -> )set functions cache all all
function all will cache all values.
(1) -> )set functions cache all f
function f will cache all values.

If I'm missing another more meaningful interpretation, I would say
that the statement should be rewritten to be unambiguous.
------------------------------------------------------------------

[Ralf Hemmecke]

Post by Riccardo GUIDA
------------------------------------------------------------------
https://github.com/fricas/fricas/blob/master/src/doc/htex/ug06.htex#L894
What is the value for \spad{n = 7}?
What is the value for \spad{n = 3}?
The line below contains facto(3)

Thanks. But I rather changed the line with "facto(3)" to "facto(7)".
Just aesthetical reason, since there is a facto(-7) coming just below.

Post by Riccardo GUIDA
------------------------------------------------------------------
https://github.com/fricas/fricas/blob/master/src/doc/htex/ug06.htex#L1218
Use no list of names or ``all'' when you want to define the default
Use no list of names when you want to define the default
IIUC, the original sentence suggests that the syntax is
)set functions cache (0|<n>|all)  [f...|all]
while a test shows that the syntax is
)set functions cache (0|<n>|all)  [f...]
Eg: the trailing ``all`` is interpreted as a function.
(1) -> )set functions cache 0 all
    Caching for function all is turned off
(1) -> )set functions cache 3 all
    function all will cache the last 3 values.
(1) -> )set functions cache all all
    function all will cache all values.
(1) -> )set functions cache all f
    function f will cache all values.
If I'm missing another more meaningful interpretation, I would say
that the statement should be rewritten to be unambiguous.
------------------------------------------------------------------

OK, it's indeed slightly confusing.

Have you tried to type

)set function cache

in a session?

==================
(1) -> )set function cache
---------------------------- The cache Option -----------------------------

Description: number of function results to cache

)set functions cache is used to tell FriCAS how many
values computed by interpreter functions should be saved. This can save
quite a bit of time in recursive functions, though one must consider that
the cached values will take up (perhaps valuable) room in the workspace.

The value given after cache must either be the word all or a positive
integer. This may be followed by any number of function names whose cache
sizes you wish to so set. If no functions are given, the default cache
size is set.
Examples: )set fun cache all )set fun cache 10 f g Legendre

In general, functions will cache no returned values.
==================

It also does not completely rule out the "all" in such a case.

)set function cache n all

However, clearly "all" in this position can only count as the name of a
fricas function, because there is nothing in FriCAS that forbids a
function to be named "all".

Anyhow. I'll remove the

or "all"

Ralf