fix example code

add warning about reference section

clarify subtyping

fix borrow-splitting

fix incorrect name

lots more felix fixes

many many pnkfelix fixes

OBRM for aturon

vec fixes for huonw

fixups for aturon

fixup atomics

expand lifetime splitting to show IterMut is totally safe

fix accident

remove subtyping from coercions, it's something else

clarify casts are checked at compile time

remove redundant explanation

explain phantom

get into the weeds over GEP and allocations

UB is src bzns

mention void pointers

clean up vec chapter of tarpl

flesh out void types

some conversions cleanup

fixup and cool example for checked-uninit

fix up lifetimes

fix typo

no really I deleted you

shard out misc section on lifetimes properly

update subtyping to be a bit clearer about reference variance

properly remove moved text

split out vec-zsts correctly

fix all the doc tests

nits and realigning

fix via mdinger

update build to make tarpl

move everything into the Rust tree

move everything to tarpl

remove chaff

remove salsh

several fixups

shard out and clean up unwinding

fix definition

clarify atomics

Auto merge of #26241 - SimonSapin:derefmut-for-string, r=alexcrichton

See https://github.com/rust-lang/rfcs/issues/1157

Auto merge of #27006 - ryanp-me:apple-llvm, r=brson

Since Apple LLVM no longer reports which version of LLVM it's based off (starting with 7.0.0), I believe it's time to start checking Apple LLVM versions directly.

The changes in this pull request update the `configure` script to check "Apple LLVM" versions independently if no "based off" version can be found. If a "based off" version is included, however, it will be preferred.

(This is a less hacky version of #26653)

Fix tests for changes in #26241.

Auto merge of #26993 - michaelwoerister:msvc-debuginfo, r=alexcrichton

This PR will enable RUSTC to generate PDB debuginfo files when targeting the MSVC toolchain. Mind that these are not full featured PDB files -- they just contain line tables, so you can get proper backtraces and step through your code, but variable values can't be inspected. We are just levering (LLVM's current support)[http://clang.llvm.org/docs/MSVCCompatibility.html] for creating Windows debuginfo. When LLVM's support gets better, we should benefit from that too without much effort.

I also wanted to include some kind of auto test with this PR but I could not get the `rmake` tests to work properly when targeting MSVC.

EDIT:
Closes #19533

fix

Auto merge of #26984 - nham:errorck-ignore-long-diag, r=brson

Currently errorck yields bogus `duplicate error code` messages when an error code occurs inside of a long diagnostic message (see https://github.com/rust-lang/rust/pull/26982), because errorck just goes line by line checking for error codes and recording them all.

A simplistic approach to fixing this is just to detect the beginning of a long diagnostic raw string literal (`r##"`) and skip lines until the end of the raw string literal is encountered. I'm not completely confident in this approach, but I think a more robust approach would be more complicated and I wanted to get feedback before pursuing that.

rewrite intro

Auto merge of #27001 - tsion:patch-2, r=Gankro

Mark some new things as unstable.

Add str::split_at_mut

Implement IndexMut for String and str.

... matching the existing Index impls.
There is no reason not to if String implement DerefMut.

The code removed in `src/librustc/middle/effect.rs` was added in #9750
to prevent things like `s[0] = 0x80` where `s: String`,
but I belive became unnecessary when the Index(Mut) traits were introduced.

Add more tests for AsciiExt::is_ascii

Add tests for AsciiExt::make_ascii_*case, including on String.

Implement DerefMut for String

`&mut str` is rarely useful, but it is for e.g.
`AsciiExt::make_ascii_lowercase`.

Auto merge of #27000 - alexcrichton:semi-after-type, r=cmr

This commit expands the follow set of the `ty` and `path` macro fragments to
include the semicolon token as well. A semicolon is already allowed after these
tokens, so it's currently a little too restrictive to not have a semicolon
allowed. For example:

    extern {
        fn foo() -> i32; // semicolon after type
    }

    fn main() {
        struct Foo;

        Foo; // semicolon after path
    }

Auto merge of #27011 - dotdash:issue-26996, r=luqmana

If we match a whole struct or tuple, the "field" for the reassignment
checker will be "None" which means that mutating any field should count
as a reassignment.

Fixes #26996.

Correctly detect reassignments to the interior of matched structs/tuples

If we match a whole struct or tuple, the "field" for the reassignment
checker will be "None" which means that mutating any field should count
as a reassignment.

Fixes #26996.

Auto merge of #26999 - rick68:patch-13, r=Gankro

Reverse PR `#26944 `, symbol `#` are actually as intended.

Auto merge of #26990 - rwz:patch-1, r=alexcrichton

The current example does not illustrate threaded behavior imo.

Auto merge of #26981 - wthrowe:div_docs, r=Gankro

This resolves #26845.

I'm not entirely satisfied with the placement of the rounding discussion in the docs for the `Div` and `Rem` traits, but I couldn't come up with anywhere better to put it.  Suggestions are welcome.

I didn't add any discussion of rounding to the `checked_div` (or rem) or `wrapping_div` documentation because those seem to make it pretty clear that they do the same thing as `Div`.

verify Apple LLVM versions independently, since the "based on LLVM" version is no longer reported

Auto merge of #26910 - nrc:ice-lang-item, r=@huonw

Auto merge of #26947 - nagisa:unicode-escape-error, r=nrc

Inspired by the now-mysteriously-closed https://github.com/rust-lang/rust/pull/26782.

This PR introduces better error messages when unicode escapes have invalid format (e.g. `\uFFFF`). It also makes rustc always tell the user that escape may not be used in byte-strings and bytes and fixes some spans to not include unecessary characters and include escape backslash in some others.

Add comments.

Auto merge of #26750 - nrc:refactor-submod, r=sfackler

This makes the functionality usable from outside the parser

Move rounding discussion to integer Div/Rem impls

Don't ICE when missing owned_box lang item

Closes #20549

Update my email address.

Auto merge of #26958 - alexcrichton:down-with-thread-dtors, r=brson

TLS tests have been deadlocking on the OSX bots for quite some time now and this
commit is the result of the investigation into what's going on. It turns out
that a value in TLS which is being destroyed (e.g. the destructor is run) can be
reset back to the initial state **while the destructor is running** if TLS is
re-accessed.

To fix this we stop calling drop_in_place on OSX and instead move the data to a
temporary location on the stack.

Tell unicode escapes can’t be used as bytes earlier/more

syntax: Allow semi tokens after macro ty/path

This commit expands the follow set of the `ty` and `path` macro fragments to
include the semicolon token as well. A semicolon is already allowed after these
tokens, so it's currently a little too restrictive to not have a semicolon
allowed. For example:

    extern {
        fn foo() -> i32; // semicolon after type
    }

    fn main() {
        struct Foo;

        Foo; // semicolon after path
    }

Update boxed.rs

Reverse PR `#26944 `, symbol `#` are actually as intended.

std: Fix a TLS destructor bug on OSX

TLS tests have been deadlocking on the OSX bots for quite some time now and this
commit is the result of the investigation into what's going on. It turns out
that a value in TLS which is being destroyed (e.g. the destructor is run) can be
reset back to the initial state **while the destructor is running** if TLS is
re-accessed.

To fix this we stop calling drop_in_place on OSX and instead move the data to a
temporary location on the stack.

Auto merge of #26957 - wesleywiser:rename_connect_to_join, r=alexcrichton

Fixes #26900

Auto merge of #26895 - jroesch:modernize-typeck-names, r=nikomatsakis

This PR modernizes some names in the type checker. The only remaining snake_case name in ty.rs is `ctxt` which should be resolved by @eddyb's pending refactor. We can bike shed over the names, it would just be nice to bring the type checker inline with modern Rust.

r? @eddyb

cc @nikomatsakis

debuginfo: Instruct MSVC linker to generate PDB file if debuginfo is enabled

Clean up trailing whitespaces

Fix multi-threading example in dining-philosophers

Auto merge of #26966 - nagisa:tail-init, r=alexcrichton

Fixes #26906

Auto merge of #26965 - bluss:cstring-debug, r=alexcrichton

Use escaped byte string representation for CString Debug

Faithfully represent the contents of the CString and CStr in their Debug
impl, by treating them as byte strings with our default escaping to
ascii representation.

Add impl Debug for CStr.

Fixes #26964.

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

- Successful merges: #26881, #26967, #26973, #26974, #26976, #26979
- Failed merges:

Rollup merge of #26979 - tshepang:trim, r=Gankro

- It is clear that what follows are re-exports
- There aren't so many re-exports that examples should be given

Rollup merge of #26976 - tshepang:more-simple-explanation, r=gankro

That sentence make me read it a few times before properly understanding it

Rollup merge of #26974 - tshepang:trailing-comma, r=Gankro

Rollup merge of #26973 - tshepang:repetition, r=Gankro

Rollup merge of #26967 - tsurai:master, r=steveklabnik

The very first code fragment off every struct and trait documentation page generates wrong playground code. This pull request adjusts ```playpen.js``` to only create a link for real examples.

Documentation:
```rust
pub struct String {
    // some fields omitted
}
```

Playground:
```rust
Struct std::String

                [−]

        [src]
```

r? @steveklabnik

Rollup merge of #26881 - andreastt:international_keyboard, r=alexcrichton

Avoids some code duplication and relies less on deprecated properties on `KeyboardEvent`.  The code is still looking quite bad, but that’s primarily because interop in this area is a disaster zone.

Auto merge of #26931 - reem:string-conversions, r=alexcrichton

Implements merged RFC 1152.

Closes #26697.

Skip diagnostic codes occurring inside a long diagnostic in errorck.

Auto merge of #26972 - jethrogb:patch-1, r=alexcrichton

The File object needs to be writable for the set_len to succeed.

Add String::into_boxed_slice and Box<str>::into_string

Implements merged RFC 1152.

Closes #26697.

Auto merge of #26959 - dhuseby:i686-unknown-freebsd, r=alexcrichton

this adds support for i686-unknown-freebsd target.

Correct and clarify integer division rounding docs

Auto merge of #26913 - sfackler:tuple-debug, r=alexcrichton

This does change the Debug output for 1-tuples to `(foo)` instead of `(foo,)` but I don't think it's that big  of a deal.

r? @alexcrichton

doc: remove redundant info

- It is clear that what follows are re-exports
- There aren't so many re-exports that examples should be given

Auto merge of #26882 - andreastt:style_improvements, r=alexcrichton

Sharpens the help dialogues edges by removing border-padding, which
matches better with the rest of the document.

Also increases somewhat the rounded edges of the key symbols to
make it clear they are symbols.

Also introduces closing apostrophes and ellipsis for search field
placeholder.

Implement RFC 1058