Clear Build Instructions

[borats]

Hi there,

First off thanks. This project is interesting. But at the same time it is unbuildable.

I understand this project is new and is in the process of gaining traction. However, the first thing anyone looking at experimental projects does is to go through the README and INSTALL file to understand how to build it. I faced the following issues whilst following the instructions in README (using both nightly and stable results in failure to build).

% cargo install cargo-when --force
    Updating crates.io index
  Installing cargo-when v0.1.0
   Compiling libc v0.2.58
   Compiling bitflags v1.1.0
   Compiling unicode-width v0.1.5
   Compiling strsim v0.8.0
   Compiling ansi_term v0.11.0
   Compiling vec_map v0.8.1
   Compiling nom v1.2.4
   Compiling textwrap v0.11.0
   Compiling atty v0.2.11
   Compiling semver v0.2.3
   Compiling clap v2.33.0
   Compiling cargo-when v0.1.0
    Finished release [optimized] target(s) in 14.13s
   Replacing /home/borats/.cargo/bin/cargo-when
    Replaced package `cargo-when v0.1.0` with `cargo-when v0.1.0` (executable `cargo-when`)
% rustup toolchain install nightly-x86_64-unknown-linux-gnu
info: syncing channel updates for 'nightly-x86_64-unknown-linux-gnu'

  nightly-x86_64-unknown-linux-gnu unchanged - rustc 1.37.0-nightly (8aa42ed7c 2019-06-24)

info: checking for self-updates
% rustup default nightly-x86_64-unknown-linux-gnu
info: using existing install for 'nightly-x86_64-unknown-linux-gnu'
info: default toolchain set to 'nightly-x86_64-unknown-linux-gnu'

  nightly-x86_64-unknown-linux-gnu unchanged - rustc 1.37.0-nightly (8aa42ed7c 2019-06-24)

% rustup target install x86_64-unknown-linux-musl
info: component 'rust-std' for target 'x86_64-unknown-linux-musl' is up to date
% ./build.sh
       Fresh autocfg v0.1.4
       Fresh cc v1.0.37
       Fresh unicode-xid v0.0.4
       Fresh quote v0.3.15
       Fresh serde v0.9.15
       Fresh cfg-if v0.1.9
       Fresh void v1.0.2
       Fresh dtoa v0.4.4
       Fresh itoa v0.3.4
       Fresh unicode-width v0.1.5
       Fresh rustc-demangle v0.1.15
       Fresh error-chain v0.11.0
       Fresh vec_map v0.8.1
       Fresh ansi_term v0.11.0
       Fresh strsim v0.8.0
       Fresh scopeguard v0.3.3
       Fresh lazy_static v1.3.0
       Fresh synom v0.11.3
       Fresh log v0.4.6
       Fresh textwrap v0.11.0
   Compiling railcar v1.0.4 (/home/borats/railcar)
       Fresh libc v0.2.58
       Fresh syn v0.11.11
       Fresh bitflags v1.1.0
     Running `/home/borats/railcar/target/debug/build/railcar-97580fb017f47a4c/build-script-build`
       Fresh num-traits v0.2.8
       Fresh backtrace-sys v0.1.28
       Fresh serde_codegen_internals v0.14.2
       Fresh nix v0.14.1
       Fresh atty v0.2.11
       Fresh errno v0.2.4
       Fresh nix v0.11.1
       Fresh seccomp-sys v0.1.2
       Fresh num-traits v0.1.43
       Fresh serde_derive v0.9.15
       Fresh backtrace v0.3.31
       Fresh caps v0.2.0
       Fresh prctl v1.0.0
       Fresh clap v2.33.0
       Fresh serde_json v0.9.10
       Fresh error-chain v0.10.0
       Fresh oci v0.1.0 (/home/borats/railcar/oci)
     Running `rustc --crate-name railcar src/main.rs --color always --crate-type bin --emit=dep-info,link -C debuginfo=2 --cfg 'feature="nightly"' -C metadata=12d0de802f07e3fd -C extra-filename=-12d0de802f07e3fd --out-dir /home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps --target x86_64-unknown-linux-gnu -C incremental=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/incremental -L dependency=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps -L dependency=/home/borats/railcar/target/debug/deps --extern caps=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libcaps-67d173d58ebaebb3.rlib --extern clap=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libclap-eb82d8d1deb68ea9.rlib --extern error_chain=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/liberror_chain-750966dd47db576b.rlib --extern lazy_static=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/liblazy_static-f8ceff266b2f605c.rlib --extern libc=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/liblibc-ec4a4f7dac2918e1.rlib --extern log=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/liblog-fd8c27578fe85362.rlib --extern nix=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libnix-1c93976f2ea74ddf.rlib --extern num_traits=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libnum_traits-b589b2077b20211c.rlib --extern oci=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/liboci-22f042852e491cad.rlib --extern prctl=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libprctl-eff9f095377cf6ec.rlib --extern scopeguard=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libscopeguard-4169729df20e381e.rlib --extern seccomp_sys=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libseccomp_sys-c808e7f6ba5ce040.rlib -L native=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/build/backtrace-sys-7891320c1b99be3c/out`
error[E0463]: can't find crate for `alloc_system`
 --> src/main.rs:6:1
  |
6 | extern crate alloc_system;
  | ^^^^^^^^^^^^^^^^^^^^^^^^^^ can't find crate

error: aborting due to previous error

For more information about this error, try `rustc --explain E0463`.
error: Could not compile `railcar`.

Caused by:
  process didn't exit successfully: `rustc --crate-name railcar src/main.rs --color always --crate-type bin --emit=dep-info,link -C debuginfo=2 --cfg 'feature="nightly"' -C metadata=12d0de802f07e3fd -C extra-filename=-12d0de802f07e3fd --out-dir /home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps --target x86_64-unknown-linux-gnu -C incremental=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/incremental -L dependency=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps -L dependency=/home/borats/railcar/target/debug/deps --extern caps=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libcaps-67d173d58ebaebb3.rlib --extern clap=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libclap-eb82d8d1deb68ea9.rlib --extern error_chain=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/liberror_chain-750966dd47db576b.rlib --extern lazy_static=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/liblazy_static-f8ceff266b2f605c.rlib --extern libc=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/liblibc-ec4a4f7dac2918e1.rlib --extern log=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/liblog-fd8c27578fe85362.rlib --extern nix=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libnix-1c93976f2ea74ddf.rlib --extern num_traits=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libnum_traits-b589b2077b20211c.rlib --extern oci=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/liboci-22f042852e491cad.rlib --extern prctl=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libprctl-eff9f095377cf6ec.rlib --extern scopeguard=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libscopeguard-4169729df20e381e.rlib --extern seccomp_sys=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/deps/libseccomp_sys-c808e7f6ba5ce040.rlib -L native=/home/borats/railcar/target/x86_64-unknown-linux-gnu/debug/build/backtrace-sys-7891320c1b99be3c/out` (exit code: 1)
cp: cannot stat 'target/x86_64-unknown-linux-gnu/debug/railcar': No such file or directory

Any chance you could provide an up-to date README? Thanks