Improve documentation of PlasmaExtras.Highlight

Backport stuff from https://invent.kde.org/frameworks/plasma-framework/-/merge_requests/418

Other than the doc changes this also fix the hovered property that is always true

@apol