[nongnu] elpa/annotate a81a7d9386 209/372: - updated versions;

[ELPA Syncer]

branch: elpa/annotate
commit a81a7d9386661e1df7890ce2fd64395623adc204
Author: cage <cage-invalid@invalid>
Commit: cage <cage-invalid@invalid>

    - updated versions;
    - updated README, NEWS and Changelog files.
---
 Changelog   | 16 +++++++++++++++-
 NEWS.org    |  4 ++--
 README.org  | 12 ++++++++++++
 annotate.el |  6 +++---
 4 files changed, 32 insertions(+), 6 deletions(-)

diff --git a/Changelog b/Changelog
index 3387054310..9c195efaf6 100644
--- a/Changelog
+++ b/Changelog
@@ -27,7 +27,7 @@
         disappears).
 
 2020-02-10 Bastian Bechtold, cage
-       * annotate.el (annotate--font-lock-matcher annotate-bounds 
nnotate-symbol-strictly-at-point annotate-next-annotation-change 
annotate-previous-annotation-change annotate-clear-annotations 
annotate-annotate)
+       * annotate.el (annotate--font-lock-matcher annotate-bounds 
annotate-symbol-strictly-at-point annotate-next-annotation-change 
annotate-previous-annotation-change annotate-clear-annotations 
annotate-annotate)
        - prevented fails of fontification of annotated regions
        As we walk across the overlays we can get past the limit;
        - mark buffer as modified even if the only action the user performed
@@ -35,3 +35,17 @@
        the file)
        - prevented annotation of text marked with a region that overlap with
        an existing annotation.
+
+2020-03-06 Bastian Bechtold, cage ::
+       * annotate.el (annotate-annotation-force-newline-policy 
annotate-annotation-newline-policy-forced-p 
annotate-summary-delete-annotation-button-pressed annotate--annotation-builder)
+
+       - used  an heuristic  to force newline  policy when  the annotated
+       text  does  not  uses a  standard  fonts  (using  font  height  as
+       comparison);
+
+       -  when, in  summary  window,  the delete  button  is pressed  the
+       software take care of reload  annotate mode for the visited buffer
+       the annotation button is referring to;
+
+       - when re-flowing annotation the window width was calculated always
+       for the current buffer (the one with the focus).
diff --git a/NEWS.org b/NEWS.org
index 3989548d16..8023a9f418 100644
--- a/NEWS.org
+++ b/NEWS.org
@@ -94,8 +94,8 @@
     the call of 'annotate-clear-annotations' the annotations
     will shows again at reload, this should be fixed now.
 
-- 2020-02-18 V0.5.3 Bastian Bechtold, cage ::
-  - fixed bug that prevented annotation of buffer when org-mode was used;
+- 2020-03-06 V0.5.3 Bastian Bechtold, cage ::
+  - Partially fixed bug that prevented annotation of buffer when org-mode was 
used;
   - when an user delete an annotation for a file using a button from
     summary window force refresh of a buffer that is visiting said
     file, if exists, to reflect the changes;
diff --git a/README.org b/README.org
index 1345d344d8..26a6a5b485 100644
--- a/README.org
+++ b/README.org
@@ -180,6 +180,18 @@ annotation, like this:
 As a shortcut, an empty query will match everything (just press
 ~return~ at prompt).
 
+* FAQ
+  Sometimes the package does not respect the customizable variable's value of
+  ~annotate-annotation-position-policy~, is this a bug?
+
+  No  it is  not, when  a line  which is  using a  non default  font is
+  annotated  the software  force  the ~:new-line~  policy,  that is  the
+  annotation will be  displayed on a new line regardless  of the value
+  of the variable mentioned in the question.
+
+  This is necessary  to prevent the annotation to be  pushed beyond the
+  window limits if an huge font is used by the annotated text.
+
 * LICENSE
 
 This package is released under the MIT license, see file [[./LICENSE][LICENSE]]
diff --git a/annotate.el b/annotate.el
index ad36af7839..c755760703 100644
--- a/annotate.el
+++ b/annotate.el
@@ -7,7 +7,7 @@
 ;; Maintainer: Bastian Bechtold
 ;; URL: https://github.com/bastibe/annotate.el
 ;; Created: 2015-06-10
-;; Version: 0.5.2
+;; Version: 0.5.3
 
 ;; This file is NOT part of GNU Emacs.
 
@@ -52,7 +52,7 @@
 ;;;###autoload
 (defgroup annotate nil
   "Annotate files without changing them."
-  :version "0.5.2"
+  :version "0.5.3"
   :group 'text)
 
 ;;;###autoload
@@ -156,7 +156,7 @@ database is not filtered at all."
 
 (defcustom annotate-annotation-position-policy :by-length
   "policy for annotation's position:
-  - :newline
+  - :new-line
     always in a new-line
   - :margin
      always on right margin