Update README to use GN instead of GYP

README.md

 # PDFium
 
 ## News
 
-As of 2016-02-04, the XFA branch is deprecated.  Instead, see
-[the section on configuration](#BuildConfig) below.
-
 As of 2016-04-28, the Visual Studio toolchain from depot_tools is used as the
 default Windows toolchain for Googlers. Please set DEPOT_TOOLS_WIN_TOOLCHAIN=0
 if you need to use the system toolchain. See
 [Windows development subsection](#WinDev) for details.
 
 

[Tom Sepez, 2016/05/04 17:34:07]

Add a news item for GN change.  I think a 90 day lifespan for "news" is
reasonalbe, so aging out the XFA branch blurb is fine.  And
maybe reverse chrono order, so that the GN change blurb goes first.

[dsinclair, 2016/05/04 17:38:50]

Done. Also added a bit for when GYP will go away.

 ## Prerequisites
 
 Get the chromium depot tools via the instructions at
 http://www.chromium.org/developers/how-tos/install-depot-tools (this provides
 the gclient utilty needed below).
 
 Also install Python, Subversion, and Git and make sure they're in your path.
 
+
 ###<a name="WinDev"></a> Windows development
 
 PDFium uses a similar Windows toolchain as Chromium:
 
 #### Open source contributors
 Visual Studio 2015 Update 2 or later is highly recommended.
 
 Run `set DEPOT_TOOLS_WIN_TOOLCHAIN=0`, or set that variable in your global
 environment.
 
 Compilation is done through ninja, **not** Visual Studio.
 
+
 #### Google employees
 
 Run: `download_from_google_storage --config` and follow the
 authentication instructions. **Note that you must authenticate with your
 @google.com credentials**. Enter "0" if asked for a project-id.
 
 Once you've done this, the toolchain will be installed automatically for
 you in [the step](#GenBuild) below.
 
 The toolchain will be in `depot_tools\win_toolchain\vs_files\<hash>`, and windbg
@@ skipping 12 matching lines @@
 ```
 mkdir repo
 cd repo
 gclient config --unmanaged https://pdfium.googlesource.com/pdfium.git
 gclient sync
 cd pdfium
 ```
 
 ##<a name="GenBuild"></a> Generate the build files
 
-We use the GYP library to generate the build files.
+We use GN to generate the build files and
+[Ninja](http://martine.github.io/ninja/) (also included with the depot\_tools
+checkout) to execute the build files.
 
-At this point, you have two options. The first option is to use the [Ninja]
-(http://martine.github.io/ninja/) build system (also included with the
-depot\_tools checkout). This is the default as of mid-September, 2015.
-Previously, the second option (platform-specific build files) was the default.
-Most PDFium developers use Ninja, as does our [continuous build system]
-(http://build.chromium.org/p/client.pdfium/).
-
- * On Windows: `build_gyp\gyp_pdfium`
- * For all other platforms: `build_gyp/gyp_pdfium`
-
-The second option is to generate platform-specific build files, i.e. Makefiles
-on Linux, sln files on Windows, and xcodeproj files on Mac. To do so, set the
-GYP\_GENERATORS environment variable appropriately (e.g. "make", "msvs", or
-"xcode") before running the above command.
+```
+gn gen out/Debug
+```
 
 ###<a name="BuildConfig"></a> Selecting build configuration
 
 PDFium may be built either with or without JavaScript support, and with
 or without XFA forms support.  Both of these features are enabled by
 default. Also note that the XFA feature requires JavaScript.
 
-To build without XFA, set `pdf_enable_xfa=0` before running `gyp_pdfium`.
-To build without JavaScript, set `pdf_enable_v8=0 pdf_enable_xfa=0` before
-running `gyp_pdfium`. For example
-```
-GYP_DEFINES='pdf_enable_v8=0 pdf_enable_xfa=0' build_gyp/gyp_pdfium
-```
-gives the smallest possible build configuration.
-
-### Using goma (Googlers only)
-
-If you would like to build using goma, pass `use_goma=1` to `gyp_pdfium`. If
-you installed goma in a non-standard location, you will also need to set
-`gomadir`. e.g.
+The build settings are configured by setting the GN arguments.
 
 ```
-build_gyp/gyp_pdfium -D use_goma=1 -D gomadir=path/to/goma
+gn args out/Debug
+```
+
+Below are the available options which can be enabled.
+
+```
+use_goma = true  # Googlers only.
+is_debug = true  # Enable debugging features.
+
+pdf_use_skia = false  # Set true to enable experimental skia backend.
+
+pdf_enable_xfa = true # Set false to remove XFA support (implies JS support).
+pdf_enable_v8 = true  # Set false to remove Javascript support.
+pdf_is_standalone = true  # Set for a non-embedded build.
+
+clang_use_chrome_plugins = false  # Currently must be false
 ```
 

[Tom Sepez, 2016/05/04 17:34:07]

Add section about how to set an arg with an example.  It would be great if we
didn't have to go to the GN docs.

[dsinclair, 2016/05/04 17:38:50]

Better? The above is how you set the args, wrote some better words around it to
hopefully clarify.

 ## Building the code
 
 If you used Ninja, you can build the sample program by: `ninja -C out/Debug
 pdfium_test` You can build the entire product (which includes a few unit
 tests) by: `ninja -C out/Debug`.
 
-If you're not using Ninja, then building is platform-specific.
-
- * On Linux: `make pdfium_test`
- * On Mac: `open build_gyp/all.xcodeproj`
- * On Windows: open build_gyp\all.sln
 
 ## Running the sample program
 
 The pdfium\_test program supports reading, parsing, and rasterizing the pages of
 a .pdf file to .ppm or .png output image files (windows supports two other
 formats). For example: `out/Debug/pdfium_test --ppm path/to/myfile.pdf`. Note
 that this will write output images to `path/to/myfile.pdf.<n>.ppm`.
 
 ## Testing
 
@@ skipping 20 matching lines @@
 There are several mailing lists that are setup:
 
  * [PDFium](https://groups.google.com/forum/#!forum/pdfium)
  * [PDFium Reviews](https://groups.google.com/forum/#!forum/pdfium-reviews)
  * [PDFium Bugs](https://groups.google.com/forum/#!forum/pdfium-bugs)
 
 Note, the Reviews and Bugs lists are typically read-only.
 
 ## Bugs
 
- We will be using this
+ We use this
 [bug tracker](https://code.google.com/p/pdfium/issues/list), but for security
 bugs, please use [Chromium's security bug template]
 (https://code.google.com/p/chromium/issues/entry?template=Security%20Bug)
 and add the "Cr-Internals-Plugins-PDF" label.
 
 ## Contributing code
 
 For contributing code, we will follow
 [Chromium's process](http://dev.chromium.org/developers/contributing-code)
 as much as possible. The main exceptions is:
 
 1. Code has to conform to the existing style and not Chromium/Google style.
 
-## Branches
-
-Prior to 2016-02-04, there existed an actively developed origin/xfa branch.
-The origin/xfa branch is now an evolutionary dead-end. Everything you need
-to build either with or without the XFA feature is on origin/master.
-