Rollup merge of #40512 - nodakai:patch-1, r=alexcrichton

.gitmodules: use official URLs w/o redirect

Rollup merge of #40505 - frewsxcv:hash-docs, r=alexcrichton

A few improvements to the `core::hash` top-level docs.

Primarily opened to address the concerns brought up in
https://github.com/rust-lang/rust/issues/40498.

* run rustfmt on code blocks
* use `DefaultHasher` instead of deprecated `SipHasher`
* rename `hash` to `calculate_hash` to prevent confusion with the `hash`
  method

Rollup merge of #40503 - swgillespie:thread-hack-removal, r=sfackler

std: remove a workaround for privacy limitations

`std::thread::Thread` implements a non-exported `NewThread` trait to allow for internal-only use of `Thread::new`. Nowadays we have `pub(crate)`, which accomplishes the same thing but much more idiomatically.

Rustdoc handles this correctly (I checked and I didn't see `Thread::new` on the rustdoc entry for `Thread` with this change), and the stage1 `rustc` emits the correct error still (I'm assuming that the stage1 compiler uses my `libstd`?):

```
$ ./build/x86_64-apple-darwin/stage1/bin/rustc test.rs
error: method `new` is private
 --> test.rs:4:18
  |
4 |     let thread = thread::Thread::new(None);
  |                  ^^^^^^^^^^^^^^^^^^^

error: aborting due to previous error
```

Rollup merge of #40500 - estebank:turbofish-help, r=pnkfelix

Point out correct turbofish usage on `Foo<Bar<Baz>>`

Whenever we parse a chain of binary operations, as long as the first
operation is `<` and the subsequent operations are either `>` or `<`,
present the following diagnostic help:

    use `::<...>` instead of `<...>` if you meant to specify type arguments

This will lead to spurious recommendations on situations like
`2 < 3 < 4` but should be clear from context that the help doesn't apply
in that case.

Fixes #40396.

Rollup merge of #40499 - ericfindlay:master, r=steveklabnik

Corrected very minor documentation detail about Unicode and Japanese

Japanese half-width and full-width romaji characters do have upper and lowercase according Unicode (but other Japanese characters do not). For example,
` assert_eq!('\u{FF21}'.to_lowercase().collect::<String>(),"\u{FF41}");`

r? @steveklabnik

Rollup merge of #40497 - wesleywiser:fix_sidebar, r=GuillaumeGomez

Fix sidebar not extending to the bottom of the page

Fixes #40459

Rollup merge of #40496 - projektir:docs_number_headings, r=frewsxcv

Using X headings #39850

Fix for issue #39850, the headings should now be 1, 2, and 3.

Rollup merge of #40495 - llogiq:format-docs, r=steveklabnik

fix format grammar

This is just a trivial change to get the escaped squigglies into the grammar.

r? @steveklabnik

Rollup merge of #40467 - projektir:readme_docs, r=steveklabnik

Updating README.md to point to the correct doc location

Rollup merge of #40466 - projektir:outdated_docs_highlighting, r=steveklabnik

Remove doc about highlighting code in other languages #40301

This doesn't appear to be true any longer, so removing it to avoid confusion. See #40301

Thoughts:
- may be a good idea to remove "Let's discuss the details of these code blocks.", as there's not much being discussed at this point;
- does `text` still work?

r? @steveklabnik

Rollup merge of #40463 - tshepang:nit, r=nikomatsakis

some style fixes

Rollup merge of #40458 - frewsxcv:frewsxcv-osstr, r=GuillaumeGomez

Add doc examples for `OsStr`, `OsString`.

None

Rollup merge of #40457 - frewsxcv:frewsxcv-macos, r=steveklabnik

Update usages of 'OSX' (and other old names) to 'macOS'.

As of last year with version 'Sierra', the Mac operating system is now
called 'macOS'.

Rollup merge of #40456 - frewsxcv:frewsxcv-docs-function-parens, r=GuillaumeGomez

Remove function invokation parens from documentation links.

This was never established as a convention we should follow in the 'More
API Documentation Conventions' RFC:

https://github.com/rust-lang/rfcs/blob/master/text/1574-more-api-documentation-conventions.md

Rollup merge of #40452 - frewsxcv:frewsxcv-unstable-docs, r=GuillaumeGomez

Add basic documentation/examples for six unstable features.

Rollup merge of #40433 - mattico:test-issue-29595, r=estebank

Add test for issue #29595

Closes #29595

Couldn't get this to run locally, all the compile-fail tests are ignored... let's see what Travis says.

Rollup merge of #40387 - tbu-:pr_doc_ptr_write2, r=steveklabnik

Reword the non-dropping of `src` for `ptr::write{,_unaligned}`

@niconii Is it OK if I put your wording into the documentation?
CC @nagisa

Auto merge of #40526 - brson:docs-req, r=alexcrichton

Make docs required again

Completely untested. Fixes https://github.com/rust-lang-nursery/rustup.rs/issues/903

r? @alexcrichton cc @steveklabnik

Merge branch 'master' into frewsxcv-osstr

Auto merge of #40383 - ishitatsuyuki:easy-dist-analysis, r=alexcrichton

rustbuild: Make save-analysis an option

This makes save-analysis an option independent from the release channel.

The CI build scripts have been modified to enable the flag.

*Merge with caution.* I haven't tested this, and this can cause nightly breakage.

Auto merge of #40212 - SimonSapin:utf8error-resume-from, r=aturon

Add Utf8Error::error_len, to help incremental and/or lossy decoding.

Without this, code outside of the standard library needs to reimplement most of the logic `from_utf8` to interpret the bytes after `valid_up_to()`.

Auto merge of #40009 - clarcharr:box_to_buf, r=alexcrichton

Leftovers from #39594; From<Box> impls

These are a few more impls that follow the same reasoning as those from #39594.

What's included:
* `From<Box<str>> for String`
* `From<Box<[T]>> for Vec<T>`
* `From<Box<CStr>> for CString`
* `From<Box<OsStr>> for OsString`
* `From<Box<Path>> for PathBuf`
* `Into<Box<str>> for String`
* `Into<Box<[T]>> for Vec<T>`
* `Into<Box<CStr>> for CString`
* `Into<Box<OsStr>> for OsString`
* `Into<Box<Path>> for PathBuf`
* `<Box<CStr>>::into_c_string`
* `<Box<OsStr>>::into_os_string`
* `<Box<Path>>::into_path_buf`
* Tracking issue for latter three methods + three from previous PR.

Currently, the opposite direction isn't doable with `From` (only `Into`) because of the separation between `liballoc` and `libcollections`. I'm holding off on those for a later PR.

Ammended minor documentation detail abour Unicode cases.

Make docs required again

Point out correct turbofish usage on `Foo<Bar<Baz>>`

Whenever we parse a chain of binary operations, as long as the first
operation is `<` and the subsequent operations are either `>` or `<`,
present the following diagnostic help:

    use `::<...>` instead of `<...>` if you meant to specify type arguments

This will lead to spurious recommendations on situations like
`2 < 3 < 4` but should be clear from context that the help doesn't apply
in that case.

Add doc example for `OsString::into_boxed_os_str`.

Add doc example for `OsString::shrink_to_fit`.

Add doc example for `OsString::reserve_exact`.

Add doc example for `OsString::reserve`.

Add doc example for `OsStr::to_os_string`.

.gitmodules: use official URLs w/o redirect

Auto merge of #39921 - cramertj:add-catch-to-ast, r=nikomatsakis

Add catch {} to AST

Part of #39849. Builds on #39864.

Add tracking issue number for Utf8Error::error_len

Replace Utf8Error::resume_from with Utf8Error::error_len

Their relationship is:

* `resume_from = error_len.map(|l| l + valid_up_to)`
* error_len is always one of None, Some(1), Some(2), or Some(3).

When I started using resume_from I almost always ended up subtracting
valid_up_to to obtain error_len.
Therefore the latter is what should be provided in the first place.

Add Utf8Error::resume_from, to help incremental and/or lossy decoding.

Without this, code outside of the standard library needs to reimplement
most of the logic `from_utf8` to interpret the bytes after `valid_up_to()`.

Auto merge of #40488 - alexcrichton:appveyor-debug, r=brson

appveyor: Turn down sccache logging

Let's not have it be quite so verbose

A few improvements to the `core::hash` top-level docs.

Primarily opened to address the concerns brought up in
https://github.com/rust-lang/rust/issues/40498.

* run rustfmt on code blocks
* use `DefaultHasher` instead of deprecated `SipHasher`
* rename `hash` to `calculate_hash` to prevent confusion with the `hash`
  method

Remove function invokation parens from documentation links.

This was never established as a convention we should follow in the 'More
API Documentation Conventions' RFC:

https://github.com/rust-lang/rfcs/blob/master/text/1574-more-api-documentation-conventions.md

std: remove a workaround for privacy limitations that isn't necessary anymore

Rust unstable book: basic desc and example for `concat_idents`.

Rust unstable book: basic desc and example for `non_ascii_idents`.

Rust unstable book: basic desc and example for `i128_type`.

Rust unstable book: basic desc and example for `const_indexing`.

Rust unstable book: basic desc and example for `conservative_impl_trait`.

Rust unstable book: basic desc and example for `const_fn`.

Corrected very minor documentation detail about Unicode and Japanese

Fix sidebar not extending to the bottom of the page

Fixes #40459

Using X headings #39850

Add test for issue #29595

fix format grammar

Adjust wording #40301

appveyor: Turn down sccache logging

Let's not have it be quite so verbose

Auto merge of #40329 - petrochenkov:llreuse, r=alexcrichton

rustbuild: Add option for enabling partial LLVM rebuilds

@alexcrichton , you probably didn't notice my [late comment](https://github.com/rust-lang/rust/pull/40236#issuecomment-284160749) on https://github.com/rust-lang/rust/pull/40236, but here's an implementation of that suggestion, it supersedes https://github.com/rust-lang/rust/pull/40236/commits/c652a4fb566ac4bec1d62c66769dd055ad239df6.

r? @alexcrichton

Auto merge of #40451 - ollie27:rustdoc_impls_js_escape, r=GuillaumeGomez

rustdoc: Fix string escaping in implementors js files

The generated HTML can contain quotes so we need to make sure they are
escaped before inserting into the js files.

Auto merge of #40385 - arielb1:packed-again, r=eddyb

emit !align attributes on stores of operand pairs

This avoids another case of missing-align UB. cc #40373

r? @eddyb

emit !align attributes on stores of operand pairs

cc #40373

Auto merge of #40461 - stjepang:iterator-typo, r=frewsxcv

Fix a typo in Rev iterator docs

r? @GuillaumeGomez

Updating README.md to point to the correct doc location

Remove doc about highlighting code in other languages #40301

Auto merge of #40448 - ollie27:rustbuild_docs_compiler, r=alexcrichton

rustbuild: Fix compiler docs

* Make sure std docs are generated before compiler docs so rustdoc uses
relative links.
* Don't document the rustc and rustdoc binary crates as they overwrite
the real rustc and rustdoc crates.

Fixes #40217

r? @alexcrichton

some style fixes

Fix a typo in Rev docs

Auto merge of #40450 - alexcrichton:fix-cargo, r=alexcrichton

Update Cargo to fix nightly channel

This commit updates Cargo with rust-lang/cargo#3820 which includes a fix for
rust-lang/cargo#3819. At the same time this also slightly tweaks how rustbuild
builds cargo to ensure that all the build information (including git info and
such) makes its way into the binary.

Closes rust-lang/cargo#3819

Update usages of 'OSX' (and other old names) to 'macOS'.

As of last year with version 'Sierra', the Mac operating system is now
called 'macOS'.

Update Cargo to fix nightly channel

This commit updates Cargo with rust-lang/cargo#3820 which includes a fix for
rust-lang/cargo#3819. At the same time this also slightly tweaks how rustbuild
builds cargo to ensure that all the build information (including git info and
such) makes its way into the binary.

Closes rust-lang/cargo#3820

Auto merge of #40455 - frewsxcv:rollup, r=frewsxcv

Rollup of 5 pull requests

- Successful merges: #40369, #40390, #40426, #40449, #40453
- Failed merges:

Rollup merge of #40453 - tschottdorf:lint-deny-wording, r=alexcrichton

Improve wording in the -{W,A,F,D} options

This was so trivial that I'm wondering whether I'm missing something.

Fixes #28708.

Rollup merge of #40449 - ollie27:docs_proc_macro, r=alexcrichton

Add doc attributes to proc_macro crate

This adds the same logo and favicon as the rest of the std docs.

Rollup merge of #40426 - steveklabnik:update-mdbook, r=alexcrichton

Update mdbook to new version

This brings back playpen integration for the books.

It'd be nice to land this before beta, but realistically that's probably not going to happen...

Rollup merge of #40390 - F001:placementHashMap, r=nagisa

Implement placement-in protocol for `HashMap`

CC #30172

r? @nagisa

Rollup merge of #40369 - petrochenkov:segspan, r=eddyb

Give spans to individual path segments in AST

And use these spans in path resolution diagnostics.

The spans are spans of identifiers in segments, not whole segments. I'm not sure what spans are more useful in general, but identifier spans are a better fit for resolve errors.

HIR still doesn't have spans.

Fixes https://github.com/rust-lang/rust/pull/38927#discussion_r95336667 https://github.com/rust-lang/rust/pull/38890#issuecomment-271731008

r? @nrc @eddyb

Auto merge of #40340 - petrochenkov:restricted, r=nikomatsakis

Update syntax for `pub(restricted)`

Update the syntax before stabilization.

cc https://github.com/rust-lang/rust/issues/32409
r? @nikomatsakis

Allow cleaning llvm build dir to fail

It may not exist, so we don't want to spuriously generate an error.

Default llvm.clean-rebuild to false

rustbuild: Add option for enabling partial LLVM rebuilds

Improve wording in the -{W,A,F,D} options

Fixes #28708.

Auto merge of #40257 - pftbest:sret_msp430, r=alexcrichton

LLVM: Update submodule to include SRet support patch for MSP430.

This patch is needed to fix #38824 on MSP430.
I know that LLVM 4 is coming soon, but it would be great to have at least one working nightly before the update.

cc @awygle
r? @alexcrichton

Add compile-fail tests for catch expr in match or condition

Temporarily prefix catch block with do keyword

Add catch expr to AST and disallow catch as a struct name

Auto merge of #39770 - alexcrichton:configure-clean, r=brson

Delete more swaths of the configure script

This PR deletes more swaths of the `./configure` script which are either no longer necessary or already available in rustbuild (where an implementation is preferred)

rustdoc: Fix string escaping in implementors js files

The generates HTML can contain quotes so we need to make sure they are
escaped before inserting into the js files.

rustbuild: Fix tests

Use the same step names as the actual build.

Add doc attributes to proc_macro crate

This adds the same logo and favicon as the rest of the std docs.

Auto merge of #40446 - arielb1:rollup, r=alexcrichton

Rollup of 12 pull requests

- Successful merges: #40146, #40299, #40315, #40319, #40344, #40345, #40372, #40373, #40400, #40404, #40419, #40431
- Failed merges:

Merge branch 'more-sccache-debug' of https://github.com/alexcrichton/rust into rollup

rustbuild: Fix compiler docs

* Make sure std docs are generated before compiler docs so rustdoc uses
relative links.
* Don't document the rustc and rustdoc binary crates as they overwrite
the real rustc and rustdoc crates.

Auto merge of #40220 - jseyfried:ast_macro_def, r=nrc

syntax: add `ast::ItemKind::MacroDef`, simplify hygiene info

This PR
 - adds a new variant `MacroDef` to `ast::ItemKind` for `macro_rules!` and eventually `macro` items,
 - [breaking-change] forbids macro defs without a name (`macro_rules! { () => {} }` compiles today),
 - removes `ast::MacroDef`, and
 - no longer uses `Mark` and `Invocation` to identify and characterize macro definitions.
   - We used to apply (at least) two `Mark`s to an expanded identifier's `SyntaxContext` -- the definition mark(s) and the expansion mark(s). We now only apply the latter.

r? @nrc

Rollup merge of #40431 - fsasm:master, r=BurntSushi

rustc: Whitelist the FMA target feature

This commit adds the entry `"fma\0"` to the whitelist for the x86
target. LLVM already supports fma but rustc did not directly. Previously
rustc permitted `+fma` in the target-feature argument and enabled the use
of FMA instructions, but it did not list it in the configuration and
attributes.

fixes #40406

Rollup merge of #40419 - GuillaumeGomez:fix-const-rendering, r=frewsxcv

Fix associated consts display

Fixes #40370.

r? @frewsxcv

Rollup merge of #40404 - cengizIO:master, r=nikomatsakis

fix #40294 obligation cause.body_id is not always a NodeExpr

Hello!

This fixes #40294 and moves tests related to #38812 to a much more sensible directory.

Thanks to @nikomatsakis and @eddyb

Rollup merge of #40400 - TimNN:gdbr-updates, r=alexcrichton

Update gdbr tests

gdb will now reliably detect the lanugage as rust even before any code is run.

Rollup merge of #40373 - TimNN:test-ub-packed, r=arielb1

Fix UB in repr(packed) tests

r? @arielb1

cc #37609 and #27060

Rollup merge of #40372 - nagisa:never-drop, r=eddyb

Do not bother creating StorageLive for TyNever

Keeps MIR cleaner, `StorageLive(_: !)` makes no sense anyway.

r? @eddyb

Rollup merge of #40345 - Nashenas88:patch-1, r=estebank

Fix missing backtick typo

Fixes rendering of the end of the `Configure and Make` section.

Rollup merge of #40344 - nrc:save-container, r=eddyb

save-analysis: cope with lack of method data after a type error

Fixes #39957

r? @eddyb

Rollup merge of #40319 - eddyb:it's-"unsize"-not-"unsound", r=nikomatsakis

Disallow subtyping between T and U in T: Unsize<U>.

Because `&mut T` can be coerced to `&mut U`, `T` and `U` must be unified invariantly. Fixes #40288.
E.g. coercing `&mut [&'a X; N]` to `&mut [&'b X]` must require `'a` be equal to `'b`, otherwise you can convert between `&'a X` and `&'b X` (in either direction), potentially unsoundly lengthening lifetimes.

Subtyping here was introduced with `Unsize` in #24619 (landed in 1.1, original PR is #23785).

Rollup merge of #40315 - oli-obk:lint_body, r=eddyb

Allow lints to check Bodys directly

r? @eddyb

babysteps towards fixing https://github.com/Manishearth/rust-clippy/issues/1580 (disable certain lints in const environments, since they make no sense there (yet))

Rollup merge of #40299 - GuillaumeGomez:fmt-display-example, r=frewsxcv

Add missing example for Display::fmt

r? @frewsxcv

Rollup merge of #40146 - bjorn3:few-infer-changes, r=pnkfelix

Better docs of rusty parts of typeck