tor/contrib/polipo
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
..
addsysuser
Makefile.mingw
Makefile.osx update the README instructions and OS X makefiles 2009-08-30 20:40:02 -04:00
Makefile.osx-panther
package.sh Update polipo build instructions for OS X 10.6 2010-02-23 17:15:47 +01:00
Polipo
polipo-mingw.nsi Update directions, copyrights, and clarify licenses of polipo 2008-02-13 15:08:45 +00:00
PolipoDesc.plist
PolipoInfo.plist
PolipoPostflight Force the target path, since the user can't install it anywhere else 2008-10-01 01:55:07 +00:00
README Merge remote branch 'origin/maint-0.2.1' 2010-02-27 17:16:31 -05:00
StartupParameters.plist
uninstall_polipo_bundle.sh Update directions, copyrights, and clarify licenses of polipo 2008-02-13 15:08:45 +00:00

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.