documentation: use-function / batch run from command line

Hello,

just a litte hint that the SamUL documentation
is missing two very handy features.

Although the use-function for self-defined functions is present in
the "Basic Language Tests" I could not find anything about it
in the documentation.

The usage might be noted in a single paragraph in
"SamUL Scripting Language - Function Calls"

Expecially the possibility to incluce exported *.sul files,
which is very handy as it allows to maintain a single
functions-file across all SAM-cases.

E.g.

use "c:\SAM\MyFunctions.sul"

Another thing that should be noted in the documentation is the
syntax to run SamUL scripts from the command line.
It can be found here in the forum, but
(sam.nrel.gov/content/command-line-batch-run)

Kind regards,
Joe

Hello Paul,

the sample with the basic functions introduces the
"use" command to include files, but I could not find
anything about it in the documentation.
It just mentiones

"SAM saves the SamUL script in the .zsam file where you created the script. You do not need to save the script to an .sul file unless you want to use it in a different .zsam file."

but not how to use it in different zsam-files.

And it took me a while to find out, that it is possible
to "use" external files, too. I thought they have to
be within the same zsam-file.

As far as I remember I did not read anything about that
in the documentation, just remembered that it was working
in Soltrace, its called import there, and gave it a try.

I just thought that "SamUL: Function Calls" might be a good place
to introduce this feature, and explain that it works with
exported *.sul files, too.
I did not get that in the beginning and I have quite some experience :)

The main motivation to me was that if you have lots of user functions
it is good practice to store each of them in a single file or a
topic-file (statistics, solar, numerical...).

Keep up the good work!
Kind regards,
Joe

Hello,
I've written a SamUL script that I would like to access from other SamUL scripts. I understand how function calls work within a single script but how do you call another script as a function?

I can't find any reference to doing that in the Function call section fo the manual.
Reguards,
Pam