Merge topic 'update-docs'

d2444015 docs: make `Return value: New reference.` explicit.

Acked-by: Kitware Robot <kwrobot@kitware.com>
Acked-by: David Gobbi <david.gobbi@gmail.com>
Merge-request: !4290