[vidalia-svn] r3831: Add a README.breakpad with instructions on building Vidalia (vidalia/branches/breakpad)

[edmanm@xxxxxxxxxxxxxxxxxxx]

Author: edmanm
Date: 2009-06-09 20:26:14 -0400 (Tue, 09 Jun 2009)
New Revision: 3831

Added:
   vidalia/branches/breakpad/README.breakpad
Log:

Add a README.breakpad with instructions on building Vidalia with Breakpad
support now that the process is getting a little tricky.


Added: vidalia/branches/breakpad/README.breakpad
===================================================================
--- vidalia/branches/breakpad/README.breakpad	                        (rev 0)
+++ vidalia/branches/breakpad/README.breakpad	2009-06-10 00:26:14 UTC (rev 3831)
@@ -0,0 +1,70 @@
+
+       Building Vidalia with Breakpad-based Crash Reporting Support
+
+
+Windows
+--------
+Pre-requisites:
+  * Subversion
+  * CMake 2.4 or later (CMake >= 2.6 preferred)
+  * Microsoft Visual C++ Professional 2005 or later (VC++ >= 2008 preferred)
+     NOTE: Google Breakpad requires Microsoft's ATL, so users of Visual Studio
+           "Express" editions may need to install that separately (if even
+           supported).
+
+1. Download and build Qt with Visual Studio support
+  1.1. Download the latest Qt source code for Windows from Qt's website:
+
+       http://get.qtsoftware.com/qt/source/
+
+  1.2. Extract the .zip file to a directory
+  1.3. Open a Visual Studio command prompt
+  1.4. 'cd' to the location of your extract Qt source
+  1.5. Configure the Qt source for a Visual Studio build, along with whatever
+       other options you want (e.g., OpenSSL support). As an example, I used
+       the following command to configure my Qt:
+  
+       $ configure.exe -platform win32-msvc2008 \
+                       -opensource -debug-and-release       \
+                       -fast -no-qt3support -no-scripttools \
+                       -nomake demos -nomake examples       \
+                       -openssl -I E:\OpenSSL\9.8k\include  \
+                       -L E:\OpenSSL\9.8k\lib\VC 
+
+  1.6. After configure.exe is finished running, simply run nmake.exe to build
+       Qt. The entire process may take several hours depending on the options
+       used and the speed of your machine.
+
+2. Download and build the latest Breakpad source from Subversion
+  2.1. Fetch the latest Google Breakpad source code from Subversion
+    
+       $ svn cp http://google-breakpad.googlecode.com/svn/trunk/ breakpad
+
+  2.2. Open breakpad\src\client\windows\breakpad_client.sln
+  2.3. Right-click on the "crash_generation" project and select 'Properties'
+  2.4. Go to "Configuration Properties" -> "C/C++" -> "Language" and disable
+       "Treat wchar_t as Built-in Type".
+  2.5. Repeat 2.2 and 2.3 for the "crash_report_sender" and "exception_handler"
+       projects as well.
+  2.6. Right-click on the top-level solution and select "Build Solution" or
+       hit F7 to build the entire solution.
+
+3. Build Vidalia with Breakpad support enabled 
+  3.1. Fetch the latest 'breakpad' branch from Vidalia's Subversion repository.
+
+       $ svn co https://svn.vidalia-project.net/svn/vidalia/branches/breakpad vidalia-breakpad
+  
+  3.2. Use CMake to generate a Visual Studio .sln file for Vidalia with
+       Breakpad support enabled.
+       
+       $ mkdir build-vs
+       $ cd build-vs
+       $ cmake.exe -DUSE_BREAKPAD=1 \
+                   -DBREAKPAD_INCLUDE_DIR=E:\breakpad\src  \
+                   -DBREAKPAD_LIBRARY_DIR=E:\Breakpad\src\client\windows\Debug ..
+       
+       You will need to adjust the paths above to point to the location of
+       the Breakpad source directory and binaries you built in Step 2.
+  3.3. Open the solution file build-vs\Vidalia.sln with Visual Studio.
+  3.4. Right-click on the top-level solution and select "Build Solution", or
+       hit F7 to build the entire solution.


Property changes on: vidalia/branches/breakpad/README.breakpad
___________________________________________________________________
Added: svn:eol-style
   + native