Add a comment

diff --git a/company.el b/company.el
index 9a0c72ad3d42850cef165824cea60283797a4da9..b444493c48d1390772e69b2ed205d8d1a071f9f4 100644 (file)
--- a/company.el
+++ b/company.el
@@ -2456,6 +2456,8 @@ Returns a negative number if the tooltip should be displayed above point."
       (overlay-put ov 'line-prefix "")
       (if (/= (overlay-start ov) (overlay-end ov))
           (overlay-put ov 'display disp)
+        ;; `display' is usually better (http://debbugs.gnu.org/18285),
+        ;; but it doesn't work when the overlay is empty.
         (overlay-put ov 'after-string disp))
       (overlay-put ov 'window (selected-window)))))