Changes between Version 3 and Version 4 of WebKitGTK/Debugging

Timestamp:

Nov 21, 2013 8:44:07 AM (10 years ago)

Author:

Andres Gomez

Comment:

--

WebKitGTK/Debugging

@@ -19 +19 @@
 #!sh
 $ Tools/jhbuild/jhbuild-wrapper --gtk run gdb --args WebKitBuild/Debug/Programs/GtkLauncher
+}}}
+
+== Logging support ==
+
+Logging and other output/behaviors support is activated by default in a ''Debug'' build only.
+
+In addition to having the logging support activated in the compilation, we need also to turn on the proper logging channels when running.
+
+These channels are defined in the ''Logging.h'' headers along the code:
+ * [http://trac.webkit.org/browser/trunk/Source/WebCore/platform/Logging.h Source/WebCore/platform/Logging.h]
+ * [http://trac.webkit.org/browser/trunk/Source/WebKit2/Platform/Logging.h Source/WebKit2/Platform/Logging.h]
+
+For passing the wanted channels to the running process we need to use the ''WEBKIT_DEBUG'' env variable as it is seen in:
+ * [http://trac.webkit.org/browser/trunk/Source/WebCore/platform/gtk/LoggingGtk.cpp WebCore/platform/gtk/LoggingGtk.cpp]
+ * [http://trac.webkit.org/browser/trunk/Source/WebKit2/Platform/gtk/LoggingGtk.cpp Source/WebKit2/Platform/gtk/LoggingGtk.cpp]
+ * Notice also the ''DISABLE_NI_WARNING'' env variable referred there.
+
+It is important to export the ''WEBKIT_DEBUG'' env variable so we will want it also to affect the ''WeProcess''.
+ * This is an example for turning on the logging int he ''Network'' channel. Notice that the channels are case insensitive.
+{{{
+#!sh
+$ export WEBKIT_DEBUG="network"
+$ Tools/Scripts/run-minibrowser --gtk
+}}}
+
+It is also possible to turn '''on''' the logging and other output/behaviors support in a ''Release'' build by setting the proper C Macros. You may want to check the [http://trac.webkit.org/browser/trunk/Source/WTF/wtf/Assertions.h Source/WTF/wtf/Assertions.h] header.
+ * This is a ''Release'' build example in which we want to turn on the logging support
+ {{{
+#!sh
+$ export CPPFLAGS="-DLOG_DISABLED=0"
+$ Tools/Scripts/build-webkit --gtk
 }}}
 
@@ -58 +89 @@
 
  * [wiki:WebKitGTK/TrackingMemoryErrors Tracking memory errors in WebKitGTK+]
-