aboutsummaryrefslogtreecommitdiff
path: root/contrib/polipo/README
blob: 6670d579ec311258828dd540d5958dd8ecf15856 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
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.