Index: trunk/tools/debug_sample.php
===================================================================
diff -u -N -r4135 -r4940
--- trunk/tools/debug_sample.php	(.../debug_sample.php)	(revision 4135)
+++ trunk/tools/debug_sample.php	(.../debug_sample.php)	(revision 4940)
@@ -1,8 +1,9 @@
 <?php
 
-	//define('SILENT_LOG', 1);
+//	define('SILENT_LOG', 1); // write all sql errors to log
+//	define('DBG_REQUREST_LOG', $_SERVER['DOCUMENT_ROOT'].'/../request.log'); // write all POST/GET request log to file
 	
-	define('DEBUG_MODE', 1);
+	define('DEBUG_MODE', 1); // enable/disable debug mode
 	if( defined('DEBUG_MODE') && DEBUG_MODE ) InitDebugger();
 	
 	//define('DBG_SITE_PATH', '/');	// set alternative BASE_PATH for old in-portal parts (where no K4 included)
@@ -11,27 +12,29 @@
 	
 	function InitDebugger()
 	{
-		define('DBG_LOCAL_BASE_PATH', 'w:');
+		define('DBG_LOCAL_BASE_PATH', 'w:'); // replace server's DocumentRoot by this path in filenames in errors
 		
-//		define('DBG_RAISE_ON_WARNINGS',1);
+//		define('DBG_RAISE_ON_WARNINGS', 1); // show debugger automatically if some errors occured
 		define('DBG_SQL_PROFILE',1);	// profile SQL queries
 		define('DBG_SQL_FAILURE', defined('IS_INSTALL') && IS_INSTALL ? 0 : 1);	// assume sql errors as php fatal errors, warning otherwise
 		
+//		define('DBG_PROFILE_INCLUDES', 1);
+
 		define('DBG_SHOW_HTTPQUERY', 1);	// show http query content
 		define('DBG_SHOW_SESSIONDATA', 1);	// show session data
 
-		define('DBG_SHOW_EXPIRATION', 1); // show session expiration counter in admin
-		
 //		define('DBG_EDIT_HELP', 1);	// Show help filename on help screen
 //		define('DBG_HELP', 1);		// Show FCK editor when viewing help screen
 		
 //		define('DBG_FORCE_THEME', 1);	// Use this ThemeId, not one passed in env
 		define('DBG_PHRASES', 1);		// Add ability to translate phrases on the fly (K4 only)
+//		define('DBG_PHRASES_HIGHLIGHT', 1); // used for phrase existance detection debugging
+		
 		define('DBG_WINDOW_WIDTH', 700);// Set custom debugger layer width (in pixels)
 		
-		define('DBG_CACHE', 1);	// debug cache usage
-//		define('DBG_REDIRECT', 1);
-//		define('DBG_ZEND_PRESENT',0);
+//		define('DBG_CACHE', 1);	// debug cache usage
+//		define('DBG_REDIRECT', 1); // set this to debug get redirect attempts
+		define('DBG_ZEND_PRESENT', 0); // set this to zero to debug debugger
 		//define('DBG_VALIDATE_CONFIGS',1);	// check that config fields match ones from database
 //		define('DBG_SHOW_TAGS', 1);		// show tags beeing processed