[nongnu] elpa/annotate 50ac6fb2fe 06/17: - explained why we need too hook into 'window-configuration-change-hook'

[ELPA Syncer]

branch: elpa/annotate
commit 50ac6fb2fe1f055a57362cefd449f03493217d9d
Author: cage <cage@invalid>
Commit: cage <cage@invalid>

    - explained why we need too hook into 'window-configuration-change-hook'
      and 'annotate-blacklist-major-mode'.
---
 annotate.el | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/annotate.el b/annotate.el
index 8d4ab6a3f1..a5867f7624 100644
--- a/annotate.el
+++ b/annotate.el
@@ -131,9 +131,11 @@ that Emacs passes to the diff program."
   :type 'string)
 
 (defcustom annotate-blacklist-major-mode '()
-  ;; FIXME: When/why would this be needed?
-  "Prevent loading of annotate-mode When the visited file's
-major mode is a member of this list (space separated entries)."
+ "Prevent loading of annotate-mode When the visited file's major
+mode is a member of this list (space separated entries). This
+could be useful if some mode does not work well with annotate as
+this ensure that it will be never loaded, see
+`annotate-initialize-maybe'."
   :type  '(repeat symbol))
 
 (defcustom annotate-summary-ask-query t
@@ -435,7 +437,9 @@ modified (for example a newline is inserted)."
   "Load annotations and set up save and display hooks."
   (annotate-load-annotations)
   (add-hook 'after-save-hook                  #'annotate-save-annotations t t)
-  (add-hook 'window-configuration-change-hook #'font-lock-flush  t t) ;FIXME: 
Why?
+  ;; This hook  is needed to  reorganize the layout of  the annotation
+  ;; text when a window vertically resized
+  (add-hook 'window-configuration-change-hook #'font-lock-flush  t t)
   (add-hook 'before-change-functions          #'annotate-before-change-fn t t)
   (add-hook 'Info-selection-hook              #'annotate-info-select-fn   t t)
   (if annotate-use-echo-area