[elpa] externals/ef-themes 79bb1436f2 2/2: Add DIY section about org-modern-label

[ELPA Syncer]

branch: externals/ef-themes
commit 79bb1436f2fd8ab07e850c247c5616490f619f52
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Add DIY section about org-modern-label
---
 README.org | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/README.org b/README.org
index 70b1fcedb9..aab22ec6b0 100644
--- a/README.org
+++ b/README.org
@@ -534,6 +534,47 @@ code that uses ~ef-themes-with-colors~.
 This section documents how the user can further tweak the Ef themes to
 their liking.
 
+** Style font of =org-modern= elements
+:PROPERTIES:
+:CUSTOM_ID: h:32e3b7b2-3b53-4ec2-bd4e-fa24235e447d
+:END:
+
+[ Part of {{{development-version}}} ]
+
+The =org-modern= package uses faces and text properties to make Org
+buffers more aesthetically pleasing.  It affects tables, timestamps,
+lists, headings, and more.  To achieve a uniform look, the package
+defines a face that applies to all of those restyled elements.  The face
+is ~org-modern-label~.
+
+Depending on the user's font configurations, some elements may not line
+up properly.  The Ef themes used to prevent that phenomenon by expressly
+disabling all attributes of the ~org-modern-label~.  However, that only
+works for users who do not tinker with their packages, as it has the
+adverse effect of impacting the user option ~org-modern-label-border~.
+
+As such, the Ef themes no longer touch the ~org-modern-label~.  Users
+who want the old behaviour, are advised to include the following snipet
+in their init file.  They can add it, for example, after the call to
+load their theme of choice ([[#h:75d74aea-d17f-497f-a3b8-f0bf4c372de0][Loading 
a theme]]).
+
+#+begin_src emacs-lisp
+;; Revert to previous style of ef-themes version 0.5.0.  This makes,
+;; e.g., timestamps align in tables since they have the same typographic
+;; attributes as the default typeface.
+(set-face-attribute 'org-modern-label nil
+                    :inherit 'unspecified
+                    :height 'unspecified
+                    :weight 'unspecified
+                    :width 'unspecified
+                    :underline 'unspecified
+                    :box 'unspecified)
+#+end_src
+
+Alignment in tables will also depend on the use of proportionately
+spaced fonts.  Enable the relevant option to work with those without any
+further trouble ([[#h:621d3bb9-5967-4f97-b253-7470bba9168c][Enable mixed 
fonts]]).
+
 ** The general approach to advanced DIY changes
 :PROPERTIES:
 :CUSTOM_ID: h:ec0adf54-c037-4c53-81b8-7eab2303794d