Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

document new --show-output option in ch 11-2 (Rust >= 1.39) #2065

Merged
merged 1 commit into from
Dec 16, 2019

Conversation

emmericp
Copy link
Contributor

Don't merge before 1.39 is released, available in nightly rust 08-28 or later.

See rust-lang/rust#62600

--show-output is available in rust 1.39 or later
If we want to see printed values for passing tests as well, we can disable the
output capture behavior by using the `--nocapture` flag:
If we want to see printed values for passing tests as well, we can tell Rust
to also show the output of successful tests at the end with `--show-output`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like this should still document --nocapture since that remains a useful option.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, I don't think anyone should still use --nocapture.

At least the only case I can think of is if your test output is gigantic (as in larger than ram?) where buffering it would be a problem. And that's clearly not a good situation to be in the first place

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We're okay with not covering every possible option in the book, so I agree that we should just leave it out.

@Mark-Simulacrum
Copy link
Member

Do we not show the stderr with --show-output? Is that the primary distinction to --nocapture, as well as not interleaving output?

@emmericp
Copy link
Contributor Author

it also shows stderr, it works just like the output capturing for failed tests but for successful tests

Copy link
Member

@steveklabnik steveklabnik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for this! Can't merge till after the release, but looks good to me.

If we want to see printed values for passing tests as well, we can disable the
output capture behavior by using the `--nocapture` flag:
If we want to see printed values for passing tests as well, we can tell Rust
to also show the output of successful tests at the end with `--show-output`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We're okay with not covering every possible option in the book, so I agree that we should just leave it out.

@steveklabnik steveklabnik merged commit 5c5cfd2 into rust-lang:master Dec 16, 2019
@steveklabnik
Copy link
Member

Thank you!

JohnTitor added a commit to JohnTitor/rust that referenced this pull request Jan 7, 2020
Update books

## nomicon

1 commits in 8be35b201f9cf0a4c3fcc96c83ac21671dcf3112..3e6e1001dc6e095dbd5c88005e80969f60e384e1
2019-12-01 13:02:12 -0500 to 2019-12-14 22:08:52 +0000
- Remove mention of contravariance possibly getting scrapped (rust-lang/nomicon#177)

## reference

4 commits in d8dfe1b..e115753
2019-12-14 21:04:58 +0100 to 2019-12-22 13:13:14 +0100
- Fix typo in macros-by-example.md (rust-lang/reference#733)
- Remove `extern` from exception list (rust-lang/reference#732)
- Added clearification that closures are refered to lambdas (rust-lang/reference#731)
- abi.md: clarify #[used] and linking (rust-lang/reference#712)

## book

2 commits in ef8bb568035ded8ddfa30a9309026638cc3c8136..5c5cfd2e94cd42632798d9bd3d1116133e128ac9
2019-11-28 11:00:04 -0600 to 2019-12-16 09:27:21 -0600
- document new --show-output option in ch 11-2 (Rust >= 1.39) (rust-lang/book#2065)
- Fix sentence in ch07 (rust-lang/book#2183)

## rust-by-example

3 commits in b7ac1bc76b7d02a43c83b3a931d226f708aa1ff4..1d59403cb5269c190cc52a95584ecc280345495a
2019-12-02 11:38:43 -0300 to 2019-12-27 08:27:05 -0300
- Enable section-folding of table of content (rust-lang/rust-by-example#1290)
- Remove unnecessary lifetime annotation (rust-lang/rust-by-example#1300)
- eliminate the warnings (rust-lang/rust-by-example#1301)

## edition-guide

1 commits in 6601cab4666596494a569f94aa63b7b3230e9769..1a2390247ad6d08160e0dd74f40a01a9578659c2
2019-11-22 12:08:58 -0500 to 2019-12-29 10:40:55 -0800
- Updated install and uninstall instructions (rust-lang/edition-guide#194)

## embedded-book

1 commits in c26234930282210849256e4ecab925f0f2daf3be..9493b7d4dc97eda439bd8780f05ad7b234cd1cd7
2019-12-07 17:25:11 +0000 to 2019-12-27 20:05:00 +0000
- fixed typo in Interrupts.md  (rust-embedded/book#218)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants