branch: externals/lin
commit edc29c2afe98ecd120108b7d3561aff938cc22c3
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Upgrade to version 0.3.0
---
CHANGELOG.org | 59 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++---
README.org | 8 ++++----
lin.el | 4 ++--
3 files changed, 62 insertions(+), 9 deletions(-)
diff --git a/CHANGELOG.org b/CHANGELOG.org
index c43b888640..47ae5e283d 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -3,12 +3,65 @@
#+EMAIL: i...@protesilaos.com
#+OPTIONS: ':nil toc:nil num:nil author:nil email:nil
-This document contains the release notes for each tagged commit on the
-project's main git repository: <https://gitlab.com/protesilaos/lin>.
-
The newest release is at the top. For further details, please consult
the manual: <https://protesilaos.com/emacs/lin>.
+* Version 0.3.0 on 2022-04-08
+
++ Changed the source repository from GitLab to SourceHut:
+ <https://git.sr.ht/~protesilaos/lin>. Use the mailing list to start a
+ discussion, report a bug, send a patch, etc.:
+ <https://lists.sr.ht/~protesilaos/lin>. The GitLab URL will serve as
+ a mirror from now on (a GitHub mirror is still available and will
+ remain that way).
+
++ Introduced a buffer-local minor mode as well as its global equivalent:
+ ~lin-mode~ and ~lin-global-mode~. This makes it easier to set up Lin
+ in user init files and/or toggle it on demand. The following shows
+ how the package can be used:
+
+ #+begin_src emacs-lisp
+(require 'lin)
+
+(setq lin-face 'lin-blue) ; check doc string for alternative styles
+
+;; You can use this to live update the face:
+;;
+;; (customize-set-variable 'lin-face 'lin-green)
+
+(setq lin-mode-hooks
+ '(bongo-mode-hook
+ dired-mode-hook
+ elfeed-search-mode-hook
+ git-rebase-mode-hook
+ ibuffer-mode-hook
+ ilist-mode-hook
+ ledger-report-mode-hook
+ log-view-mode-hook
+ magit-log-mode-hook
+ mu4e-headers-mode
+ notmuch-search-mode-hook
+ notmuch-tree-mode-hook
+ occur-mode-hook
+ org-agenda-mode-hook
+ tabulated-list-mode-hook))
+
+(lin-global-mode 1)
+ #+end_src
+
++ The ~lin-face~ now has a custom setter which automatically updates its
+ appearance in all buffers where ~lin-mode~ is enabled. Users might
+ thus prefer to set its value with ~customize-set-variable~ in order to
+ find the style they like the most. Otherwise setting the value with
+ ~setq~ is just fine for stable configurations. If, in that case, the
+ user wants to update the face, they must invoke ~revert-buffer~ or
+ equivalent (e.g. type =g= in Dired with the default key bindings) or
+ evaluate the function ~lin-enable-mode-in-buffers~.
+
++ The user option ~lin-mode-hooks~ now includes ~bongo-mode-hook~ (from
+ the =bongo= package). Its default value is shown in the sample code
+ above.
+
* Version 0.2.0 on 2022-03-16
Rewrote the entirety of =lin.el= to make the configuration easier and
diff --git a/README.org b/README.org
index c1722a6ad7..d7efb46e36 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.2.0
-#+macro: release-date 2022-03-18
-#+macro: development-version 0.3.0-dev
+#+macro: stable-version 0.3.0
+#+macro: release-date 2022-04-08
+#+macro: development-version 0.4.0-dev
#+macro: file @@texinfo:@file{@@$1@@texinfo:}@@
#+macro: space @@texinfo:@: @@
#+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@
@@ -118,7 +118,7 @@ the others only specify a background attribute.
:END:
#+cindex: Installation instructions
-** COMMENT GNU ELPA package
+** GNU ELPA package
:PROPERTIES:
:CUSTOM_ID: h:9379f7d7-9f78-40b8-8d30-cceb462cd41f
:END:
diff --git a/lin.el b/lin.el
index 26fa6d3ca8..37b3828867 100644
--- a/lin.el
+++ b/lin.el
@@ -3,8 +3,8 @@
;; Copyright (C) 2021-2022 Free Software Foundation, Inc.
;; Author: Protesilaos Stavrou <i...@protesilaos.com>
-;; URL: https://gitlab.com/protesilaos/lin
-;; Version: 0.2.0
+;; URL: https://git.sr.ht/~protesilaos/lin
+;; Version: 0.3.0
;; Package-Requires: ((emacs "27.1"))
;; Keywords: convenience, faces, theme
