Home | History | Annotate | Download | only in unbundle
      1 This directory contains files that make it possible to use system libraries.
      2 
      3 For more info please read the following:
      4 
      5  - https://fedoraproject.org/wiki/Packaging:No_Bundled_Libraries
      6  - https://wiki.gentoo.org/wiki/Why_not_bundle_dependencies
      7  - http://www.debian.org/doc/debian-policy/ch-source.html#s-embeddedfiles
      8 
      9 For more Chromium-specific context please read
     10 http://spot.livejournal.com/312320.html .
     11 
     12 This directory is provided in the source tree to follow above guidelines.
     13 It is a compromise solution which takes into account Chromium developers
     14 who want to avoid the perceived burden of more conditional code in gyp,
     15 and expectations of Open Source community, where using system-provided
     16 libraries is the norm.
     17 
     18 Usage:
     19 
     20 1. remove_bundled_libraries.py <preserved-directories>
     21 
     22    For example: remove_bundled_libraries.py third_party/mesa
     23 
     24    The script scans sources looking for third_party directories.
     25    Everything that is not explicitly preserved is removed (except for
     26    gyp files), and the script fails if any directory passed on command
     27    line does not exist (to ensure list is kept up to date).
     28 
     29    This is intended to be used on sources extracted from a tarball,
     30    not a repository.
     31 
     32    NOTE: by default this will not remove anything (for safety). Pass
     33    --do-remove flag to actually remove files.
     34 
     35 2. replace_gyp_files.py <gyp-flags>
     36 
     37    For example: replace_gyp_files.py -Duse_system_harfbuzz=1
     38 
     39    The script ignores flags other than -D for convenience. This makes it
     40    possible to have a variable e.g. ${myconf} with all the options, and
     41    execute:
     42 
     43    build/linux/unbundle/replace_gyp_files.py ${myconf}
     44    build/gyp_chromium ${myconf}
     45