From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 15 Jul 2017 12:34:03 +0000 (+0300)
Subject: Improve comments in faces.el
X-Git-Tag: emacs-26.0.90~518^2~94
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a5c4ffdb6e1fe37c5c060b4a4181e5ee79f71ec6;p=emacs.git

Improve comments in faces.el

* lisp/faces.el (face-font-family-alternatives): Improve
commentary.
---

diff --git a/lisp/faces.el b/lisp/faces.el
index c3693d16631..97c32165b9c 100644
--- a/lisp/faces.el
+++ b/lisp/faces.el
@@ -102,11 +102,16 @@ a font height that isn't optimal."
     ;; Monospace Serif is an Emacs invention, intended to work around
     ;; portability problems when using Courier.  It should work well
     ;; when combined with Monospaced and with other standard fonts.
+    ;; One of its uses is for 'tex-verbatim' and 'Info-quoted' faces,
+    ;; so the result must be different from the default face's font,
+    ;; and must be monospaced.
     ("Monospace Serif"
 
      ;; This looks good on GNU/Linux.
      "Courier 10 Pitch"
-     ;; This looks good on MS-Windows and OS X.
+     ;; This looks good on MS-Windows and OS X.  Note that this is
+     ;; actually a sans-serif font, but it's here for lack of a better
+     ;; alternative.
      "Consolas"
      ;; This looks good on macOS.  "Courier" looks good too, but is
      ;; jagged on GNU/Linux and so is listed later as "courier".