Manual: clarify potential naming issues in steady state files

added documentation label

On Mattermost, @stepan-a explained that it’s still possible to name variables alpha and the like when there is a user-defined steady state file. The only restriction is that you must take care of initializing them with some value, so that the MATLAB parser knows that they’re variables and not functions. Is my understanding correct? If yes, then I’d rather modify the manual in that direction, to make it clear that those special names are not forbidden, but just need to be handled with special care.

assigned to @sebastien

The new phrasing is one of a recommendation, not a restriction. What @stepan-a describes is true, but requires an amount of sophistication our average user who consults the manual does not have. That was the reason for the warning in the first place.

I have an additional problem. The explicit initialization is only required if there is a naming conflict, but that will depend on the toolboxes installed. I regularly have people using Greek letters, with the files not working on my machine because I have many toolboxes. I found that annoying and preferred the disclaimer.

merged

mentioned in commit 8a6ea144