debian/README.source

   1 Document by Luca Bruno & Sylvestre Ledru
   2
   3 This source package is unfortunately quite tricky and with
   4 several cutting edges, due to the complexity of rust-lang
   5 bootstrapping system and the high rate of language changes
   6 still ongoing.
   7
   8 We try to describe here inner packaging details and the
   9 reasons behind them.
  10
  11
  12 Embedded libraries
  13 ==================
  14
  15 This source package embeds several external libraries (foeked and managed
  16 by rust upstream as git submodules).
  17 In early stages, many more libraries were forked/emebedded but we are steadily
  18 progressing in splitting them out.
  19
  20 Here below the remaining ones, with the technical reasons.
  21
  22  * jemalloc from https://github.com/rust-lang/jemalloc
  23    -> system-wide one can't be used due to rust using a "je_" prefix.
  24
  25    This is intentional upstream design and won't change soon, see:
  26     - https://github.com/rust-lang/rust/pull/18678
  27     - http://smallcultfollowing.com/babysteps/blog/2014/11/14/allocators-in-rust/
  28
  29  * compiler-rt from https://github.com/rust-lang/compiler-rt
  30    -> system-wide compiler-rt fails during linkage
  31
  32    Bug reported upstream, still to be fixed, see:
  33     - https://github.com/rust-lang/rust/issues/15054
  34     - https://github.com/rust-lang/rust/issues/15708
  35
  36 As a summary, we plan to:
  37  * keep embedding jemalloc (probably forever)
  38  * work with upstream to fix compiler-rt linkage soon.
  39
  40  -- Sylvestre Ledru <sylvestre@debian.org>  Fri, 27 Mar 2015 14:27:12 +0100
  41