doc: further explain fill/fill!

backport of 52598ff0103d089282a6a49c2d5dc6d3f2ebff5c