TRPL: Clean up some Markdown links

In all other places the IDs of link references are without spaces (and
explicitly set).

Auto merge of #25764 - tshepang:typo, r=steveklabnik

Auto merge of #25761 - ralexstokes:master, r=steveklabnik

Typo in explanation of difference between stack and heap values.

`baz` is called at the end of a call to `bar` inside another call to `foo`.  `baz` takes a copy of the value `e` which should have a value of 9 if following the rest of the stack trace.

This PR fixes this typo and should close #25635.

Auto merge of #25736 - tshepang:path-nits, r=steveklabnik

Auto merge of #25756 - tshepang:needless-cloned, r=steveklabnik

doc: fix io::Write::write typo

Auto merge of #25758 - tshepang:add-cloned-example, r=Gankro

doc: add example for Iterator::cloned()

Fix typo in diagram demonstrating stack vs. heap values

doc: cloned() and mut not needed

Auto merge of #25464 - zaeleus:trpl-riol, r=pnkfelix

r? @steveklabnik

Auto merge of #25609 - nikomatsakis:const-fn, r=pnkfelix

This is a port of @eddyb's `const-fn` branch. I rebased it, tweaked a few things, and added tests as well as a feature gate. The set of tests is still pretty rudimentary, I'd appreciate suggestions on new tests to write. Also, a double-check that the feature-gate covers all necessary cases.

One question: currently, the feature-gate allows the *use* of const functions from stable code, just not the definition. This seems to fit our usual strategy, and implies that we might (perhaps) allow some constant functions in libstd someday, even before stabilizing const-fn, if we were willing to commit to the existence of const fns but found some details of their impl unsatisfactory.

r? @pnkfelix

Auto merge of #25168 - Manishearth:register_attr, r=eddyb

This lets plugin authors opt attributes out of the `custom_attribute`
and `unused_attribute` checks.

cc @thepowersgang

Auto merge of #25719 - brson:crosslink, r=eddyb

The recent MSVC patch made the build system pass explicit linkers to
rustc, but did not set that up for anything other than MSVC.

This is blocking nightlies.

Auto merge of #25666 - tshepang:better-path-docs, r=steveklabnik

doc: fix Windows test failure

path: make this bit follow idiom

doc: missing words

Auto merge of #25735 - oli-obk:rollup, r=steveklabnik

- Successful merges: #25681, #25687, #25695, #25697, #25702, #25703, #25709, #25710, #25714, #25715, #25716, #25722
- Failed merges:

Rollup merge of #25722 - nickdesaulniers:configureClang37, r=brson

Was able to successfully configure.  Building and testing now.

Rollup merge of #25716 - steveklabnik:remove_bad_docs, r=Gankro

Rollup merge of #25715 - nero-luci:patch-1, r=steveklabnik

I consider that this version has a better reading fluency, instead of having a period between clauses

Rollup merge of #25714 - brianquinlan:patch-1, r=huonw

Rollup merge of #25710 - Manishearth:no_decorator_clone, r=sfackler

fixes #25683

I have a very nonscientific measurement of the data via valgrind/massif [here](https://gist.github.com/Manishearth/4c47f15f6835cb3957c4)

I measured the memory usage for both --pretty=expanded and -Z no-trans

It *seems* like there's a 20-25MB decrease during expansion on stage2 librustc; but I'm not quite sure.

r? @eddyb

(have not yet run tests, but it compiles fine, might want to wait before giving r+)

cc @nrc @huon

Rollup merge of #25709 - MatejLach:stdlib_style, r=steveklabnik

Sounds better to me this way.
r @steveklabnik ?

Rollup merge of #25703 - eddyb:lazier-loads, r=pnkfelix

Reduces pre-trans heap baseline (tested on `fn main() {}`) from 1.2MB to 696kB.
Most of the remaining allocations are used by imported macros.
While it might be possible to also load macros lazily, doing so is non-trivial and this PR doesn't tackle that.

Rollup merge of #25702 - killercup:rustdoc/search-primitives, r=Gankro

This minimally changes rustdoc's search as described in #25167.

Additionally, I also cleaned up some parts of the JS code.

There is one more change I made: After each result for a primitive type, I added "(Overview of primitive type)". This further differentiates the result from the module (previously, the only difference was that the module's link was blue). I'm not this is the way to go (this seems to be the only place where we do this) and it's no problem for me to remove that commit.


cc @steveklabnik (it concerns docs) and @alexcrichton (who made changes to rustdoc previously)

Rollup merge of #25697 - geofft:configure-friendliness, r=brson

Make the error message about missing dependencies clearer, since "need program file" is pretty confusing, and make full commands get logged, since that seems to have been the intention.

Rollup merge of #25695 - mbrubeck:reference, r=brson

r? @steveklabnik

Rollup merge of #25687 - tamird:num-self-cleanup, r=Gankro

Cleanup extracted from #25684. r? @alexcrichton

Rollup merge of #25681 - steveklabnik:gender, r=nmatsakis

Also, when checking for common gendered words elsewhere, I found one 'he', moved to 'they' as well.

https://github.com/rust-lang/rust/pull/25640#issuecomment-104304643

Auto merge of #25667 - lambda:rename-soft_link-to-symlink-landed-in-1.1, r=aturon

The change to split up soft_link to OS-specific symlink, symlink_file,
and symlink_dir didn't actually land in 1.0.0.  Update the stability and
deprecation attributes to correctly indicate that these changes happend
in 1.1.0.

Auto merge of #25653 - dotdash:unsize_c, r=luqmana

Fixes #25581

Auto merge of #25632 - alexcrichton:dt-dir, r=brson

This "fast path" in `DirEntry::file_type` on Unix wasn't turning out to be so
much of a fast path as the `DT_DIR` case wasn't handled, so directories fell
back to using `lstat` instead. This commit adds the missing case to return
quickly if a path is a directory and `DirEntry::file_type` is used.

Auto merge of #25416 - kballard:ffi-cstr-to-str-convenience, r=alexcrichton

This was motivated by http://www.evanmiller.org/a-taste-of-rust.html.

A common problem when working with FFI right now is converting from raw
C strings into `&str` or `String`. Right now you're required to say
something like

    let cstr = unsafe { CStr::from_ptr(ptr) };
    let result = str::from_utf8(cstr.to_bytes());

This is slightly awkward, and is not particularly intuitive for people
who haven't used the ffi module before. We can do a bit better by
providing some convenience methods on CStr:

    fn to_str(&self) -> Result<&str, str::Utf8Error>
    fn to_string_lossy(&self) -> Cow<str>

This will make it immediately apparent to new users of CStr how to get a
string from a raw C string, so they can say:

    let s = unsafe { CStr::from_ptr(ptr).to_string_lossy() };

Auto merge of #24847 - sfackler:debug-builders-stability, r=aturon

The `debug_builders` feature is up for 1.1 stabilization in #24028. This commit stabilizes the API as-is with no changes.

Some nits that @alexcrichton mentioned that may be worth discussing now if anyone cares:

* Should `debug_tuple_struct` and `DebugTupleStruct` be used instead of `debug_tuple` and `DebugTuple`? It's more typing but is a technically more correct name.
* `DebugStruct` and `DebugTuple` have `field` methods while `DebugSet`, `DebugMap` and `DebugList` have `entry` methods. Should we switch those to something else for consistency?

cc @alexcrichton @aturon

Auto merge of #25717 - brson:compiler-docs, r=pnkfelix

The install target depends on compiler-docs but 'all' does not.
This means that running 'make && make install' will run additional
doc builds and tests during installation, which hides bugs in
the build.

For now this just unconditionally stops building compiler docs.

Merge pull request #25706 from pnkfelix/remove-diagnostics-gen-and-check

Remove error diagnostics uniqueness check and .json generation.

allow clang 3.7 to be used when configuring Fixes #25720

Specify linkers for cross-compile scenarios

The recent MSVC patch made the build system pass explicit linkers to
rustc, but did not set that up for anything other than MSVC.

Rustdoc Search: Add Hint to Primitive Type Result

Closes #25167

mk: Don't build compiler-docs before installation. #25699

The install target depends on compiler-docs but 'all' does not.
This means that running 'make && make install' will run additional
doc builds and tests during installation, which hides bugs in
the build.

For now this just unconditionally stops building compiler docs.

Don't mention outdated methods

Update guessing-game.md

I consider that this version has a better reading fluency, instead of having a period between clauses

Add some convenience methods to go from CStr -> str

A common problem when working with FFI right now is converting from raw
C strings into `&str` or `String`. Right now you're required to say
something like

    let cstr = unsafe { CStr::from_ptr(ptr) };
    let result = str::from_utf8(cstr.to_bytes());

This is slightly awkward, and is not particularly intuitive for people
who haven't used the ffi module before. We can do a bit better by
providing some convenience methods on CStr:

    fn to_str(&self) -> Result<&str, str::Utf8Error>
    fn to_string_lossy(&self) -> Cow<str>

This will make it immediately apparent to new users of CStr how to get a
string from a raw C string, so they can say:

    let s = unsafe { CStr::from_ptr(ptr).to_string_lossy() };

Make it clear that push is only amortized O(1)

better describe the stdlib

Let MultiItemDecorator take `&Annotatable` (fixes #25683)

Remove error diagnostics uniqueness check and .json generation.

This is meant to be a temporary measure to get the builds to be
reliable again; see also Issue #25705.

Lazy-load filemaps from external crates.

Two more small fixes.

Rustdoc Search: Increase Relevance of Primitives

Rustdoc: Clean Up Some JS

There are more possible optimizations left (cached length in loops) as
well as some possible bugs (shadowed variables) to fix. This is mostly
syntactic.

configure: Fix printing of commands from `run`

The `run` function passed its argument to `msg` via `"$@"`, but `msg`
only printed its first argument. I think the intention was for `msg` to
print all its arguments. (If not, `run` should only `msg "$1"`.)

configure: Clarify error message about missing dependencies

Took me a moment to figure out that the appropriate response to
"need program file" was to install the program named "file", not
to think "If I didn't need the program file, why would I be
compiling things?".

Document the debug_assertions cfg option

Auto merge of #25669 - GuillaumeGomez:typo-fix, r=Manishearth

r? @steveklabnik

doc: miscellaneous improvements to std::path::Path examples

Replace "more later" by "later"

Standardize on `$t:ty`

Use `Self` to simplify

Auto merge of #25601 - ericye16:master, r=steveklabnik

she -> they in Dining Philosophers

Also, when checking for common gendered words elsewhere, I found one 'he', moved to 'they' as well.

https://github.com/rust-lang/rust/pull/25640#issuecomment-104304643

Make various fixes:
- add feature gate
- add basic tests
- adjust parser to eliminate conflict between `const fn` and associated
constants
- allow `const fn` in traits/trait-impls, but forbid later in type check
- correct some merge conflicts

rustc_trans: evaluate `const fn` function and method calls.

rustc: const-qualify `const fn` function and method calls.

syntax: parse `const fn` for free functions and inherent methods.

Auto merge of #25473 - doomrobo:patch-3, r=steveklabnik

Added `Deref` to the "Special Traits" section

Auto merge of #25676 - dmgawel:patch-1, r=huonw

Earlier created vector `["Hello", "world"]` has two elements and we try to add a third element.

Introduction vector example elements counting fix

Earlier created vector `["Hello", "world"]` has two elements and we try to add a third element.

Auto merge of #25552 - GuillaumeGomez:left-hand-error, r=pnkfelix

Part of #24407.

Fix ICE trying to pass DST to C functions

Fixes #25581

Auto merge of #25671 - Manishearth:rollup, r=Manishearth

- Successful merges: #25648, #25659, #25661, #25665
- Failed merges:

Rollup merge of #25665 - OlegTsyba:fix_documentation, r=Gankro

fix a small typo in the official tutorial. "coerce" instead of "coerece"
r? @steveklabnik

Rollup merge of #25661 - Stebalien:macro, r=Gankro

They don't have to be followed by anything.

Rollup merge of #25659 - tshepang:improve-rendering, r=steveklabnik

Rollup merge of #25648 - semarie:head-cut, r=luqmana

the "-c" option of head isn't a posix option, and it isn't supported
under openbsd.

prefer the use of cut -c 1-8 (which is posix) to extract the first 8
chars.

r? @alexcrichton

Auto merge of #25656 - tshepang:spell-em-out, r=brson

Auto merge of #25644 - iven:fix_doc_warning, r=steveklabnik

The syntax with tailing semicolon is deprecated and the compiler will
complain about it.

r? @steveklabnik

Auto merge of #25631 - taiyaeisforks:master, r=steveklabnik

Saw one, decided to fix a few more :) Had to Google supercede because it looked funny, turns out it's a really common misspelling!

Fix stability and deprecation markers on soft_link and symlink

The change to split up soft_link to OS-specific symlink, symlink_file,
and symlink_dir didn't actually land in 1.0.0.  Update the stability and
deprecation attributes to correctly indicate that these changes happend
in 1.1.0.

Auto merge of #25612 - petrochenkov:lintabs, r=@alexcrichton

Reported here https://github.com/rust-lang/rust/pull/25441#issuecomment-103513930

Fix the typo in The Rust Programming Language book, 5.18. Strings

Auto merge of #25625 - bluss:doc-slice-order, r=Gankro

collections: Reorder slice methods to improve API docs

We have an evolutionary history whose traces are still visible in the
slice docs today.

Some heuristics:

* Group method and method_mut together
* Group method and method_by together
* Group by use case, here we have roughly:

  Basic interrogators (len)
  Mutation (swap)
  Iterators (iter)
  Segmentation (split)
  Searching (contains)
  Permutations (permutations)
  Misc (clone_from_slice)

Typo fix on E0067

Change "must" to "may only" in macro future proofing rules.

They don't have to be followed by anything.

doc: that did not render well, so make it fit in one line

Auto merge of #25652 - arielb1:free-self, r=nikomatsakis

This is needed because `Self` can be substituted to a type with
lifetime parameters.

Fixes #24308
Fixes #25071
Fixes #25259
Fixes #25279

doc: 'reader' and 'writer' are nicer to read than 'r' and 'w'

Substitute free lifetimes when `Self` is used within a method body

This is needed because `Self` can be substituted to a type with
lifetime parameters.

Fixes #24308
Fixes #25071
Fixes #25259
Fixes #25279

Auto merge of #25571 - hirschenberger:master, r=nrc

It is hard to find the actual unstable feature which caused the error when using a list of stable and unstable features as the span marks the whole line

```
src/k8055.rs:22:1: 22:64 error: unstable feature
src/k8055.rs:22 #![feature(slice_patterns, rustc_private, core, convert, libc)]
                ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
```

This PR spawns an error for each unstable feature in the list:

```
est.rs:1:12: 1:26 error: unstable feature [-D unstable-features]
test.rs:1 #![feature(slice_patterns, rustc_private, core, convert, libc)]
                     ^~~~~~~~~~~~~~
test.rs:1:28: 1:41 error: unstable feature [-D unstable-features]
test.rs:1 #![feature(slice_patterns, rustc_private, core, convert, libc)]
                                     ^~~~~~~~~~~~~
test.rs:1:43: 1:47 error: unstable feature [-D unstable-features]
test.rs:1 #![feature(slice_patterns, rustc_private, core, convert, libc)]
                                                    ^~~~
test.rs:1:49: 1:56 error: unstable feature [-D unstable-features]
test.rs:1 #![feature(slice_patterns, rustc_private, core, convert, libc)]
                                                          ^~~~~~~
test.rs:1:58: 1:62 error: unstable feature [-D unstable-features]
test.rs:1 #![feature(slice_patterns, rustc_private, core, convert, libc)]
                                                                   ^~~~
```

Add error explanation for E0070

Auto merge of #25390 - eddyb:typeck-pub, r=nrc

Needed for driving parts of type-checking manually.

Auto merge of #25645 - luqmana:lnr, r=eddyb

This micro-optimization actually led to generating broken IR in certain cases.

Fixes #18845.
Fixes #25497.

Auto merge of #25615 - petrochenkov:issue25542, r=alexcrichton

Closes https://github.com/rust-lang/rust/issues/25542

r? @alexcrichton

use posix command to extract first 8 chars

the "-c" option of head isn't a posix option, and it isn't supported
under openbsd.

prefer the use of cut -c 1-8 (which is posix) to extract the first 8
chars.

Auto merge of #25610 - mbrubeck:bufread-docs, r=alexcrichton

r? @steveklabnik

collections: Reorder slice methods to improve API docs

We have an evolutionary history whose traces are still visible in the
slice docs today.

Some heuristics:

* Group method and method_mut together
* Group method and method_by together
* Group by use case, here we have roughly:

  Basic interrogators (len)
  Mutation (swap)
  Iterators (iter)
  Segmentation (split)
  Searching (contains)
  Permutations (permutations)
  Misc (clone_from_slice)

Fix panic in lint for out of range literals

Auto merge of #25596 - Ms2ger:rbml-docs, r=alexcrichton

This leads to more idiomatic code in the callers.