readme: update

Author: illwieckz

README.md

@@ -1,35 +1,46 @@
-# Breakpad for Cygwin/MinGW
+# Breakpad for MinGW and more
 
-[![Build status](https://ci.appveyor.com/api/projects/status/xp2os1r0m569a470/branch/pecoff-dwarf-on-git-20160304?svg=true)](https://ci.appveyor.com/project/jon-turney/google-breakpad)
+Google Breakpad with added support for Gygwin/MinGW, maintained for the
+[Dæmon game engine](https://github.com/DaemonEngine/Daemon) and the
+[Unvanquished game](https://unvanquished.net).
+
+- Upstream for the Dæmon branch: https://github.com/DaemonEngine/breakpad
+- Bug tracker for the Dæmon branch: https://github.com/DaemonEngine/breakpad/issues
+
+## Dæmon Breakpad
+
+The Dæmon Breakpad adds MinGW support to Google Breakpad, based on jon.turney's patches,
+with merged Google upstream adding support for DWARF5 debugging information format. This
+retains the support for systems already supported by Google Breakpad upstream.
+
+This provides:
 
-google-breakpad with added support for Cygwin/MinGW:
 - A `dump_syms` tool which can read DWARF debugging information from PE/COFF executables.
 - The breakpad crash-reporting client libraries built using Makefiles rather than MSVC solutions.
 
 ## Compiling
 
 ### Preparation
 
-Run the fetch-externals script to fetch submodules in the DEPS file (e.g the gyp and gtest dependencies).
-(The upsteam repository is meant to be checked out using Chromium's `depot_tools`, which does this for you)
+Optional: Run the fetch-externals script to fetch submodules in the DEPS file (e.g the gyp and gtest dependencies).
+(The Google upsteam repository is meant to be checked out using Chromium's `depot_tools`, which does this for you).
+This is not needed to build Breakpad.
 
-```
+```sh
 ./fetch-externals
 ```
 
 Run autoreconf to generate ./configure
 
-````
+```sh
 autoreconf -fvi
-````
+```
 
 ### Compiling
 
-See README.orig.md
-
-````
+```sh
 ./configure && make
-````
+```
 
 will produce `dump_syms.exe`, `minidump_dump.exe`, `minidump_stackwalk.exe`, `libbreakpad.a`,
 and for MinGW `libcrash_generation_client.a`, `libcrash_generation_server.a`, `crash_generation_app.exe`
@@ -40,14 +51,14 @@ See [Getting started with breakpad](https://chromium.googlesource.com/breakpad/b
 
 ### Producing and installing symbols
 
-````
+```sh
 dump_syms crash_generation_app.exe >crash_generation_app.sym
 FILE=`head -1 crash_generation_app.sym | cut -f5 -d' '`
 BUILDID=`head -1 crash_generation_app.sym | cut -f4 -d' '`
 SYMBOLPATH=/symbols/${FILE}/${BUILDID}/
 mkdir -p ${SYMBOLPATH}
 mv crash_generation_app.sym ${SYMBOLPATH}
-````
+```
 
 ### Generating a minidump file
 
@@ -60,9 +71,9 @@ A small test application demonstrating out-of-process dumping called
 
 ### Processing the minidump to produce a stack trace
 
-````
+```sh
 minidump_stackwalk blah.dmp /symbols/
-````
+```
 
 ## Issues
 
@@ -94,85 +105,13 @@ editions of Visual Studio 2013), and (ii) the DIA SDK uses ATL.
 An alternate PDB parser is available at https://github.com/luser/dump_syms, but
 that also needs some work before it can be built with MinGW.
 
-# Breakpad
+# Upstream 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/)
+* 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) [![Build status](https://ci.appveyor.com/api/projects/status/eguv4emv2rhq68u2?svg=true)](https://ci.appveyor.com/project/vapier/breakpad)
-* Coverage [![Coverity Status](https://scan.coverity.com/projects/9215/badge.svg)](https://scan.coverity.com/projects/google-breakpad)
-
-## Getting started (from master)
-
-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).
-
-    ```sh
-    mkdir breakpad && cd breakpad
-    ```
-
-3.  Run the `fetch` tool from depot_tools to download all the source repos.
-
-    ```sh
-    fetch breakpad
-    cd src
-    ```
-
-4.  Build the source.
-
-    ```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 (`src/processor/minidump_stackwalk`,
-    `src/processor/minidump_dump`, etc), and when building 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).
-
-5.  Optionally, run tests.
-
-    ```sh
-    make check
-    ```
-
-6.  Optionally, 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` as usual, but then you should run `gclient sync` to ensure that the
-dependent repos are up-to-date.
-
-## To request change review
-
-1.  Follow the steps above to get the source and build it.
-
-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.
-
-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.
-
-4.  At https://chromium-review.googlesource.com/ you'll find your issue listed;
-    click on it, then “Add reviewer”, and enter in the code reviewer. Depending
-    on your settings, you may not see an email, but the reviewer has been
-    notified with google-breakpad-dev@googlegroups.com always CC’d.