| Index: README.md
|
| diff --git a/README.md b/README.md
|
| index 39f53e2c1f865e62a77d1e1a1d9bb680a1761a6b..ec6e19f57fd46af80c830b459080f38bdf4ae7a3 100644
|
| --- a/README.md
|
| +++ b/README.md
|
| @@ -1,5 +1,10 @@
|
| # PDFium
|
|
|
| +## News
|
| +
|
| +As of 2016-02-04, the XFA branch is deprecated. Instead, see the section on
|
| +configuration below.
|
| +
|
| ## Prerequisites
|
|
|
| Get the chromium depot tools via the instructions at
|
| @@ -41,6 +46,20 @@ 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.
|
|
|
| +### 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_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
|
| @@ -117,28 +136,10 @@ as much as possible. The main exceptions are:
|
| 1. Code has to conform to the existing style and not Chromium/Google style.
|
| 2. There is no commit queue, approved committers can land their changes via
|
| `git cl land`
|
| -3. Changes must be merged to the XFA branch as well (see below).
|
|
|
| ## Branches
|
|
|
| -There is a branch for a forthcoming feature called XFA that you can get by
|
| -following the steps above, then:
|
| -
|
| -```
|
| -git checkout origin/xfa
|
| -build/gyp_pdfium
|
| -ninja -C out/Debug
|
| -```
|
| -
|
| -Merging to XFA requires:
|
| -
|
| -```
|
| -git checkout origin/xfa
|
| -git checkout -b merge_branch
|
| -git branch --set-upstream-to=origin/xfa
|
| -git cherry-pick -x <commit hash>
|
| -git commit --amend # add Merge to XFA
|
| -git cl upload
|
| -```
|
| +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.
|
|
|
| -Then wait for approval, and `git cl land`
|
|
|