[nongnu] elpa/org-superstar 4897c333a8 105/162: Version bump: Update documentation and README accordingly to reflect new feature.

[Stefan Kangas]

branch: elpa/org-superstar
commit 4897c333a8864c9ec7a1fcb092aaa5a15b6ab895
Author: D. Williams <d.williams@posteo.net>
Commit: D. Williams <d.williams@posteo.net>

    Version bump: Update documentation and README accordingly to reflect new 
feature.
---
 README.org       | 32 ++++++++++++++++++++++----------
 org-superstar.el | 18 ++++++++++++++----
 2 files changed, 36 insertions(+), 14 deletions(-)

diff --git a/README.org b/README.org
index ec6ce31e7f..f2a02004c2 100644
--- a/README.org
+++ b/README.org
@@ -224,16 +224,17 @@ used, allowing the user to inherit the level-dependent 
default look.
 
 * NEWS
 
-** =2020-04-01=
-   A minor status update.  [[https://melpa.org/#/org-superstar][We cracked the 
500 downloads mark on MELPA!]]
-   Unbelievable! Thank you all for your support!  Should we reach the
-   1-2000 downloads mark by the end of the year, I will consider
-   contacting major Emacs releases shipping with org-bullets, such as
-   Spacemacs or Doom.
+** =2020-04-14=
+   Version *1.2.0* is now available.  This version adds support for
+   using advanced features of ~compose-region~ for TODO item bullets.
+
+   Also, the package's downloads doubled in less than two weeks,
+   meaning Org Superstar now has [[https://melpa.org/#/org-superstar][over 
1000 downloads on MELPA]]!  I have
+   given the whole situation some more thought, and decided that I
+   will contact the Spacemacs team should we reach 2000 downloads this
+   year, which I would consider enough proof of the package's
+   popularity.
 
-   In other news, version *1.1.0* is now available, providing a few
-   minor fixes, as well as a new feature to disable expensive syntax
-   checks for plain list items. See the FAQ for more info.
 
 * Announcement Log
 ** =2020-02-02=
@@ -281,4 +282,15 @@ used, allowing the user to inherit the level-dependent 
default look.
    the people on GitHub and the Org mailing list that helped me along!
    I would not have managed without you! :)
 
-#  LocalWords:  Org's MELPA ELPA Worg fontification TODO README UTF
+** =2020-04-01=
+   A minor status update.  [[https://melpa.org/#/org-superstar][We cracked the 
500 downloads mark on MELPA!]]
+   Unbelievable! Thank you all for your support!  Should we reach the
+   1-2000 downloads mark by the end of the year, I will consider
+   contacting major Emacs releases shipping with org-bullets, such as
+   Spacemacs or Doom.
+
+   In other news, version *1.1.0* is now available, providing a few
+   minor fixes, as well as a new feature to disable expensive syntax
+   checks for plain list items. See the FAQ for more info.
+
+#  LocalWords:  Org's MELPA ELPA Worg fontification TODO README UTF Spacemacs
diff --git a/org-superstar.el b/org-superstar.el
index c3e2c3d228..99d0e29580 100644
--- a/org-superstar.el
+++ b/org-superstar.el
@@ -5,7 +5,7 @@
 ;; Author: D. Williams <d.williams@posteo.net>
 ;; Maintainer: D. Williams <d.williams@posteo.net>
 ;; Keywords: faces, outlines
-;; Version: 1.1.0
+;; Version: 1.2.0
 ;; Homepage: https://github.com/integral-dw/org-superstar-mode
 ;; Package-Requires: ((org "9.1.9") (emacs "26.1"))
 
@@ -121,9 +121,19 @@ variable for your changes to take effect."
     ("DONE" . ?☑))
   "Alist of UTF-8 bullets for TODO items.
 
-Each key should be a TODO keyword, and each value should the UTF8
-character to be displayed.  Keywords that are not included in the
-alist are handled like normal headings.
+In the simplest case each key should be a TODO keyword, and each
+value should the UTF8 character to be displayed.  Keywords that
+are not included in the alist are handled like normal headings.
+
+Alternatively, each alist element may be a proper list of the form
+(KEYWORD COMPOSE-STRING CHARACTER [REST...])
+
+where KEYWORD should be a TODO keyword, and COMPOSE-STRING should
+be a string according to the rules of the third argument of
+‘compose-region’.  It will be used to compose the specific TODO
+item bullet.  CHARACTER is the fallback character used in
+terminal displays, where composing characters cannot be relied
+upon.  See also ‘org-superstar-leading-fallback’.
 
 You should call ‘org-superstar-restart’ after changing this
 variable for your changes to take effect."