How to document an @IBInspectable property in Xcode
Unfortunately it looks like you can not prepare a text to be presented by such a tool tip. At least for now.
I even noticed that if you do not explicitly put a type (but assign default value instead) for that designable, the filed is not generated in attribute inspector.