third_party/tcmalloc/README.chromium

   1 Name: tcmalloc
   2 Short Name: google-perftools
   3 URL: http://google-perftools.googlecode.com/
   4 Version: unknown
   5 Revision: 109
   6 Security Critical: yes
   7
   8 Description:
   9 This contains Chromium's locally patched copy of tcmalloc.
  10
  11 Contents:
  12
  13   chromium/
  14
  15     The chromium patched sources, copied from the vendor/
  16     subdirectory and containing our local modifications.
  17
  18     We only copy over the vendor/src/ subdirectory (the only piece
  19     we need) but still leave it in a chromium/src/ subdirectory to
  20     keep the directory structures in parallel.
  21
  22   vendor/
  23
  24     Vanilla sources from upstream:
  25
  26       http://google-perftools.googlecode.com/svn/trunk
  27
  28     The current revision is:
  29
  30       Last Changed Rev: 111
  31       Last Changed Date: 2011-07-16 05:07:10 +0400 (Sat, 16 Jul 2011)
  32
  33
  34
  35 HOWTOs:
  36
  37   Take a new version from upstream:
  38
  39     1)  Grab the revision:
  40
  41         $ svn export [-r {tcmalloc-rev}] \
  42           http://google-perftools.googlecode.com/svn/trunk \
  43           vendor-{tcmalloc-rev}
  44
  45     2)  Check for added or deleted files:
  46
  47         $ diff -q -r -x .svn vendor vendor-{tcmalloc-rev}
  48
  49     3)  Copy the new revision on top of the checked-in vendor branch:
  50
  51         $ cp -r vendor-{tcmalloc-rev}/* vendor
  52
  53         C:\> xcopy /e/y/i vendor-{tcmalloc-rev}\* vendor
  54
  55     4)  "svn add" or "svn rm" added or removed files (based on your
  56         "diff -q -r" output from above)
  57
  58     5)  Create the CL, upload, check it in:
  59
  60         $ gcl change CL
  61         $ gcl upload CL
  62         $ gcl commit CL
  63
  64         Note the revision number since you're going to want to merge
  65         that to the local chromium branch.
  66
  67   Merge a new upstream version with our local patched copy:
  68
  69     1)  Merge the local revision to chromium/src
  70
  71         $ svn merge -c {chrome-rev} svn://chrome-svn/chrome/trunk/src/third_party/tcmalloc/vendor/src chromium/src
  72
  73     2)  Resolve any conflicts
  74
  75     3)  Create the CL, upload, check in:
  76
  77         $ gcl change CL
  78         $ gcl upload CL
  79         $ gcl commit CL