New clear and concise directions for building Tor on OSX machines.

Moved the documentation into the doc/ dir where it belongs.


svn:r6027

2 files changed, 48 insertions, 20 deletions

diff --git a/contrib/osx/package.sh b/contrib/osx/package.sh
index 5ad626f644..33eff62e53 100644
--- a/contrib/osx/package.sh
+++ b/contrib/osx/package.sh
@@ -13,26 +13,8 @@
 # set to the latest Tor version, and Tor already built.
 #
 
-######################
-# The following steps are the exact steps used to produce the "official" OSX build of tor
-#
-# Summary:
-# 1) Compile and install the latest release of libevent
-# 2) Acquire privoxyosx_setup_3.0.3.zip.  Remember where you put this file.
-# 3) Acquire and install your preferred version of tor via "make dist-osx"
-#
-# Details:
-# 1)  You need to download the latest libevent from http://www.monkey.org/~provos/libevent/
-# 1a) At a shell prompt, export CFLAGS="-march=powerpc -mtune=powerpc"
-# 1b) The first step of compiling libevent is to configure it as follows: 
-# 	configure --enable-static --disable-shared
-# 1c) Complete the "make" and "make install".  
-# 2) Get your preferred version of the tor source from tor.eff.org
-# 2a) Edit /path/to/tor/contrib/osx/package.sh (the file you are reading) and confirm PRIVOXY_PKG_ZIP= is set 
-#     to the correct path to find the file privoxyosx_setup_3.0.3.zip
-# 2b) In the top level, this means /path/to/tor/, not tor/contrib/osx, do a configure with these parameters:
-#     configure --prefix=/Library/Tor --bindir=/Library/Tor --sysconfdir=/Library
-# 2c) In same top level dir, do a "make dist-osx".  You'll have a .dmg file when complete.  Install from this dmg.
+# Read the documentation located in tor/doc/tor-osx-dmg-creation.txt on
+# how to build Tor for OSX
 
 # Where have we put the zip file containing Privoxy?  Edit this if your
 # privoxy lives somewhere else.
diff --git a/doc/tor-osx-dmg-creation.txt b/doc/tor-osx-dmg-creation.txt
new file mode 100644
index 0000000000..87eaf8afea
--- /dev/null
+++ b/doc/tor-osx-dmg-creation.txt
@@ -0,0 +1,46 @@
+The following steps are the exact steps used to produce the "official"
+OSX builds of tor
+
+Summary:
+1) Compile and install the latest release of libevent
+2) Acquire privoxyosx_setup_3.0.3.zip.  Remember where you put this
+file.
+3) Acquire and install your preferred version of tor via "make
+dist-osx"
+
+Details:
+### Compiling libevent
+
+1)  Download the latest libevent from 
+http://www.monkey.org/~provos/libevent/
+
+2) At a shell prompt, export CFLAGS="-march=powerpc -mtune=powerpc"
+
+3) The first step of compiling libevent is to configure it as
+follows:
+       ./configure --enable-static --disable-shared
+
+4) Complete the "make" and "make install".  You will need to be root,
+or sudo -s, to complete the "make install".
+
+
+### Acquiring privoxy
+
+1) Download osx privoxy source from
+http://prdownloads.sourceforge.net/ijbswa/privoxyosx_setup_3.0.3.zip?download
+
+2) Edit /path/to/tor/contrib/osx/package.sh and confirm 
+PRIVOXY_PKG_ZIP= is set to the correct path to find the 
+file privoxyosx_setup_3.0.3.zip
+
+
+## Compiling Tor
+
+1) Get your preferred version of the tor source from tor.eff.org.
+
+2) In the top level, this means /path/to/tor/, not tor/contrib/osx,
+do a configure with these parameters:
+     configure --prefix=/Library/Tor --bindir=/Library/Tor --sysconfdir=/Library
+
+3) In same top level dir, do a "make dist-osx".  There now exists a
+.dmg file in the same directory.  Install from this dmg.