update tooltip docs
Fixes #11833: add warning to docs for popover multiple line positioning; update it's docs with example markup, too