libupower-glib: gtk-doc fixes

Submitted by Guido Guenther

Assigned to Richard Hughes @hughsient

Link to original bug (#106711)

Description

Three tiny patches to make the generated docs more useful.