branch: externals/show-font
commit 44da364c0a884008f91a12a9f9766d1d3b37f95c
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Update to show-font version 0.3.0
---
CHANGELOG.org | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
README.org | 10 ++++-----
show-font.el | 2 +-
3 files changed, 76 insertions(+), 7 deletions(-)
diff --git a/CHANGELOG.org b/CHANGELOG.org
index 3f2ab57011..d7d3748b2f 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -13,6 +13,77 @@ the manual: <https://protesilaos.com/emacs/show-font>.
#+toc: headlines 1 insert TOC here, with one headline level
+* Version 0.3.0 on 2025-04-26
+:PROPERTIES:
+:CUSTOM_ID: h:e57d0359-f7dc-4abd-802e-27b854d633bf
+:END:
+
+This version adds some refinements to an already stable package.
+
+** The command ~show-font-list~ is an alias for ~show-font-tabulated~
+:PROPERTIES:
+:CUSTOM_ID: h:c1d85f05-af1f-4019-8f4a-fe2df95949d7
+:END:
+
+The ~show-font-list~ command was using a custom buffer that listed
+font families and their corresponding short preview. It did not have
+any other feature.
+
+I made changes under the hood to rely on the built-in
+~tabulated-list-mode~ which is a standard and gives us the option to
+sort by column. The ~show-font-list~ is thus an alias for the new
+command ~show-font-tabulated~. Right now the sorting facility only
+applies to reversing the name-based order. In the future we may have
+more columns, such as if we describe a font as "Latin", "Greek", etc.
+
+** The tabulated list marks fonts that cannot be previewed
+:PROPERTIES:
+:CUSTOM_ID: h:ae432193-64c3-4504-84e6-56690f8110cc
+:END:
+
+In the past, the font listing would include families that could not
+display the ~show-font-pangram~ or, indeed, any Latin character. Those
+would be rendered as empty boxes.
+
+I have now introduced a simple heuristic to test that the given family
+supports Latin characters. If it does not, then (i) it is highlighted
+with a different colour, (ii) it shows "No preview" instead of the
+pangram, and (iii) it displays the information in the Emacs default
+font family. Some families do not play nice with this approach though,
+as they pass the test but still do not display any Latin characters.
+This happens with icon fonts.
+
+The long-term goal is to support different scripts and show the
+appropriate text for each of them.
+
+** The ~show-font-sentences-sample~ adds more to the ~show-font-select-preview~
+:PROPERTIES:
+:CUSTOM_ID: h:1f1194e8-79bf-4a03-9797-28daacbd9a7f
+:END:
+
+The new user option ~show-font-sentences-sample~ is a list of strings
+that can be used to exhibit common patterns and letter combinations.
+The default value is carefully designed to show if a font family is
+stylistically consistent, such as with how it draws =i=, =l=, =t=, or
+=h=, =n=, =m=, and so on. Plus, it teaches you some obscure words like
+"scholarch", "antipode", and "heteroclite": use them with your Greek
+friends---and if they do not know those words, then they must buy you
+a café frappé!
+
+** Miscellaneous
+:PROPERTIES:
+:CUSTOM_ID: h:6b2ccce6-5ff7-463f-8c70-0c5ca70aa35c
+:END:
+
+- The face ~show-font-title-small~ is an obsolete alias for the more
+ appropriately named ~show-font-title-in-listing~.
+- The prompt used by the command ~show-font-select-preview~ now
+ correctly uses its own history and default value.
+- The default value of the user option ~show-font-character-sample~
+ includes some more patterns to better test the adequacy of a font
+ family. This sample is displayed in the buffer produced by the
+ command ~show-font-select-preview~.
+
* Version 0.2.0 on 2025-01-25
:PROPERTIES:
:CUSTOM_ID: h:087ddf5c-6a65-4fb0-a1cb-0a64b3d181c2
diff --git a/README.org b/README.org
index 7b14f0d7f3..597f97c550 100644
--- a/README.org
+++ b/README.org
@@ -4,9 +4,9 @@
#+language: en
#+options: ':t toc:nil author:t email:t num:t
#+startup: content
-#+macro: stable-version 0.2.0
-#+macro: release-date 2025-01-25
-#+macro: development-version 0.3.0-dev
+#+macro: stable-version 0.3.0
+#+macro: release-date 2025-04-26
+#+macro: development-version 0.4.0-dev
#+export_file_name: show-font.texi
#+texinfo_filename: show-font.info
#+texinfo_dir_category: Emacs misc features
@@ -198,9 +198,7 @@ elements.
- ~show-font-title~
#+vindex: show-font-title-in-listing
-- ~show-font-title-in-listing~ [ The face ~show-font-title-small~ is
- an obsolete alias of ~show-font-title-in-listing~ as part of
- {{{development-version}}}. ]
+- ~show-font-title-in-listing~
#+vindex: show-font-misc
- ~show-font-misc~
diff --git a/show-font.el b/show-font.el
index 36c0bbe7e3..0cbdc1726e 100644
--- a/show-font.el
+++ b/show-font.el
@@ -5,7 +5,7 @@
;; Author: Protesilaos Stavrou <i...@protesilaos.com>
;; Maintainer: Protesilaos Stavrou <i...@protesilaos.com>
;; URL: https://github.com/protesilaos/show-font
-;; Version: 0.2.1
+;; Version: 0.3.0
;; Package-Requires: ((emacs "29.1"))
;; Keywords: convenience, writing, font
