rustdoc: Fix and improve line break hints with the <wbr> tag

Prevents zero-width spaces from appearing in copy-pasted paths.

Puts line breaks after `::`.

Fixes #16555