[elpa] externals/logos 83a2739a34: Update to version 0.5.0

[ELPA Syncer]

branch: externals/logos
commit 83a2739a34e5dada28bf3679996d2cc2cce15984
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Update to version 0.5.0
---
 CHANGELOG.org | 103 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.org    |  14 +++-----
 logos.el      |   2 +-
 3 files changed, 109 insertions(+), 10 deletions(-)

diff --git a/CHANGELOG.org b/CHANGELOG.org
index 613d8254b9..8612988b71 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -6,6 +6,109 @@
 The newest release is at the top.  For further details, please consult
 the manual: <https://protesilaos.com/emacs/logos>.
 
+* Version 0.5.0 on 2022-09-01
+:PROPERTIES:
+:CUSTOM_ID: h:189634ab-187a-4e44-9006-1361459150b8
+:END:
+
++ Introduced the function ~logos-update-fringe-in-buffers~.  This is a
+  convenience function for those who (i) set the user option
+  ~logos-hide-fringe~ to a non-nil value and (ii) switch themes while
+  ~logos-focus-mode~ is enabled in one or more buffers.  This
+  convenience function updates the ~fringe~ face to be consistent with
+  the current theme (we technically make the fringe invisible, instead
+  of outright disabling it, as that would not be desirable).  It needs
+  to be assigned to a hook that gets called in the post-theme-load
+  phase.  The =modus-themes= or the =ef-themes= (both by me) provide
+  such a hook.  Otherwise the Logos manual explains how to implement one
+  for any theme.  Read:
+  <https://protesilaos.com/emacs/logos#h:6a254fa0-5706-4032-8a8b-233ffb1f0e6b>.
+
++ Implemented the ~logos-focus-mode-map~.  This is a keymap that is
+  active when ~logos-focus-mode~ is enabled in the buffer.  One can, for
+  example, use it to bind the arrow key to page motions, such as
+  ~logos-forward-page-dwim~.
+
+  Remember that, by default, pages are delimited with the Control-L
+  character (=^L=), though Logos can treat different delimiters as
+  "page" separators (e.g. Org headings and a horizontal rule of five
+  hyphens).  Consult the user options ~logos-outlines-are-pages~,
+  ~logos-outline-regexp-alist~, and check the manual for relevant simple
+  and more advanced code samples.  My current setup for those:
+
+  #+begin_src emacs-lisp
+  (setq logos-outlines-are-pages t)
+  (setq logos-outline-regexp-alist
+        `((emacs-lisp-mode . ,(format "\\(^;;;+ \\|%s\\)" 
logos--page-delimiter))
+          (org-mode . ,(format "\\(^\\*+ +\\|^-\\{5\\}$\\|%s\\)" 
logos--page-delimiter))
+          (markdown-mode . ,(format "\\(^\\#+ +\\|^[*-]\\{5\\}$\\|^\\* \\* 
\\*$\\|%s\\)" logos--page-delimiter))
+          (conf-toml-mode . "^\\[")
+          (t . ,(or outline-regexp logos--page-delimiter))))
+  #+end_src
+
++ Added the ~logos-repeat-map~.  This is a keymap that gets enabled when
+  the built-in ~repeat-mode~ is active (Emacs 28 or higher).  This means
+  that page motions, =C-x ]= and =C-x [=, can be repeated by following
+  them up with either =]= or =[=.  The repetition stops when another
+  command is invoked.
+
+  Thanks to Lucy McPhail for the patch:
+  <https://lists.sr.ht/~protesilaos/logos/patches/34101>.  The change is
+  below the ~15 line threshold and thus requires no copyright assignment
+  to the Free Software Foundation.
+
++ Wrote documentation on how to auto-toggle menu and tool bars while
+  using the ~logos-focus-mode~.  This is complementary to user options
+  provided by Logos and shows how flexible and extensible the code is.
+  Thanks to Ypot for raising the question in issue 2 on the GitHub
+  mirror: <https://github.com/protesilaos/logos/issues/2>.
+
+  [ Never hesitate to ask for help if you want to do something with
+    Logos but are not sure how. ]
+
++ Specified the =:version= of all user-facing variables.  This is
+  helpful while perusing documentation strings in Help buffers, as any
+  change will be assigned to the given version of Logos.
+
++ Clarified the doc string of the ~logos-variable-pitch~ user option
+  with regard to ~prog-mode~ buffers.  It now reads thus:
+
+  #+begin_quote
+  When non-nil, use ~variable-pitch-mode~ where appropriate.
+  In programming modes the default font is always used, as that is
+  assumed to be a monospaced typeface, which is appropriate for
+  spacing-sensitive text.
+
+  This is only relevant when ~logos-focus-mode~ is enabled.
+  #+end_quote
+
++ Documented some user options for the built-in ~eww~ which make its
+  contents behave like the rest of Emacs in terms of the use of fonts
+  and the filling of paragraphs.  In brief:
+
+  #+begin_src emacs-lisp
+  (setq shr-max-width fill-column)
+  (setq shr-use-fonts nil)
+  #+end_src
+
+  This is relevant for Logos as we then do not need to implement special
+  casing for ~logos-focus-mode~ to work nicely with ~eww~ (I am
+  personally annoyed when a buffer has its own opinions about font
+  settings).
+
+  Thanks to Ypot for discussing this in issue 4 on the GitHub mirror:
+  <https://github.com/protesilaos/logos/issues/4>.
+
+  [ For font-related customisations check the =fontaine= package on GNU
+    ELPA (by me). ]
+
++ Named the mailing list address as the =Maintainer:= of Logos.
+  Together with the other package headers, they help the user find our
+  primary sources and/or communication channels.  This change conforms
+  with work being done upstream in package.el by Philip Kaludercic.  I
+  was informed about it here:
+  
<https://lists.sr.ht/~protesilaos/general-issues/%3C875ykl84yi.fsf%40posteo.net%3E>.
+
 * Version 0.4.0 on 2022-06-02
 :PROPERTIES:
 :CUSTOM_ID: h:f0293274-8cde-4660-ba1a-cffce2910f2f
diff --git a/README.org b/README.org
index c8bbf0cdae..f5cdfc5f97 100644
--- a/README.org
+++ b/README.org
@@ -5,9 +5,9 @@
 #+options: ':t toc:nil author:t email:t num:t
 #+startup: content
 
-#+macro: stable-version 0.4.0
-#+macro: release-date 2022-06-02
-#+macro: development-version 0.5.0-dev
+#+macro: stable-version 0.5.0
+#+macro: release-date 2022-09-01
+#+macro: development-version 1.0.0-dev
 #+macro: file @@texinfo:@file{@@$1@@texinfo:}@@
 #+macro: space @@texinfo:@: @@
 #+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@
@@ -103,10 +103,8 @@ to narrow effectively.  Such users may still want to bind 
it to a key.
 For users running Emacs version 28 or higher, Logos defines the
 ~logos-repeat-map~ which is activated when ~repeat-mode~ is enabled.
 This means that page motions, =C-x ]= and =C-x [=, can be repeated by
-following them up with =]= and =[=, respectively.  The repetition stops
-when another command is invoked.
-
-[ The ~logos-repeat-map~ is part of {{{development-version}}} ]
+following them up with either =]= or =[=.  The repetition stops when
+another command is invoked.
 
 #+findex: logos-focus-mode
 #+vindex: logos-hide-mode-line
@@ -559,8 +557,6 @@ and then restore them back on when ~logos-focus-mode~ is 
disabled.
 :CUSTOM_ID: h:6a254fa0-5706-4032-8a8b-233ffb1f0e6b
 :END:
 
-[ Part of {{{development-version}}} ]
-
 The user option ~logos-hide-fringe~ does not actually remove the fringe,
 as that would change the user's preference for ~fringe-mode~.  Instead,
 it remaps its background color to be the same as that of the ~default~
diff --git a/logos.el b/logos.el
index 4637bdd632..c2d98ebfdf 100644
--- a/logos.el
+++ b/logos.el
@@ -6,7 +6,7 @@
 ;; Maintainer: Logos Development <~protesilaos/logos@lists.sr.ht>
 ;; URL: https://git.sr.ht/~protesilaos/logos
 ;; Mailing-List: https://lists.sr.ht/~protesilaos/logos
-;; Version: 0.4.0
+;; Version: 0.5.0
 ;; Package-Requires: ((emacs "27.1"))
 ;; Keywords: convenience, focus, writing, presentation, narrowing