rollup merge of #24665: sw17ch/document-complete-slice-syntax

The documentation doesn't appear to describe the `&foo[..]` syntax.

I tried looking in `primitive-types.html#slices` and `std/primitive.slice.html`.

There's an example of partially slicing an array in trpl and a mention of `&foo[..]` in [the standard library documentation](https://doc.rust-lang.org/std/primitive.slice.html), but neither place, from what I can see, actually describes the behavior of `&foo[..]`.

+r? @steveklabnik

rollup merge of #24663: steveklabnik/gh24639

Fixes #24639

rollup merge of #24661: SimonSapin/fmt-write-char

as accepted in [RFC 526](https://github.com/rust-lang/rfcs/blob/master/text/0526-fmt-text-writer.md).

Note that this brand new method is marked as **stable**. I judged this safe enough: it’s simple enough that it’s very unlikely to change. Still, I can mark it unstable instead if you prefer.

r? @alexcrichton

rollup merge of #24654: mdinger/patch-2

This just fixes some comments made on https://github.com/rust-lang/rust/pull/24632 . The second I think is better unless @steveklabnik actually meant something else.

rollup merge of #24651: tamird/old-references

r? @alexcrichton

rollup merge of #24640: steveklabnik/new_unsafe_guide

https://github.com/rust-lang/rust/pull/24631 is related, as it will delete this from the TOC, but I want to keep it here.

rollup merge of #24635: tamird/llvm-3.5

r? @alexcrichton

rollup merge of #24611: doomsplayer/doomsplayer-patch-1

as dependency for #24594

rollup merge of #24563: kwantam/rfc_1054

For now, words() is left in (but deprecated), and Words is a type alias for
struct SplitWhitespace.

Also cleaned up references to str.words() throughout codebase.

Closes #15628

rollup merge of #24487: erickt/syntax

This removes the usage of `#[feature(into_cow, slice_patterns, box_syntax, box_patterns, quote, unsafe_destructor)]` from being used in libsyntax. My main desire for this is that it brings me one step closer to letting [syntex](https://github.com/erickt/rust-syntex) compile with stable rust. Hopefully this doesn't inconvenience rust development.

rollup merge of #24439: alexcrichton/fix-archive-assembler

When linking an archive statically to an rlib, the compiler will extract all
contents of the archive and add them all to the rlib being generated. The
current method of extraction is to run `ar x`, dumping all files into a
temporary directory. Object archives, however, are allowed to have multiple
entries with the same file name, so there is no method for them to extract their
contents into a directory in a lossless fashion.

This commit adds iterator support to the `ArchiveRO` structure which hooks into
LLVM's support for reading object archives. This iterator is then used to
inspect each object in turn and extract it to a unique location for later
assembly.

rollup merge of #24222: lambda/rename-soft-link-to-symlink

Implement [RFC #1048][rfc].

On Windows, when you create a symbolic link you must specify whether it
points to a directory or a file, even if it is created dangling, while
on Unix, the same symbolic link could point to a directory, a file, or
nothing at all.  Furthermore, on Windows special privilege is necessary
to use a symbolic link, while on Unix, you can generally create a
symbolic link in any directory you have write privileges to.

This means that it is unlikely to be able to use symbolic links purely
portably; anyone who uses them will need to think about the cross
platform implications.  This means that using platform-specific APIs
will make it easier to see where code will need to differ between the
platforms, rather than trying to provide some kind of compatibility
wrapper.

Furthermore, `soft_link` has no precedence in any other API, so to avoid
confusion, move back to the more standard `symlink` terminology.

Create a `std::os::unix::symlink` for the Unix version that is
destination type agnostic, as well as `std::os::windows::{symlink_file,
symlink_dir}` for Windows.

Because this is a stable API, leave a compatibility wrapper in
`std::fs::soft_link`, which calls `symlink` on Unix and `symlink_file`
on Windows, preserving the existing behavior of `soft_link`.

[rfc]: https://github.com/rust-lang/rfcs/pull/1048

rollup merge of #24162: pnkfelix/fsk-detect-duplicate-loop-labels

Check for duplicate loop labels in function bodies.

See also: http://internals.rust-lang.org/t/psa-rejecting-duplicate-loop-labels/1833

The change, which we are putting in as future-proofing in preparation for future potential additions to the language (namely labeling arbitrary blocks and using those labels in borrow expressions), means that code like this will start emitting warnings:

```rust
fn main() {
    { 'a: loop { break; } }
    { 'a: loop { break; } }
}
```

To make the above code compile without warnings, write this instead:

```rust
fn main() {
    { 'a: loop { break; } }
    { 'b: loop { break; } }
}
```

Since this change is only introducing a new warnings, this change is non-breaking.

Fix #21633

Document functional update syntax

Fixes #24639

implement rfc 1054: split_whitespace() fn, deprecate words()

For now, words() is left in (but deprecated), and Words is a type alias for
struct SplitWhitespace.

Also cleaned up references to s.words() throughout codebase.

Closes #15628

unstabilize Words struct

Words struct was stabilied by mistake. Unstabilize.

rustc: Handle duplicate names merging archives

When linking an archive statically to an rlib, the compiler will extract all
contents of the archive and add them all to the rlib being generated. The
current method of extraction is to run `ar x`, dumping all files into a
temporary directory. Object archives, however, are allowed to have multiple
entries with the same file name, so there is no method for them to extract their
contents into a directory in a lossless fashion.

This commit adds iterator support to the `ArchiveRO` structure which hooks into
LLVM's support for reading object archives. This iterator is then used to
inspect each object in turn and extract it to a unique location for later
assembly.

syntax: Copy unstable str::char_at into libsyntax

syntax: Change ExpnId::{from,to}_llvm_cookie to {from,to}_u32

syntax: Remove #[feature(path_ext)]

Replace Path::exists with stable metadata call.

syntax: replace Vec::push_all with stable Vec::extend

syntax: Replace Vec::map_in_place with stable mut iterator

syntax: Replace [].tail with the stable [1..] syntax

syntax: Replace String::from_str with the stable String::from

syntax: remove #[feature(quote, unsafe_destructor)]

syntax: Don't use unstable fn to convert single element to a slice

syntax: Remove use of TraitObject in pretty printer

syntax: remove uses of `.into_cow()`

syntax: Remove uses of #[feature(slice_patterns)]

syntax: remove #![feature(box_syntax, box_patterns)]

Add an example of completely slicing an object.

Pick a feature name for write_char

Deprecate std::fs::soft_link in favor of platform-specific versions

On Windows, when you create a symbolic link you must specify whether it
points to a directory or a file, even if it is created dangling, while
on Unix, the same symbolic link could point to a directory, a file, or
nothing at all.  Furthermore, on Windows special privilege is necessary
to use a symbolic link, while on Unix, you can generally create a
symbolic link in any directory you have write privileges to.

This means that it is unlikely to be able to use symbolic links purely
portably; anyone who uses them will need to think about the cross
platform implications.  This means that using platform-specific APIs
will make it easier to see where code will need to differ between the
platforms, rather than trying to provide some kind of compatibility
wrapper.

Furthermore, `soft_link` has no precedence in any other API, so to avoid
confusion, move back to the more standard `symlink` terminology.

Create a `std::os::unix::symlink` for the Unix version that is
destination type agnostic, as well as `std::os::windows::{symlink_file,
symlink_dir}` for Windows.

Because this is a stable API, leave a compatibility wrapper in
`std::fs::soft_link`, which calls `symlink` on Unix and `symlink_file`
on Windows, preserving the existing behavior of `soft_link`.

add notes clarifying introduction of warnings for a pair of run-pass tests.

Tests for shadowing between lifetimes and loop labels within function bodies.

Check for shadowing between lifetimes and loop labels in function bodies.

Note: this Warns rather than error on shadowing problems involving labels.
We took this more conservative option mostly due to issues with
hygiene being broken for labels and/or lifetimes.

Add FIXME regarding non-hygienic comparison.

write_char is unlikely to make it for 1.0, it’ll be 1.1

Remove references to `old_{path,io}`

Remove dead test

This was moved to https://github.com/rust-lang/term/issues/12

Remove unused files

Looks like these were missed in bf4e77d.

add TCP_* consts for linux

Auto merge of #24620 - pczarn:model-lexer-issues, r=cmr

Fixes #15679
Fixes #15878
Fixes #15882
Closes #15883

LLVM < 3.5 is unsupported since bb18a3c

Add a `write_char` method to `std::fmt::Write`

as accepted in [RFC 526](https://github.com/rust-lang/rfcs/blob/master/text/0526-fmt-text-writer.md).

Refocus unsafe code chapter on unsafe itself.

Auto merge of #24598 - lfairy:impl-debug-for-file, r=alexcrichton

This patch adds a `Debug` impl for `std::fs::File`.

On all platforms (Unix and Windows) it shows the file descriptor.

On Linux, it displays the path and access mode as well.

Ideally we should show the path/mode for all platforms, not just Linux,
but this will do for now.

cc #24570

Model lexer: Fix remaining issues

Auto merge of #24646 - brson:stab, r=alexcrichton

Implement Debug for File

This patch adds a `Debug` impl for `std::fs::File`.

On all platforms (Unix and Windows) it shows the file descriptor.

On Linux, it displays the path and access mode as well.

Ideally we should show the path/mode for all platforms, not just Linux,
but this will do for now.

cc #24570

Fix typos

Auto merge of #24648 - steveklabnik:rollup, r=steveklabnik

- Successful merges: #24514, #24516, #24571, #24577, #24625, #24627, #24628, #24629, #24630, #24631, #24632, #24642, #24643, #24647
- Failed merges: #24640

Refocus unsafe code chapter on unsafe itself.

Rollup merge of #24647 - mbrubeck:doc-edit, r=steveklabnik

None

Rollup merge of #24643 - steveklabnik:doc_if_let, r=jakub-

and while let

Rollup merge of #24642 - tshepang:why-be-negative, r=huonw

Rollup merge of #24632 - steveklabnik:casting_guide, r=alexcrichton

Due to documenting `transmute`, addresses part of #12905

Rollup merge of #24631 - steveklabnik:unsafe_guide, r=alexcrichton

Many unsafe features are now in the unstable section, so this section is
really just about raw pointers now. That also makes sense for its place
in the TOC.

This addresses part of #12905.

Rollup merge of #24630 - steveklabnik:quickfix, r=alexcrichton

Rollup merge of #24629 - steveklabnik:gh24511, r=alexcrichton

Without the `box` keyword, one of these two reasons is not correct, so
let's just eliminate this section and elaborate on the reason for the
legit use case inline.

Fixes #24511

Rollup merge of #24628 - steveklabnik:gh24173, r=alexcrichton

Fixes #24173

These docs could all use examples, so for now, let's just remove the bad one, and when I go over this whole module I'll put in better ones.

Rollup merge of #24627 - steveklabnik:gh24008, r=alexcrichton

Fixes #24008.

Rollup merge of #24625 - frewsxcv:patch-16, r=steveklabnik

As far as I can tell, this conversion to integer to floating point does not need to happen and is beside the point

Rollup merge of #24577 - steveklabnik:gh24573, r=alexcrichton

Fixes #24573

Rollup merge of #24571 - steveklabnik:editing, r=alexcrichton

A bunch of chapters, fixes an issue or two as well.

r? @alexcrichton

Rollup merge of #24516 - steveklabnik:gh22621, r=alexcrichton

Fixes #22621

Rollup merge of #24514 - krzysz00:no-warnings-in-liballoc, r=alexcrichton

When `liballoc` is compiled with `--cfg feature=\"external_features\"`, several `improper_ctypes` warnings are generated. Since these warnings are harmless, I have added a directive to suppress them.

Update reference to old_io in fmt docs

Make stability attributes an error. #22830

TRPL: if let

and while let

lint: explain the non-obvious need for a negative test

Auto merge of #24606 - bombless:doc-result, r=alexcrichton

Get rid of the confusion that what does "custom" mean in this context.

Add common macros to TRPL

Fixes #22621

TRPL: unsafe -> raw pointers

Many unsafe features are now in the unstable section, so this section is
really just about raw pointers now. That also makes sense for its place
in the TOC.

This addresses part of #12905.

Remove feature gated examples from the reference.

The slice patterns example was nice, so let's put it with the other
slice pattern feature gate documentation.

Fixes #24573

TRPL: casting

Due to documenting `transmute`, addresses part of #12905

Auto merge of #24597 - bombless:doc, r=steveklabnik

This patch will make links like http://doc.rust-lang.org/std/collections/struct.BTreeMap.html#examples actually playable without modifying the code.

It seems that this patch cannot be tested on test/rustdoc.

And I suggest adding a `&run=1` to those links.

Thank @jorisgio for noticing me this!

r? @steveklabnik

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

Fix small typo in TRPL intro

Clean up Box documentation.

Without the `box` keyword, one of these two reasons is not correct, so
let's just eliminate this section and elaborate on the reason for the
legit use case inline.

Fixes #24511

remove bad example from PartialEq docs

Fixes #24173

Make iterator struct docs more consistent.

Fixes #24008.

TRPL edits: generics

Remove inverse example from generics part of TRPL

Fixes #24325.

TRPL edits: traits

Let's talk about generics first, since we use traits to bound them
in funtions.

Partially addresses #24325

Fixes #24271

move Deref coercions to syntax and semantics

It's a language feature, so it belongs here.

TRPL copyedits: strings

TRPL editing: vectors

Move drop back in TRPL TOC

It's a trait implementation, so we need traits first.

TRPL edits: method syntax

TRPL editing: structs

TRPL editing: move patterns back

We want to talk about how to pattern match on structs, so let's bump
it back one.

TRPL editing: patterns

Partially addresses #24388

TRPL editing: match

TRPL editing: enums

Now that we're not doing the guessing game, a lot of this is irrelevant.

Auto merge of #22117 - fhahn:fail-on-errors, r=nikomatsakis

At the moment, when compilation is stopped at a stop point (like `-Z parse-only`), `rustc` does not return an nonzero exit code even if there are errors (expect fatal ones, that cause it to panic immediately). As an example, compiling `src/test/compile-fail/doc-before-semi.rs` with `-Z parse-only` raises an error, but exists with 0.

Note that I could not use `sess.abort_if_errors()` in the macro, because `sess` is passed by value and move at some point.

Simplify alloc::arc::Arc example in doc-comment

As far as I can tell, this conversion to integer to floating point does not need to happen and is beside the point

Auto merge of #24525 - GuillaumeGomez:check-const, r=pnkfelix

Part of #24407.

Fix typos

Auto merge of #24608 - frewsxcv:patch-15, r=alexcrichton

Improve doc for `Result::unwrap()`

Auto merge of #24586 - richo:test-16745, r=jakub-

closes #16745