Reviewed by Beth.
authorggaren <ggaren@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Tue, 1 Aug 2006 18:41:04 +0000 (18:41 +0000)
committerggaren <ggaren@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Tue, 1 Aug 2006 18:41:04 +0000 (18:41 +0000)
        - Added instructions for debugging in Xcode

        * building/build-window.png: Added.
        * building/build.html:
        * building/custom-executable.png: Added.
        * building/info-tab.png: Added.

git-svn-id: https://svn.webkit.org/repository/webkit/trunk@15739 268f45cc-cd09-0410-ab3c-d52691b4dbfc

WebKitSite/ChangeLog
WebKitSite/building/build-window.png [new file with mode: 0644]
WebKitSite/building/build.html
WebKitSite/building/custom-executable.png [new file with mode: 0644]
WebKitSite/building/info-tab.png [new file with mode: 0644]

index bd42844c8fb79459ff88e98b2c2065bd1b99f560..c434993c2a91deb7b412b95bafb90a576824c29c 100644 (file)
@@ -1,3 +1,14 @@
+2006-08-01  Geoffrey Garen  <ggaren@apple.com>
+
+        Reviewed by Beth.
+        
+        - Added instructions for debugging in Xcode
+
+        * building/build-window.png: Added.
+        * building/build.html:
+        * building/custom-executable.png: Added.
+        * building/info-tab.png: Added.
+
 2006-07-30  Geoffrey Garen  <ggaren@apple.com>
 
         Reviewed by Beth.
diff --git a/WebKitSite/building/build-window.png b/WebKitSite/building/build-window.png
new file mode 100644 (file)
index 0000000..0d5d116
Binary files /dev/null and b/WebKitSite/building/build-window.png differ
index 9d3368b3e8ec5cf79d33b6e537716d0cdf109fe8..3aca826182859cb15481829d071dcf989bbf3343 100644 (file)
 <p>The <tt>run-safari</tt> script sets the <tt>DYLD_FRAMEWORK_PATH</tt> environment variable to point to your build products, 
 and then launches /Applications/Safari.app. <tt>DYLD_FRAMEWORK_PATH</tt> tells the system loader to prefer your build products over the frameworks installed in /System/Library/Frameworks.</p>
 
+<h2>Debugging the WebKit You Built in Xcode</h2>
+<ol>
+<li><p>Open a project</p>
+<p>Each WebKit component -- JavaScriptCore, WebCore, and WebKit -- contains its own Xcode project. Open the project belonging to the component you want to debug.</p>
+</li>
+<li><p>Set the project's build products location</p>
+<p>To find the WebKit you built, Xcode needs to know the build products location that <tt>build-webkit</tt> used. You can set the build products location from the project's Info window.</p>
+<img src="info-tab.png"></img>
+</li>
+<li><p>Set the project's active build configuration</p>
+<p>Xcode also needs to know the build configuration you used. You can set the active build configuration from the project's Build window.</p>
+<img src="build-window.png"></img>
+</li>
+<li><p>Add a custom executable to the project</p>
+<p>Choose any WebKit application you want to use for debugging. To use Safari, select /Applications/Safari.app.</p>
+<img src="custom-executable.png"></img>
+</li>
+<li><p>Set the project's active executable</p>
+<p>Choose the executable you just added. You can set the active build configuration from the project's Build window, pictured above.</p>
+</li>
+<li><p>Close and re-open the project</p>
+<p>This will force Xcode to discover generated source files, which output to your build products location.</p>
+</li>
+</ol>
+
 <hr>
 <p>It's handy to put <tt>WebKit/WebKitTools/Scripts</tt> in your shell path so you can type commands like <tt>build-webkit</tt> without specifying a full path.</p>
 
diff --git a/WebKitSite/building/custom-executable.png b/WebKitSite/building/custom-executable.png
new file mode 100644 (file)
index 0000000..35aebdf
Binary files /dev/null and b/WebKitSite/building/custom-executable.png differ
diff --git a/WebKitSite/building/info-tab.png b/WebKitSite/building/info-tab.png
new file mode 100644 (file)
index 0000000..d89ad1c
Binary files /dev/null and b/WebKitSite/building/info-tab.png differ