How to build Flock

How do I build flock from source?

Well first you need to be familiar with building software, but you probably are if you are looking at this page.

First you need the mozilla build requirements. If you cannot build mozilla, you cannot build
Flock.

Additional restrictions: on Windows we have only testing with Microsoft Visual Studio .NET 2003. I have been told that didn’t work for someone who tried with a different compiler.

Quick buiild

Quick way: If you have everything setup to be able to build mozilla.
Download flock-source-0.4.9-complete.tar
http://downloads.flock.com/?product=flock-source-0.4.9-complete
*NOTE on Windows you will need to set the followin environment variables

$ CC=cl ; CXX=cl ; export CC CXX

Everyone needs the following steps

$ tar xvf flock-source-0.4.9-complete.tar $ cd flock-source-0.4.9-complete $ sh ./flock-build.sh 

This will probably take over an hour (possibly several hours) depending on how fast your computer is.

Building by hand

This assumes you are a pretty advanced developer and familiar with UN*X tools. First make sure you have all of the requirements listed below. Download all of the source code files and the Patch into the same directory, from now on I will refer to this directory as src_dir

• Windows needs to use cl to compile clucene
  CC=cl; CXX=cl; export CC CXX
• FreeBSD needs a patch for cairo
  I am hoping the need for this will go away as this goes into mainstream Firefox

1. Mozilla development requirements:
   http://developer.mozilla.org/en/docs/Build_Documentation
   
2. Mozilla Firefox Beta 2 source code:
   http://ftp.mozilla.org/pub/mozilla.org/firefox/releases/1.5b2/source/firefox-1.5b2-source.tar.bz2
3. Flock MPL source code:
   http://downloads.flock.com/?product=flock-source-0.4.8-mpl
   
4. Flock GPL source code:
   http://downloads.flock.com/?product=flock-source-0.4.8-gpl
   
5. Clucene 0.8.13 source code:
   http://sourceforge.net/projects/clucene
6. Flock Clucene Patch:
   http://www.flock.com/developer/download/source/clucene-0.8.13.patch.0

Now to build

1. Get the Mozilla build requirements for your platform!
2. unpack Firefox Beta 2 source code (this must be done first as flock over-writes some files from this)
   tar xjf firefox-1.5b2-source.tar.bz2
3. Make a directory called “local” at the same level as the mozilla directory
   mkdir local
4. unpack Flock MPL source code
   tar xzf flock-0.4.8-strict_mpl.tar.gz
5. unpack Flock GPL source code
   tar xzf flock-0.4.8-gpl.tar.gz
6. unpack Clucene source code
   tar xzf clucene-0.8.13-src.tar.gz
7. apply the Flock Clucene Patch to the clucene code
   patch -p0
8. change into the clucene directory
   cd clucene-0.8.13
9. configure Clucene with the prefix of the local directory
   ./configure –prefix=src_dir/local
10. build clucene and install it
    make && make install
11. change to the mozilla directory
    cd src_dir; cd mozilla
12. configure mozilla
    ./configure
13. make
    make
14. when this succeeds (75 minutes on laptop)

1. Linux: files executable is ./dist/bin/flock
   cd ./dist/bin; ./flock
2. Windows: executable is ./dist/bin/flock.exe
   cd ./dist/bin; ./flock.exe
3. MacOS: executable is ./dist/Flock.app
   cd ./dist; open Flock.app

That should be it. The first thing to try if you run into problems is to make sure you can build firefox
with the instructions from: http://developer.mozilla.org/en/docs/Build_Documentation