[or-cvs] r12764: Add Firefox build instructions; update TODO and README (in torpedo/trunk: . docs)

[sjm217@xxxxxxxx]

Author: sjm217
Date: 2007-12-11 16:36:50 -0500 (Tue, 11 Dec 2007)
New Revision: 12764

Added:
   torpedo/trunk/docs/dot_mozconfig
Modified:
   torpedo/trunk/README
   torpedo/trunk/docs/TODO
   torpedo/trunk/docs/build-instructions.txt
Log:
Add Firefox build instructions; update TODO and README

Modified: torpedo/trunk/README
===================================================================
--- torpedo/trunk/README	2007-12-11 20:58:57 UTC (rev 12763)
+++ torpedo/trunk/README	2007-12-11 21:36:50 UTC (rev 12764)
@@ -33,6 +33,14 @@
 
 Further issues are discussed in docs/TODO.
 
+Included applications
+---------------------
+
+Vidalia (customized svn trunk, based on revision 2205)
+Tor 0.1.2.18
+FirefoxPortable 2.0.0.11
+ \_ Firefox 2.0.0.11
+
 Usage
 -----
 

Modified: torpedo/trunk/docs/TODO
===================================================================
--- torpedo/trunk/docs/TODO	2007-12-11 20:58:57 UTC (rev 12763)
+++ torpedo/trunk/docs/TODO	2007-12-11 21:36:50 UTC (rev 12764)
@@ -64,6 +64,8 @@
   We need to be clear in the documentation about the difference between
   the installer and the actual bundle
 
+- Add version numbers to builds
+
 Questions to ask
 ----------------
 
@@ -76,3 +78,6 @@
 - Should we cache directory information on the USB device/hard disk
 
 - How much of a worry is wearing out the flash
+
+- What to do when user clicks "Stop Tor" or exits Vidalia: Don't let them do it?
+  Kill Firefox? Show a helpful message?

Modified: torpedo/trunk/docs/build-instructions.txt
===================================================================
--- torpedo/trunk/docs/build-instructions.txt	2007-12-11 20:58:57 UTC (rev 12763)
+++ torpedo/trunk/docs/build-instructions.txt	2007-12-11 21:36:50 UTC (rev 12764)
@@ -33,3 +33,46 @@
 The .ini file needs to have "WaitForFirefox=true" set, since otherwise
 the launcher will exit immediately after starting Firefox. Currently
 we rely on detecting Firefox closing for when to shut down Tor.
+
+Building Firefox
+----------------
+
+I am currently using MSVC 7.1 (Visual Studio .NET 2003) to build Firefox. Visual
+Studio 2005 (and 2008) cannot build Firefox 2. This should be fixed with the
+eventual release of Firefox 3. MinGW32 is reported to work, but is not supported
+and has limitations. I was not able to get cross compiling working. There is
+discussion of building Firefox 2 with MSVC 8 at:
+ http://georgedexter.wordpress.com/2007/03/03/building-firefox-2002-on-windows/
+
+For more information see:
+ http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites
+ http://developer.mozilla.org/en/docs/Build_and_Install
+
+Instructions:
+
+- Install MSVC 7 (Visual Studio .NET 2003) and upgrade using Microsoft Update
+
+- Download Platform SDK from
+  http://www.microsoft.com/downloads/details.aspx?familyid=0baf2b35-c656-4969-ace8-e4c0c0716adb
+
+- Install MozillaBuild from
+  http://ftp.mozilla.org/pub/mozilla.org/mozilla/libraries/win32/MozillaBuildSetup-1.1.exe
+
+- Run e:\mozilla-build\start-msvc8.bat
+
+$ cd "e:\mozilla\build"
+$ tar -xjvf ../firefox-2.0.0.9-source.tar.bz2
+$ cd mozilla
+  [ dot_mozconfg is in docs/ ]
+$ cp ../dot_mozconfig .mozconfig
+$ make -f client.mk build
+
+- Copy msvcp71.dll and msvcr71.dll from "Microsot Visual Studio .NET 2003\Visual
+  Studio .NET Professional 2003 - English" to obj-i686-pc-mingw32\dist\bin
+
+- Add "msvcp71.dll" and "msvcr71.dll" to browser/installer/windows/packages-static
+
+$ make -C obj-i686-pc-mingw32/browser/installer
+
+
+

Added: torpedo/trunk/docs/dot_mozconfig
===================================================================
--- torpedo/trunk/docs/dot_mozconfig	                        (rev 0)
+++ torpedo/trunk/docs/dot_mozconfig	2007-12-11 21:36:50 UTC (rev 12764)
@@ -0,0 +1,11 @@
+. $topsrcdir/browser/config/mozconfig
+
+mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/obj-@CONFIG_GUESS@
+mk_add_options MOZ_APP_DISPLAYNAME=TorBrowser
+
+ac_add_options --enable-static 
+ac_add_options --disable-shared
+ac_add_options --disable-libxul
+ac_add_options --enable-optimize
+ac_add_options --disable-tests
+ac_add_options --disable-debug


Property changes on: torpedo/trunk/docs/dot_mozconfig
___________________________________________________________________
Name: svn:executable
   + *