| Index: build/linux/unbundle/README
|
| diff --git a/build/linux/unbundle/README b/build/linux/unbundle/README
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..d1b2a966eff7deb8bea8bfbe0f87e111d111a6cf
|
| --- /dev/null
|
| +++ b/build/linux/unbundle/README
|
| @@ -0,0 +1,44 @@
|
| +This directory contains files that make it possible to use system libraries.
|
| +
|
| +For more info please read the following:
|
| +
|
| + - https://fedoraproject.org/wiki/Packaging:No_Bundled_Libraries
|
| + - https://wiki.gentoo.org/wiki/Why_not_bundle_dependencies
|
| + - http://www.debian.org/doc/debian-policy/ch-source.html#s-embeddedfiles
|
| +
|
| +For more Chromium-specific context please read
|
| +http://spot.livejournal.com/312320.html .
|
| +
|
| +This directory is provided in the source tree to follow above guidelines.
|
| +It is a compromise solution which takes into account Chromium developers
|
| +who want to avoid the perceived burden of more conditional code in gyp,
|
| +and expectations of Open Source community, where using system-provided
|
| +libraries is the norm.
|
| +
|
| +Usage:
|
| +
|
| +1. remove_bundled_libraries.py <preserved-directories>
|
| +
|
| + For example: remove_bundled_libraries.py third_party/mesa
|
| +
|
| + The script scans sources looking for third_party directories.
|
| + Everything that is not explicitly preserved is removed (except for
|
| + gyp files), and the script fails if any directory passed on command
|
| + line does not exist (to ensure list is kept up to date).
|
| +
|
| + This is intended to be used on sources extracted from a tarball,
|
| + not a repository.
|
| +
|
| + NOTE: by default this will not remove anything (for safety). Pass
|
| + --do-remove flag to actually remove files.
|
| +
|
| +2. replace_gyp_files.py <gyp-flags>
|
| +
|
| + For example: replace_gyp_files.py -Duse_system_harfbuzz=1
|
| +
|
| + The script ignores flags other than -D for convenience. This makes it
|
| + possible to have a variable e.g. ${myconf} with all the options, and
|
| + execute:
|
| +
|
| + build/linux/unbundle/replace_gyp_files.py ${myconf}
|
| + build/gyp_chromium ${myconf}
|
|
|