master 3de577a: Mention problems with synthetic fonts on macOS

[Lars Ingebrigtsen]

branch: master
commit 3de577ad0079ecca815086b5f07403cd8e5701a2
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    Mention problems with synthetic fonts on macOS
    
    * etc/PROBLEMS: Mention synthetic fonts (bug#18818).
---
 etc/PROBLEMS | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index 15e34ea..f904187 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -2660,6 +2660,16 @@ If you do, please send it to bug-gnu-emacs@gnu.org so we 
can list it here.
 
 Libxpm is available for macOS as part of the XQuartz project.
 
+** Synthetic fonts on macOS
+
+Synthetic bold looks thinner if the background is darker than the
+foreground and font smoothing is turned on.  In such cases, you can
+turn off synthetic bold for particular fonts and use overstriking
+instead by customizing the variable 'face-ignored-fonts'.  For
+instance, if the problem is with the Monaco font, you could put
+something like the following in your init file:
+
+(push "\\`-[^-]*-monaco-bold-" face-ignored-fonts)
 
 * Build-time problems