Make the getting started section in the README better

README.md

 # Breakpad
 
 Breakpad is a set of client and server components which implement a
 crash-reporting system.
 
 * [Homepage](https://chromium.googlesource.com/breakpad/breakpad/)
 * [Documentation](https://chromium.googlesource.com/breakpad/breakpad/+/master/docs/)
 * [Bugs](https://bugs.chromium.org/p/google-breakpad/)
 * Discussion/Questions: [google-breakpad-discuss@googlegroups.com](https://groups.google.com/d/forum/google-breakpad-discuss)
 * Developer/Reviews: [google-breakpad-dev@googlegroups.com](https://groups.google.com/d/forum/google-breakpad-dev)
 * Tests: [![Build Status](https://travis-ci.org/google/breakpad.svg?branch=master)](https://travis-ci.org/google/breakpad)
 
-## Getting started in 32-bit mode (from trunk)
+## Getting started (from trunk)

[vapier, 2016/06/03 14:58:35]

s/trunk/master/ ?

[Ted Mielczarek, 2016/06/03 16:40:40]

Done.

 
-```sh
-# Configure
-CXXFLAGS=-m32 CFLAGS=-m32 CPPFLAGS=-m32 ./configure
-# Build
-make
-# Test
-make check
-# Install
-make install
-```
+1.  First, [download depot_tools](http://dev.chromium.org/developers/how-tos/install-depot-tools) and ensure that they're in your `PATH`.
+2.  Create a new directory for checking out the source code (it must be named breakpad):

[vapier, 2016/06/03 14:58:35]

i'd prefer to use a period at the end of each of these bullet points rather than
a colon

[Ted Mielczarek, 2016/06/03 16:40:40]

Done.

+
+    ```sh
+    mkdir breakpad && cd breakpad
+    ```
+
+3.  Run the `fetch` tool from depot_tools to download all the source repos.
+
+    ```sh
+    fetch breakpad
+    ```
+4.  Build the source:

[vapier, 2016/06/03 14:58:35]

looks like you want a blank line above this (based on the other sections)

[Ted Mielczarek, 2016/06/03 16:40:40]

Done.

+
+    ```sh
+    ./configure && make
+    ```
+
+    You can also cd to another directory and run configure from there to build outside the source tree.
+
+    This will build the processor tools on all platforms (`src/processor/minidump_stackwalk`, `src/processor/minidump_dump`, etc), and on Linux it will also build the client libraries and some tools (`src/tools/linux/dump_syms/dump_syms`, `src/tools/linux/md2core/minidump-2-core`, etc).

[vapier, 2016/06/03 14:58:35]

line wrap to 80 cols ?

the "on all platforms" is confusing.  not sure what you're going for there.

[Ted Mielczarek, 2016/06/03 16:40:40]

Done.
I agree. I meant "the processor tools will always be built regardless of what
system you're building on", but I'll just drop "on all platforms", it reads
better that way.

+5.  Run tests:
+
+    ```sh
+    make check
+    ```
+
+6.  To install the built libraries:
+
+    ```sh
+    make install
+    ```
 
 If you need to reconfigure your build be sure to run `make distclean` first.
 
+To update an existing checkout to a newer revision, you can `git pull origin master` as usual, but then you should run `gclient sync` to ensure that the dependent repos are up-to-date.

[vapier, 2016/06/03 14:58:35]

line wrap to 80 cols ?

do you really need "origin master" ?  seems like `git pull` should be
sufficient.  or does gclient set up weird remotes ?

[Ted Mielczarek, 2016/06/03 16:40:40]

Done. The remotes are normal, just all the git docs I've ever read usually say
`git pull origin master`.

+
 ## To request change review:

[vapier, 2016/06/03 14:58:35]

drop the trailing colon.  it makes the TOC look weird.

[Ted Mielczarek, 2016/06/03 16:40:40]

Done.

 
-1.  Get a copy of depot_tools repo.
-    http://dev.chromium.org/developers/how-tos/install-depot-tools
+1.  Follow the steps above to get the source and build it.
 
-2.  Create a new directory for checking out the source code.
-    mkdir breakpad && cd breakpad
-
-3.  Run the `fetch` tool from depot_tools to download all the source repos.
-    `fetch breakpad`
-
-4.  Make changes. Build and test your changes.
+2.  Make changes. Build and test your changes.
     For core code like processor use methods above.
     For linux/mac/windows, there are test targets in each project file.
 
-5.  Commit your changes to your local repo and upload them to the server.
+3.  Commit your changes to your local repo and upload them to the server.
     http://dev.chromium.org/developers/contributing-code
     e.g. `git commit ... && git cl upload ...`
     You will be prompted for credential and a description.
 
-6.  At https://codereview.chromium.org/ you'll find your issue listed; click on
+4.  At https://codereview.chromium.org/ you'll find your issue listed; click on
     it, and select Publish+Mail, and enter in the code reviewer and CC
     google-breakpad-dev@googlegroups.com