r? @alexcrichton

(rust_highfive has picked a reviewer for you, use r? to override)

CC @niconii

@bors: r+ rollup

📌 Commit 025bf95 has been approved by alexcrichton

The description seems overly contrived to me. I had to reread it multiple times and look at the issue to understand what the paragraph is getting at.

@nagisa Mh. :/

I know this is just a single sentence but can you pinpoint why or what part caused you to reread that sentence multiple times?

@tbu- I also think there are a few ways the wording could be improved.

• Saying "it does not immediately drop the contents of src" seems potentially confusing, since "it" here means "ptr::write", making it sound like ptr::write itself could drop src at some later point.

• Talking about "the contents of src" to parallel "the contents of dst" is also not great given dst is a pointer whereas src is a value passed directly into the function.

• The thing being referred to by "it" changes from "ptr::write" to "the contents of src" somewhat abruptly.

Personally, I would reword it like this:

In addition, it does not drop src. Semantically, src is moved into the location pointed to by dst.