tor/contrib/polipo/README
Nick Mathewson b006e3279f Merge remote branch 'origin/maint-0.2.1'
Conflicts:
	src/common/test.h
	src/or/test.c
2010-02-27 17:16:31 -05:00

59 lines
2.1 KiB
Plaintext

Copyright 2007-2008 Andrew Lewman
Copyright 2009-2010 The Tor Project
----------------
General Comments
----------------
These are some hacks for making polipo work and install a package native
to OSX or Windows.
They need some work before they can be committed upstream:
- Merge the three makefiles into one with specific builds such as "make
dist-osx" or "make dist-win32"
- Configure the options for tor in polipo config, just leave them
commented out for easy activation.
- Work out better polipo config options for Tor.
As always, I'm happy to accept patches.
--------------------------
Pre-requisites for Windows
--------------------------
Polipo for Win32 requires the mingw gnu regex library and dlls at
http://sourceforge.net/project/showfiles.php?group_id=2435&package_id=73286&release_id=140957
You'll need to download the -bin and -dev tarballs. And extract them
into your MinGW directory.
Instructions for building polipo under mingw32 for Windows:
1) Copy Makefile.mingw over Makefile.
2) Run 'make'.
You should have a polipo.exe in the current directory.
-------------------------------------------
Creating an installation package in Windows
-------------------------------------------
If you want to build an installer using the Nullsoft Installer, install
the NSI Compiler. In Windows Explorer, navigate to the directory in
which you placed polipo-mingw.nsi. Right click on polipo-mingw.nsi and
choose Compile NSIS Script. You'll then create a polipo installer.
The Polipo NSI installer assumes libgnurx-0.dll is in the same directory as polipo.exe.
You'll need to copy libgnurx-0.dll into "./" in order to make the
installation package.
---------------------------------------------
OSX Universal Binary and Installation package
---------------------------------------------
You'll need the contrib/polipo directory from Tor's source distribution.
1) Copy Makefile.osx over Makefile.
2) Run 'make'.
3) Copy the contents of contrib/polipo into a directory named "contrib".
4) Run 'chmod +x ./contrib/package.sh'
5) Run './contrib/package.sh'
6) You should have a Polipo-version.dmg ready for installation.