From v10.2.0, in a function call the designator library binds to, i.e. calls data from, the (library) note holding the function. this allows a function to have 'internal' attribute settings to assist with configuration of function process or to store global values.
The designator meaning has no value outside a function call. So in a note:
$MyResult = fDoSomething($ID,$MakeLists(designator));
would return data from the calling note (accessed via $ID) and with the function's code modified by it reading the value of its $MakeLists
attribute (in this case likely a boolean: do/do not make lists.
Otherwise:
Dont' do this!$MyResult = $MakeLists(designator);
returns nothing. To read fDoSomething()
's $MakeList value externally, requires giving the name/path/ID of the library note whose $text contains the function. Thus if fDoSomething()
is in the $Text of library note 'Test Library', $MakeList can be read thus:
$MyResult = $MakeLists("Test Library");
NOTE: function 'designator' attribute values are thus shared by all functions in the same note. this may affect whether a single library note is used for multiple values or functions are store in discrete note or as groups of functions.