| Index: third_party/libaddressinput/chromium/cpp/README
|
| diff --git a/third_party/libaddressinput/chromium/cpp/README b/third_party/libaddressinput/chromium/cpp/README
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..4f276356d206e89a2a9c26094dd2254c29d0aa33
|
| --- /dev/null
|
| +++ b/third_party/libaddressinput/chromium/cpp/README
|
| @@ -0,0 +1,74 @@
|
| +Intro
|
| +=====
|
| +
|
| +The C++ version of libaddressinput library provides UI layout information and
|
| +validation for address input forms.
|
| +
|
| +The library does not provide a UI. The user of the library must provide the user
|
| +interface that uses libaddressinput. The user of the library must also provide a
|
| +way to store data on disk and download data from the internet.
|
| +
|
| +The first client of the library is Chrome web browser. This motivates not
|
| +providing UI or networking capabilities. Chrome will provide those.
|
| +
|
| +When including the library in your project, you can override the dependencies
|
| +and include directories in libaddressinput.gypi to link with your own
|
| +third-party libraries.
|
| +
|
| +Dependencies
|
| +============
|
| +
|
| +The library depends on these tools and libraries:
|
| +
|
| +GYP: Generates the build files.
|
| +Ninja: Executes the build files.
|
| +GTest: Used for unit tests.
|
| +Python: Used by GRIT, which generates localization files.
|
| +
|
| +Most of these packages are available on Debian-like distributions. You can
|
| +install them with this command:
|
| +
|
| +$ sudo apt-get install gyp ninja-build libgtest-dev python
|
| +
|
| +Make sure that your version of GYP is at least 0.1~svn1395. Older versions of
|
| +GYP do not generate the Ninja build files correctly. You can download a
|
| +new-enough version from http://packages.ubuntu.com/saucy/gyp.
|
| +
|
| +If your distribution does not include the binary packages for the dependencies,
|
| +you can download them from these locations:
|
| +
|
| +http://packages.ubuntu.com/saucy/gyp
|
| +http://packages.ubuntu.com/saucy/ninja-build
|
| +http://packages.ubuntu.com/saucy/libgtest-dev
|
| +http://packages.ubuntu.com/saucy/python
|
| +
|
| +Alternatively, you can download, build, and install these tools and libraries
|
| +from source code. Their home pages contain information on how to accomplish
|
| +that.
|
| +
|
| +https://code.google.com/p/gyp/
|
| +http://martine.github.io/ninja/
|
| +https://code.google.com/p/googletest/
|
| +http://python.org/
|
| +
|
| +Build
|
| +=====
|
| +
|
| +Building the library involves generating an out/Default/build.ninja file and
|
| +running ninja:
|
| +
|
| +$ export GYP_GENERATORS='ninja'
|
| +$ gyp --depth .
|
| +$ ninja -C out/Default
|
| +
|
| +Overriding paths defined in the *.gyp files can be done by setting the
|
| +GYP_DEFINES environment variable before running gyp:
|
| +
|
| +$ export GYP_DEFINES="gtest_dir='/xxx/include' gtest_src_dir='/xxx'"
|
| +
|
| +Test
|
| +====
|
| +
|
| +This command will execute the unit tests for the library:
|
| +
|
| +$ out/Default/unit_tests
|
|
|