OOF2: The Manual

OOF.Help.Debug.Debug
	6.2. Menus

Name

OOF.Help.Debug.Debug — Turn debugging mode on and off.

Synopsis

OOF.Help.Debug.Debug(boolean)

Details

Parent Menu: OOF.Help.Debug
Callback: function set_debug in module ooflib.common.IO.mainmenu
Parameters:

boolean

A boolean value, 0 (false) or 1 (true). This is not a keyword parameter. In scripts, just enter '0' or '1', not 'boolean=1'.

Description

Calling this command with an argument of True turns debugging mode on. Calling with with an argument of False turns it off. In debugging mode, menu commands are echoed to the terminal from which OOF2 was launched, along with other debugging information.

Debugging mode can also be turned on by providing the --debug command line argument. Doing it this way initializes the random number generator with a special seed (17, the most random integer) and adds a few more testing commands to the OOF.Help.Debug menu. Initializing the random number is done to ensure that program behavior is deterministic in debug mode.

Echoed commands look like this:

    -0013-00--------------- ====0027==== OOF.Skeleton.New(name='bones', ...))

	The stack depth of the Python interpreter.
	The thread that the command is running on.
	The number of dashes is the same as the stack depth, to make it easier to recognized nested routines.
	The sequence number of the command.
	The menu command itself.

Other debugging output looks like this:

    -0004-02------ mainmenu.py(115):loaddata done loading oofdata.py

	The stack depth of the Python interpreter.
	The thread that is printing the message.
	A number of dashes equal to the stack depth.
	The file containing the code containing the debugging line.
	The location within the file of the debugging line.
	The function containing the debugging line.
	The debugging message itself.


OOF.Help.Debug.Compare_Meshes		OOF.Help.Debug.Random