MGR: Update comments on linking with Development / debug build of wxWidgets; add this info to build documentation

svn path=/trunk/boinc/; revision=15159

checkin_notes

@@ -3745,3 +3745,12 @@ Rom    May 9 2008
     lib/
         diagnostics.C
 
+Charlie May 8 2008
+    - MGR: Update comments on how to link with Development / debug build of wxWidgets; 
+        add this info to build documentation.
+        
+    clientgui/
+        mac/
+            MacGUI.pch
+    mac_build/
+        HowToBuildBOINC_XCode.rtf

clientgui/mac/MacGUI.pch

@@ -30,10 +30,11 @@
 
 // To use the Development (Debug) build of wxMac (allows stepping into wxMac 
 //   source code, enables debug, trace, Asserts, etc.):
-// (1) Set USE_DEBUG_WXMAC to 1
-// (2) Select Development build configuration
-// (3) Select mgr_boinc target
-// (4) In Xcode's View menu, set "Groups & Files Column > Target Membership" on
+// (1) Set USE_DEBUG_WXMAC to 1 in this source file
+// (2) In the Project menu, set the Active Build Configuration to "Development"
+// (3) In the Project menu, set the Active Target to "mgr_boinc"
+// (4) In Xcode's main project window, control-click on the title "Groups & Files" at the 
+//      top of the left-hand pane and select "Target Membership" from the contextual menu.
 // (5) In the XCode project's Groups and Files column:
 //      uncheck "External Frameworks and Libraries/libwx_mac_static.a"
 // (6) In the XCode project's Groups and Files column:

mac_build/HowToBuildBOINC_XCode.rtf

@@ -14,7 +14,7 @@
 \b0\fs24 \cf0 \
 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qc
 \cf0 Written by Charlie Fenton\
-Last updated 4/14/08\
+Last updated 5/8/08\
 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
 \cf0 \
 This document applies to BOINC version 6.1.0 and later.  It has instructions for building the BOINC Client and Manager for Macintosh OSX.  Information for building science project applications to run under BOINC on Macintosh OSX can be found {\field{\*\fldinst{HYPERLINK "http://boinc.berkeley.edu/trac/wiki/BuildMacApp"}}{\fldrslt here}}.  \
@@ -32,6 +32,7 @@ Contents of this document:\
 \'95 Building BOINC Manager, BOINC Client and boinc_cmd.\
 \'95 Building BOINC Manager Installer.\
 \'95 Debugging and BOINC security.\
+\'95 Debugging into wxWidgets.\
 \
 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qc
 
@@ -394,4 +395,22 @@ The
 \i0  of the BOINC Manager allows you to change the ownership and permission settings of the BOINC Data and executables by entering an administrator user name and password.  This also streamlines the development cycle by avoiding the need to run the installer for every change.\
 \
 To restore the standard ownerships and permissions, run the installer.\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
+
+\f2 \cf0 \CocoaLigature1 \
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
+
+\f0 \cf0 \
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qc
+
+\b\fs28 \cf0 Debugging into wxWidgets
+\b0\fs24 \
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
+\cf0 \
+\pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\tx10560\tx11520\tx12480\tx13440\tx14400\tx15360\tx16320\tx17280\tx18240\tx19200\tx20160\tx21120\tx22080\tx23040\tx24000\tx24960\tx25920\tx26880\tx27840\tx28800\tx29760\tx30720\tx31680\tx32640\tx33600\tx34560\tx35520\tx36480\tx37440\tx38400\tx39360\tx40320\tx41280\tx42240\tx43200\tx44160\tx45120\tx46080\tx47040\tx48000\tx48960\tx49920\tx50880\tx51840\tx52800\tx53760\tx54720\tx55680\tx56640\tx57600\tx58560\tx59520\tx60480\tx61440\tx62400\tx63360\tx64320\tx65280\tx66240\tx67200\tx68160\tx69120\tx70080\tx71040\tx72000\tx72960\tx73920\tx74880\tx75840\tx76800\tx77760\tx78720\tx79680\tx80640\tx81600\tx82560\tx83520\tx84480\tx85440\tx86400\tx87360\tx88320\tx89280\tx90240\tx91200\tx92160\tx93120\tx94080\tx95040\tx96000\ql\qnatural\pardirnatural
+\cf0 \CocoaLigature0 The BOINC XCode project normally links the BOINC Manager with the non-debugging (Deployment) build of wxWidgets, even for the Development build configuration of the Manager.  However, there may be times when you wish to link the Development build of the Manager to the Development build of wxWidgets for debugging, as when you want to step into internal wxWidgets code or put breakpoints in wxWidgets.\
+\
+You can find instructions for doing this in the comments in the file 
+\f1\fs26 boinc/clientgui/mac/MacGUI.pch
+\f0\fs24 .\
 }