alloc: Document panics when allocations will exceed max

[leftmostcat]

Document panics in String and Vec due to capacity overflowing isize::MAX. Correct outdated claims of usize::MAX limit.

Fixes #148598.

Ping @lolbinarycat

[rustbot]

r? @joboet

rustbot has assigned @joboet.
They will have a look at your PR within the next two weeks and either review your PR or reassign to another reviewer.

Use r? to explicitly pick a reviewer

[leftmostcat]

At a glance, the build failures appear to be related to CI setup and not to these changes.

[lolbinarycat]

CI is currently broken, it should be fixed once #148665 is merged.

[joboet]

This is great, thank you!

View changes since this review

[joboet]

There isn't an old capacity here.

Suggested change

	/// Panics if the new capacity exceeds `isize::MAX` _bytes_.
	/// Panics if the capacity exceeds `isize::MAX` _bytes_.

[leftmostcat]

I do prefer the suggested wording. Presently, Vec uses the "new capacity" phrasing; should I adjust that as well?

[rustbot]

This PR was rebased onto a different main commit. Here's a range-diff highlighting what actually changed.

Rebasing is a normal part of keeping PRs up to date, so no action is needed—this note is just to help reviewers.