Realloc is a bit confusing

[alexevier]

Location

https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html#method.realloc

Summary

Realloc (in the trait for GlobalAlloc) is confusing in my opinion, what means the new_size parameter?
The size in bytes or how many times the size that is inside the layout?
In the way it is written seems to mean the bytes but it should be explicit that it means the size in bytes.

[workingjubilee]

Thank you! I added a clarification to the docs (it is in bytes).

[alexevier]

thank you, for taking to look into this