This allows limiting the number of linker jobs to avoid swapping when
linking LLVM with debug info.

The args() and args_os() docs include a line about how the first element
is usually the program name. Include that line in the struct docs too.

This controls the value of the crt-static feature used when building the
compiler and standard library. It can be set per target.

This avoids the possibility of a duplicate or conflicting crt-static
command line option sent to rustc.

These options only exist for the special case of static cross-linking
pure rust code for a musl-based target with a non-musl toolchain. In all
other situations (dynamic linking, presence of a native or cross
compiler) these objects will be automatically provided and linked by the
toolchain.

To maintain existing behavior, it is disabled by default on all
architectures except MIPS.

These were conditioned on architecture because traditionally MIPS was
dynamically linked, while other arches used musl for static linking. Now
that we support both methods of linking on all architectures, these
special cases no longer make sense

Add a comment explaining why copying startup files is always necessary

… r? @steveklabnik

Makes the sidebar a light grey and highlights the currently viewed item
in the sidebar more prominently.

All visual design credit goes to @johnwhelchel (rust-lang#37856)

Fixes rust-lang#39733.

Fixes rust-lang#39201.

I've been seeing failures on the bots when building jemalloc and my assumption
is that it's because cwd isn't created. That may be possible if this
`create_dir_all` call change in this commit fails, in which case we ignore the
error.

This commit updates the location to call `create_dir_racy` which handles
concurrent invocations, as multiple build scripts may be trying to create the
`native` dir.

Support dynamically-linked and/or native musl targets

These changes allow native compilation on musl-based distributions and the use of dynamic libraries on linux-musl targets. This is intended to remove limitations based on past assumptions about musl targets, while maintaining existing behavior by default.

A minor related bugfix is included.

…frewsxcv

add unstable book to the bookshelf

r? @frewsxcv @GuillaumeGomez

…xcrichton

Extract nomicon to its own repo

part of rust-lang#39588

same as rust-lang#40213 but for the nomicon

r? @alexcrichton

Issue rust-lang#39688 - Help people find String::as_bytes() for UTF-8

Added in links for the inverse functions so people will know that as_bytes() is the inverse of from_utf8() and vice versa.
?r @steveklabnik

Fix description of closure coercion feature

Thanks to @whitequark for pointing this out.

…umeGomez

Improve the style of the sidebar in rustdoc output

Makes the sidebar a light grey and highlights the currently viewed item in the sidebar more prominently.

All visual design credit goes to @johnwhelchel (rust-lang#37856)

Sample screenshots:

![screen shot 2017-03-04 at 12 29 48 pm](https://cloud.githubusercontent.com/assets/831192/23580829/db6c26c2-00d6-11e7-8d89-822e25ba79f0.png)

![screen shot 2017-03-04 at 12 30 10 pm](https://cloud.githubusercontent.com/assets/831192/23580828/db69eeca-00d6-11e7-9f89-1e06fd3bf098.png)

![screen shot 2017-03-04 at 12 30 31 pm](https://cloud.githubusercontent.com/assets/831192/23580830/db6d00ce-00d6-11e7-89ca-cd03e148a121.png)

…alexcrichton

rustbuild: expose LLVM_PARALLEL_LINK_JOBS

This allows limiting the number of linker jobs to avoid swapping when linking LLVM with debug info.

clarify docs for Args and ArgsOs

The args() and args_os() docs include a line about how the first element
is usually the program name. Include that line in the struct docs too.

Fix text formatting in README

There was a missing backtick in the README.

Remove extra space in test description (of a mod test)

Fix a typo in the docs

…turon

README formatting in configure/make section

Tiny change to render the `config.mk` correctly

Added remove_from to vec.rs (rust-lang#38143)

Turns out that if you push to someone's PR branch and cause the PR to close, you lose delegation 😞.

@madseagames I'm really sorry about that 😭

…chton

Update link to COMPILER_TESTS.md in CONTRIBUTING.md

Link to compiler test documentation was broken after the file was moved by rust-lang#40086.
This updates the link to the new location of the file.

Add missing urls in some macros doc

r? @frewsxcv

Clarify handling of `src` in `ptr::write`

Fixes rust-lang#39733.

…eklabnik

Document why `str.to_{lower,upper}case` return `String`

Fixes rust-lang#39201.

rustbuild: Assert directory creation succeeds

I've been seeing failures on the bots when building jemalloc and my assumption
is that it's because cwd isn't created. That may be possible if this
`create_dir_all` call change in this commit fails, in which case we ignore the
error.

This commit updates the location to call `create_dir_racy` which handles
concurrent invocations, as multiple build scripts may be trying to create the
`native` dir.