DebugSwitches - Revision history

Orudge: Reformat and update

2011-06-18T18:39:48Z

Reformat and update

@@ Line 1: / Line 1: @@
 Debug switches are not useful for most people, but they can sometimes help fixing odd problems in the patch. They are mostly intended to be used by developers when testing the patch.
@@ Line 90: / Line 84: @@
 |r||Do not run TTDLOAD(W).OVL directly (since 2.5 beta 9)
 |}

Pm-bot: Bot: Automated text replacement (--= +==)

2011-06-15T11:31:14Z

Bot: Automated text replacement (--= +==)

Show changes

Orudge: 11 revisions

2011-06-12T19:04:19Z

11 revisions

← Older revision	Revision as of 19:04, 12 June 2011
(No difference)

dmccoy at 05:01, 18 October 2006

2006-10-18T05:01:13Z

← Older revision		Revision as of 05:01, 18 October 2006
Line 48:		Line 48:
	L+ \|Load language data from the file named -+language.dat+- instead of the TTDPatch executable.  Useful in debugging because many debuggers fail to load symbol information with those data appended to the executable.		L+ \|Load language data from the file named -+language.dat+- instead of the TTDPatch executable.  Useful in debugging because many debuggers fail to load symbol information with those data appended to the executable.

	C+ \|Load patch code from -+ttdprotd.bin+- for DOS or -+ttdprotw.bin+- for Windows.  Useful in debugging because many debuggers fail to load symbol information with that code appended to the executable.		C+ \|Load patch code from -+loaderd.bin+- and -+ttdprotd.bin+- for DOS or -+loaderw.bin+- and -+ttdprotw.bin+- for Windows.  Useful in debugging because many debuggers fail to load symbol information with that code appended to the executable.

	R+\|Load relocation information ~~fro~~ -+~~reloc~~.bin+-.  Useful in debugging because many debuggers fail to load symbol information with that code appended to the executable.		R+\|Load relocation information from -+relocd.bin+- for DOS or -+relocw.bin+- for Windows.  Useful in debugging because many debuggers fail to load symbol information with that code appended to the executable.

	I- \|Prevent the enhanced keyboard handler from updating keyboard LED indicators.  The Lock keys will still toggle internal flags, though. (DOS only)		I- \|Prevent the enhanced keyboard handler from updating keyboard LED indicators.  The Lock keys will still toggle internal flags, though. (DOS only)

dmccoy at 10:36, 12 October 2006

2006-10-12T10:36:07Z

← Older revision		Revision as of 10:36, 12 October 2006
Line 49:		Line 49:

	C+ \|Load patch code from -+ttdprotd.bin+- for DOS or -+ttdprotw.bin+- for Windows.  Useful in debugging because many debuggers fail to load symbol information with that code appended to the executable.		C+ \|Load patch code from -+ttdprotd.bin+- for DOS or -+ttdprotw.bin+- for Windows.  Useful in debugging because many debuggers fail to load symbol information with that code appended to the executable.

			R+\|Load relocation information fro -+reloc.bin+-.  Useful in debugging because many debuggers fail to load symbol information with that code appended to the executable.

	I- \|Prevent the enhanced keyboard handler from updating keyboard LED indicators.  The Lock keys will still toggle internal flags, though. (DOS only)		I- \|Prevent the enhanced keyboard handler from updating keyboard LED indicators.  The Lock keys will still toggle internal flags, though. (DOS only)

dmccoy at 07:40, 12 October 2006

2006-10-12T07:40:58Z

New page

'''''Modifying how TTDPatch works'''''

=Debug switches=

Modifying how TTDPatch works

Debug switches are not useful for most people, but they can sometimes help fixing odd problems in the patch.  They are mostly intended to be used by developers when testing the patch.

To use them, they must be the first switch on TTDPatch's command line, and start with an exclamation mark, "!".  After the exclamation mark follows the list of debug switches, each of them possibly trailed by a "+" or "-" to choose two different modes of operation.  Currently if neither "+" nor "-" is specified, "+" is assumed. An example:<pre>-+ttdpatch.exe -!v+T+w-+-</pre>

This would run TTDPatch to collect new version information and terminate before even starting TTD.  If any warnings occur, they are ignored.

Alternatively, since revision 798 debug switches may be specified in the configuration file: <pre>-+debugswitches v+T+w-+-</pre>

Here's the complete list of debug switches:

||Switch |Meaning

v- |Ignore TTD version info stored with TTDPatch (i.e. do not recognize TTD version)

v+ |Collect TTD version info and write to a file

s- |Never swap out the real mode code when starting TTD (DOS only)

s+ |Always swap out the real mode code when starting TTD (DOS only)

c |This switch is very special: if specified, TTDPatch will not process the command line options as usual, instead it will treat the rest of the command line as name and arguments of a program to run.  This feature can be used to analyze TTDPatch's memory usage in the DOS version.

t- |Assume -+TTDLOAD(W).OVL+- exists and is correct, don't process it or try to locate the original files.  Currently this is useful only if combined with the c debug switch, otherwise it'll prevent TTDPatch from working and may cause a crash.

m- |Run even if there's not enough memory to start TTD (DOS only)

f- |Don't read or create the default -+ttdpatch.cfg+-

a- |Don't check dependencies between switches.  If used, TTDPatch will not correct illegal combinations of switches. Warning: some switch combinations are dangerous.  For example, if startyear is set to 1927 and generalfixes to off, TTD will probably hang when you try to start a new random game.  Normally, i.e. without this debug switch, TTDPatch would prevent that by turning generalfixes on.  See [[NewStartingYear|New Starting Year]] for more information.

w- |Do not wait for a key after a warning message, just continue

w+ |Do not wait for a key after a warning message, just abort

o+ |Reorder all switches alphabetically when writing a configuration file, not only the new ones

T- |Terminate TTDPatch after parsing the cfg/cmdline (only TTDPatch 2.0.1 alpha 51 or higher)

T+ |Terminate TTD immediately after collecting version information (see v+)

L+ |Load language data from the file named -+language.dat+- instead of the TTDPatch executable.  Useful in debugging because many debuggers fail to load symbol information with those data appended to the executable.

C+ |Load patch code from -+ttdprotd.bin+- for DOS or -+ttdprotw.bin+- for Windows.  Useful in debugging because many debuggers fail to load symbol information with that code appended to the executable.

I- |Prevent the enhanced keyboard handler from updating keyboard LED indicators.  The Lock keys will still toggle internal flags, though. (DOS only)

S+ |Dump information about all supported switches (non-debug, non-special ones) to swtchlst.txt and abort

S-|Write current patch version and switch information in XML format to switches.xml and abort (only TTDPatch 2.0.1 alpha 21 or higher)

P+|Don't check ttdpatch.dll to see if it needs to be updated.

n+ |Use noregistry information from registry.ini

n- |Do not use noregistry information

r|Do not run TTDLOAD(W).OVL directly (since 2.5 beta 9)||

dmccoy at 03:25, 12 June 2005

2005-06-12T03:25:02Z

New page

'''''Modifying how TTDPatch works'''''

=Debug switches=

Modifying how TTDPatch works

Debug switches are not useful for most people, but they can sometimes help fixing odd problems in the patch.  They are mostly intended to be used by developers when testing the patch.

To use them, they must be the first switch on TTDPatch's command line, and start with an exclamation mark, "!".  After the exclamation mark follows the list of debug switches, each of them possibly trailed by a "+" or "-" to choose two different modes of operation.  Currently if neither "+" nor "-" is specified, "+" is assumed. An example:<pre>-+ttdpatch.exe -!v+T+w-+-</pre>

This would run TTDPatch to collect new version information and terminate before even starting TTD.  If any warnings occur, they are ignored.

Here's the complete list of debug switches:

||Switch |Meaning

v- |Ignore TTD version info stored with TTDPatch (i.e. do not recognize TTD version)

v+ |Collect TTD version info and write to a file

s- |Never swap out the real mode code when starting TTD (DOS only)

s+ |Always swap out the real mode code when starting TTD (DOS only)

c |This switch is very special: if specified, TTDPatch will not process the command line options as usual, instead it will treat the rest of the command line as name and arguments of a program to run.  This feature can be used to analyze TTDPatch's memory usage in the DOS version.

t- |Assume -+TTDLOAD(W).OVL+- exists and is correct, don't process it or try to locate the original files.  Currently this is useful only if combined with the c debug switch, otherwise it'll prevent TTDPatch from working and may cause a crash.

m- |Run even if there's not enough memory to start TTD (DOS only)

f- |Don't read or create the default -+ttdpatch.cfg+-

a- |Don't check dependencies between switches.  If used, TTDPatch will not correct illegal combinations of switches. Warning: some switch combinations are dangerous.  For example, if startyear is set to 1927 and generalfixes to off, TTD will probably hang when you try to start a new random game.  Normally, i.e. without this debug switch, TTDPatch would prevent that by turning generalfixes on.  See [[NewStartingYear|New Starting Year]] for more information.

w- |Do not wait for a key after a warning message, just continue

w+ |Do not wait for a key after a warning message, just abort

o+ |Reorder all switches alphabetically when writing a configuration file, not only the new ones

T- |Terminate TTDPatch after parsing the cfg/cmdline (only TTDPatch 2.0.1 alpha 51 or higher)

T+ |Terminate TTD immediately after collecting version information (see v+)

L+ |Load language data from the file named -+language.dat+- instead of the TTDPatch executable.  Useful in debugging because many debuggers fail to load symbol information with those data appended to the executable.

C+ |Load patch code from -+ttdprotd.bin+- for DOS or -+ttdprotw.bin+- for Windows.  Useful in debugging because many debuggers fail to load symbol information with that code appended to the executable.

I- |Prevent the enhanced keyboard handler from updating keyboard LED indicators.  The Lock keys will still toggle internal flags, though. (DOS only)

S+ |Dump information about all supported switches (non-debug, non-special ones) to swtchlst.txt and abort

S-|Write current patch version and switch information in XML format to switches.xml and abort (only TTDPatch 2.0.1 alpha 21 or higher)||