debian/README.Debian

   1 For now, the shared libraries of Rust are private.
   2 The rational is the following:
   3  * Upstream prefers static linking for now
   4    - https://github.com/rust-lang/rust/issues/10209
   5  * rust is still under heavy development. As far as we know, there is
   6    no commitement from upstream to provide a stable ABI for now.
   7    Until we know more, we cannot take the chance to have Rust-built packages
   8    failing at each release of the compiler.
   9  * Static builds are working out of the box just fine
  10  * However, LD_LIBRARY_PATH has to be updated when -C prefer-dynamic is used
  11
  12  -- Sylvestre Ledru <sylvestre@debian.org>, Fri, 13 Feb 2015 15:08:43 +0100
  13
  14 Bootstrapping from nothing
  15 --------------------------
  16
  17 You need a "stage0" rust compiler from somewhere.  You can download a
  18 pre-built minimal stage0 from http://www.rust-lang.org/ at build time,
  19 or use a rustc that was already in /usr/bin via whatever black magic
  20 (or some other path if you modify debian/rules).
  21
  22     apt-get source --compile --build-profiles=dlstage0,nodocs rustc
  23
  24 "dlstage0" downloads a stage0 from rust-lang.org during the build.
  25 "nodocs" disables building rust-doc package and skips the long list of
  26 build-deps usually required.
  27
  28     dpkg -i rustc*.deb
  29     apt-get source --compile rustc
  30
  31 This produces the full rust compiler built using your now obsolete
  32 "dlstage0" rustc compiler.
  33
  34 Bootstrapping a new architecture
  35 --------------------------------
  36
  37 0. Start with rust installed on an existing platform
  38
  39 1. Build a rust cross-compiler targeting new architecture
  40
  41     sudo apt-get build-dep --build-profile=nodocs rustc
  42     dpkg-buildpackage -t $new_arch
  43
  44 2. Use cross-compiler to build a compiler that runs on new architecture
  45
  46     dpkg --add-architecture $new_arch
  47     sudo apt-get build-dep --host-architecture=$new_arch rustc
  48     dpkg-buildpackage -a $new_arch
  49
  50     # Perhaps this is sufficient ??
  51     #apt-get source --compile --host-architecture=$new_arch rustc
  52
  53  -- Angus Lees <gus@debian.org>, Sun,  1 Feb 2015 16:16:44 +1100