branch: externals/fontaine
commit a8e7f2e9b8ec6c4eaa75eb55acbc74702c96d438
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Prepare version 0.2.0
---
CHANGELOG.org | 44 ++++++++++++++++++++++++++++++++++++++++++++
README.org | 7 ++++---
fontaine.el | 2 +-
3 files changed, 49 insertions(+), 4 deletions(-)
diff --git a/CHANGELOG.org b/CHANGELOG.org
index 742a23b0d8..0d6fc3f9bc 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -9,7 +9,51 @@ project's main git repository:
<https://git.sr.ht/~protesilaos/fontaine>.
The newest release is at the top. For further details, please consult
the manual: <https://protesilaos.com/emacs/fontaine>.
+* Version 0.2.0 on 2022-05-09
+:PROPERTIES:
+:CUSTOM_ID: h:f9399542-29b7-4d26-af82-090fed802cc8
+:END:
+
++ Fontaine can apply its changes on a per-frame basis. One frame may,
+ for example, use a preset of font configurations for the purposes of a
+ "presentation" while the other has a "small" setup. Concretely,
+ invoke the commands ~fontaine-set-preset~ and ~fontaine-set-face-font~
+ with a universal prefix argument (=C-u=). Without a prefix argument,
+ these commands apply to all frames (as it was before).
+
++ The ~fontaine-presets~ accepts a special =t= preset which provides
+ "shared fallback values" for all presets. The manual has a section
+ titled "Shared and implicit fallback values for presets" which covers
+ all permutations of ~fontaine-presets~ at length. The gist is that
+ the user can write more concise presets. Thanks to Ted Reed for
+ proposing the idea and testing my prototype in the mailing list:
+
<https://lists.sr.ht/~protesilaos/fontaine/%3c87y1zcmo67....@zenithia.net%3E>.
+
++ Simplified the sample configuration on how to restore the latest saved
+ value or fall back to a preferred preset. Thanks to Christopher
+ League for proposing an elegant expression over at the mailing list:
+
<https://lists.sr.ht/~protesilaos/fontaine/%3c87sfpop0dm....@contrapunctus.net%3E#%3c87pmksoyv6....@contrapunctus.net%3E>
+
++ The ~fontaine-latest-state-file~ is now handled by the package
+ =no-littering=. Thanks to Christopher League for adding it there:
+
<https://github.com/emacscollective/no-littering/commit/76b7335202a5b6ddc6b6798a2e2fd5b09df57dc2>
+
++ The new user option ~fontaine-font-families~ specifies the preferred
+ font families that are provided as completion candidates of the
+ command ~fontaine-set-face-font~. If left to its default nil value,
+ Fontaine tries to find relevant fonts from the underlying system,
+ though this is not always accurate depending on the build of Emacs and
+ where it runs in.
+
++ The doc string of ~fontaine-presets~ mentions some important caveats
+ or information about font settings in emacs. Thanks to Eli Zaretskii
+ for the feedback on the emacs-devel mailing list:
+ <https://lists.gnu.org/archive/html/emacs-devel/2022-04/msg01281.html>.
+
* Version 0.1.0 on 2022-04-28
+:PROPERTIES:
+:CUSTOM_ID: h:80e56ed6-cf2b-49a2-9184-b149c9ecfa38
+:END:
Initial release of the package. Please read the manual.
diff --git a/README.org b/README.org
index 6164cbab97..acd10606c8 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.1.0
-#+macro: release-date 2022-04-28
-#+macro: development-version 0.2.0-dev
+#+macro: stable-version 0.2.0
+#+macro: release-date 2022-05-09
+#+macro: development-version 0.3.0-dev
#+macro: file @@texinfo:@file{@@$1@@texinfo:}@@
#+macro: space @@texinfo:@: @@
#+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@
@@ -37,6 +37,7 @@ commit, is explicitly marked as such.
Current development target is {{{development-version}}}.
+ Homepage: https://protesilaos.com/emacs/fontaine.
++ Change log: https://protesilaos.com/emacs/fontaine-changelog.
+ Git repository: https://git.sr.ht/~protesilaos/fontaine.
+ Mailing list: https://lists.sr.ht/~protesilaos/fontaine.
diff --git a/fontaine.el b/fontaine.el
index 7a9f24c92f..8aeb497abb 100644
--- a/fontaine.el
+++ b/fontaine.el
@@ -5,7 +5,7 @@
;; Author: Protesilaos Stavrou <i...@protesilaos.com>
;; URL: https://git.sr.ht/~protesilaos/fontaine
;; Mailing list: https://lists.sr.ht/~protesilaos/fontaine
-;; Version: 0.1.1
+;; Version: 0.2.0
;; Package-Requires: ((emacs "27.1"))
;; This file is NOT part of GNU Emacs.
