diff -r 3a31ca4b29c4 -r b8fa7dfeeaa1 sbsv2/raptor/notes/nodebug.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/sbsv2/raptor/notes/nodebug.txt Wed Oct 06 15:13:17 2010 +0100 @@ -0,0 +1,21 @@ +The "nodebug" variant causes executables to be built without debug +information. It does not affect the macros that are passed to debug +executables or the optimisation flags. + +The use case for nodebug is for a situation where some executables are +so large that they trigger a problem in RVCT2.2's linker for the "udeb" +version of the executable but not for the "urel" version. There is no +known solution for this problem without using a new compiler and since +it isn't currently possible to use different compilers in the same build +this is not an option. + +This variant makes the udeb build of the executable much less useful for +debugging purposes so it is an undesirable workaround for a build problem but +there is no alternative. Newer versions of Symbian support newer compilers +and will not need this feature. It is also not needed when building with GCCE. +We strongly recommend against using this feature. + +For exectuables with this problem one must use the APPLY keyword in the mmp +like so: + +apply nodebug