rust/tests/rustdoc/blank-line-in-doc-block-47197.rs

// https://github.com/rust-lang/rust/issues/47197
#![crate_name="foo"]

// @has foo/fn.whose_woods_these_are_i_think_i_know.html

/**
* snow

* ice
*/
pub fn whose_woods_these_are_i_think_i_know() {}
Add `crate_name` and URL to test cases 2024-01-03 15:56:10 -06:00			`// https://github.com/rust-lang/rust/issues/47197`
			`#![crate_name="foo"]`

			`// @has foo/fn.whose_woods_these_are_i_think_i_know.html`
wherein careful doc-decoration arithmetic proves quite the ICE-breaker This `horizontal_trim` function strips the leading whitespace from doc-comments that have a left-asterisk-margin: /** * You know what I mean— * * comments like this! */ The index of the column of asterisks is `i`, and if trimming is deemed possible, we slice each line from `i+1` to the end of the line. But if, in particular, `i` was 0 _and_ there was an empty line (as in the example given in the reporting issue), we ended up panicking trying to slice an empty string from 0+1 (== 1). Let's tighten our check to say that we can't trim when `i` is even the same as the length of the line, not just when it's greater. (Any such cases would panic trying to slice `line` from `line.len()+1`.) Resolves #47197. 2018-01-05 01:09:02 -06:00
			`/**`
			`* snow`

			`* ice`
			`*/`
			`pub fn whose_woods_these_are_i_think_i_know() {}`