third_party/freetype2/README.chromium

   1 Name: freetype2
   2 URL: git://git.sv.nongnu.org/freetype/freetype2.git
   3 Version: 2.4.8-1ubuntu2.3
   4 Security Critical: no
   5 License: BSD
   6 License File: NOT_SHIPPED
   7
   8 Description:
   9
  10 This mirrors the version of Freetype2 that was distributed with Ubuntu Precise
  11 (Version 2.4.8, git hash 9d7f0957fbd10fdbabf9815e37857a910ad4f4ac, plus
  12 applicable debian/patches-freetype as seen in
  13 https://launchpad.net/ubuntu/lucid/+source/freetype ).
  14
  15 To get the code and patches:
  16
  17 sudo apt-add-repository -s "deb http://archive.ubuntu.com/ubuntu precise-security main"
  18 sudo apt-key update
  19 sudo apt-get update
  20 apt-get source -t precise freetype=2.4.8-1ubuntu2.3
  21
  22 and then to apply the patches (quilt):
  23
  24 cd freetype-2.4.8/
  25 ./debian/rules patch
  26
  27 The tree produced by this should match the tree in this repo on the
  28 chromium/ubuntu/precise branch.
  29
  30 The build files should approximate the output of
  31
  32 make -Bn | rev | cut -d ' ' -f 1 | rev | grep "\.c$" | sort
  33
  34 Currently the cache, validators, patent checker (no longer used), and bzip2
  35 are excluded.
  36
  37 We link this library into DumpRenderTree so that we can run the layout tests
  38 on later versions of Ubuntu and still get the same font rendering so that
  39 we don't have to support two sets of pixel test baselines.
  40
  41 Freetype depends on two header files to be supplied by the user to specify
  42 how to build the library, ftconfig.h and ftmodule.h (or equivalent filenames
  43 as defined by the FT_CONFIG_CONFIG_H and FT_CONFIG_MODULES_H #defines).
  44
  45 The versions in include/ were generated as follows (on a Precise machine):
  46
  47   % cd ext
  48   % bash autogen.sh
  49   % ./configure
  50   % cp objs/ftmodule.h ../include
  51   % cp builds/unix/ftconfig.h ../include
  52   % git apply freetype2.patch
  53
  54 (Basically we use the stock list of modules, and define the FT_EXPORT
  55 and FT_EXPORT_DEF macros to work properly when building a linux shared lib.)
  56
  57 This code is not considered security critical since it is only to be linked
  58 into test binaries! This should never be linked into chrome or any production
  59 code.