Chrome Build Guide for Linux
author: Rich Joiner (joiner@cs.wisc.edu)
date: 2012-04-01 (this ain't no joke)

This document describes the download/build process for the Chrome
browser on 64-bit Ubuntu Linux 11.10. For some other information
and links to information, see chromium.build.windows.README.

### Environment setup ###

The Chrome build is not compatible with gcc-4.6, which comes installed
with this version of Ubuntu. Install gcc-4.5 and alter the symbolic
link for gcc to point to this new (older) version.

sudo apt-get install gcc-4.5
sudo rm /usr/bin/gcc
sudo ln -s /usr/bin/gcc /usr/bin/gcc-4.5

Furthermore, g++ must be the same version as gcc. Install g++-4.5
and go through the same symbolic linking process. 

sudo apt-get install g++-4.5
sudo rm /usr/bin/g++
sudo ln -s /usr/bin/g++ /usr/bin/g++-4.5

Install SVN, Git and Scons, if they aren't already.

sudo apt-get install subversion
sudo apt-get install git
sudo apt-get install scons

### Checkout ###
Get depot_tools from Google. This is sort of a meta-SVN/Git. 
Add the depot_tools directory to your PATH.

svn co http://src.chromium.org/svn/trunk/tools/depot_tools

Go to the directory in which you want to get the Chrome source.

gclient config http://src.chromium.org/svn/trunk/src

...or for a stable version...

gclient config http://src.chromium.org/svn/trunk/releases/17.0.963.56

To download all the files (this will take a while), run

gclient sync --force

To check for and install (most) dependencies, it's useful to run the
following.

./src/build/install-build-deps.sh

### Build ###

The build of Native Client fails because of the problem described in
the Dec 20, 2011 post at http://code.google.com/p/chromium/wiki/LinuxBuildInstructions. This can be worked around by using the
following build setup, run from within the src/ subdirectory.
(The -Dwerror= is thrown in to avoid failing on warnings.)

./build/gyp_chromium -Dwerror= -Ddisable_nacl=1

Finally, run make from within the src/ directory. The -j# indicates
the number of threads to use: recommended CPU cores + 1.
You can also add "V=1" for verbose output if desired.

make chrome BUILDTYPE=Debug -j5

If you're lucky, the built browser will be found at out/Debug/chrome.
To clean the build and start again, simply remove the out/ directory.