Game Development Community

Bug (and Fix) for exec function documentation

by Giuseppe Bertone · in Torque Game Builder · 05/15/2010 (3:46 am) · 0 replies

I noticed the bug while implementing the useful getScopeName() resource by Orion.

Exec function documentation says you should set the $pref::ignoreDSOs global variable so TGB reads .cs before .dso files

ConsoleFunction(exec, bool, 2, 4, "( fileName [ , nocalls [ , journalScript ] ] ) Use the exec function to compile and execute a normal script, or a special journal script.n"
																"If $Pref::ignoreDSOs is set to true, the system will use .cs before a .dso file if both are found.n"
																"@param fileName A string containing a path to the script to be compiled and executed.n"
																"@param nocalls A boolean value. If this value is set to true, then all function calls encountered while executing the script file will be skipped and not called. This allows us to re-define function definitions found in a script file, without re-executing other worker scripts in the same file.n"
																"@param journalScript A boolean value. If this value is set tot true, and if a journal is being played, the engine will attempt to read this script from the journal stream. If no journal is playing, this field is ignored.n"
																"@return Returns true if the file compiled and executed w/o errors, false otherwise.n"
																"@sa compile")

but $pref::ignoreDSOs is never used inside the source code and $Scripts::ignoreDSOs is used instead.

Happy DSO ignoring to all,
byez.