Added quick instructions for those wishing to replicate the official

build process for linux rpm and osx dmg


svn:r5980

1 files changed, 49 insertions, 0 deletions

diff --git a/tor.spec.in b/tor.spec.in
index 7fb2856cf..7b4983d79 100644
--- a/tor.spec.in
+++ b/tor.spec.in
@@ -1,6 +1,55 @@
 ## NOTE: tor.spec is autogenerated from tor.spec.in . Edit the latter,
 ## not the former.
 
+## Instructions for building various rpms on various architectures
+#
+# This will build various architecture and cpu tuned versions of tor all
+# bundled in a convenient rpm.  Each rpm will require glibc on the target
+# system (which any rpm based linux distro should have already installed
+# by default).  These are the exact same steps used to build the
+# official rpms of tor
+#
+# If you wish to further tune tor rpms beyond this list, see the GCC doc
+# page for further options:
+# http://gcc.gnu.org/onlinedocs/gcc-4.0.2/gcc/i386-and-x86_002d64-Options.html#i386-and-x86_002d64-Options
+#
+# i386 with zero tuning (most compatible, in theory will run an a true i386 cpu):
+# 1) download tor source tarball
+# 2) at shell prompt, export CFLAGS="-march=i386 -mtune=i386"
+# 3) in the extracted tor source dir, configure as follows:
+#   ./configure --build=i386-pc-linux-gnu --host=i386-pc-linux-gnu --target=i386-pc-linux-gnu
+# 4) Edit tor.spec.in, change the following to line:
+#   %configure --with-tor-user=%{toruser} --with-tor-group=%{torgroup}
+#   add to it:
+#   --build=i386-pc-linux-gnu --host=i386-pc-linux-gnu --target=i386-pc-linux-gnu
+# 5) make dist-rpm
+# 6) Install from the .i386.rpm file.
+#
+# i686 with i686 tuning (best for pentium pro, pentium2, pentium3, and
+# pentium4-class CPUS including the pentium4):
+# 1) download tor source tarball
+# 2) at shell prompt, export CFLAGS="-march=i686 -mtune=i686"
+# 3) in the extracted tor source dir, configure as follows:
+#   ./configure --build=i686-pc-linux-gnu --host=i686-pc-linux-gnu --target=i686-pc-linux-gnu
+# 4) Edit tor.spec.in, change the following to line:
+#   %configure --with-tor-user=%{toruser} --with-tor-group=%{torgroup}
+#   add to it:
+#   --build=i686-pc-linux-gnu --host=i686-pc-linux-gnu --target=i686-pc-linux-gnu
+# 5) make dist-rpm
+# 6) Install from the .i686.rpm file.
+#
+# athlon64 with athlon64 tuning (best for Athlon64 and Opteron):
+# 1) download tor source tarball
+# 2) at shell prompt, export CFLAGS="-march=athlon64 -mtune=athlon64"
+# 3) in the extracted tor source dir, configure as follows:
+#   ./configure --build=athlon64-pc-linux-gnu --host=athlon64-pc-linux-gnu --target=athlon64-pc-linux-gnu
+# 4) Edit tor.spec.in, change the following to line:
+#   %configure --with-tor-user=%{toruser} --with-tor-group=%{torgroup}
+#   add to it:
+#   --build=athlon64-pc-linux-gnu --host=athlon64-pc-linux-gnu --target=athlon64-pc-linux-gnu
+# 5) make dist-rpm
+# 6) Install from the .athlon64.rpm file.
+
 ## Things that need to be edited frequently
 #
 # This should be incremented whenever the spec file changes, but