[nongnu] elpa/page-break-lines 502aee8208 16/80: Add more information about font width issue, and provide workaround

[ELPA Syncer]

branch: elpa/page-break-lines
commit 502aee82088a0a30f0dec3f377be958fee8d01ef
Author: Steve Purcell <steve@sanityinc.com>
Commit: Steve Purcell <steve@sanityinc.com>

    Add more information about font width issue, and provide workaround
---
 README.md           | 19 +++++++++++++++++++
 page-break-lines.el | 15 ++++++++++++---
 2 files changed, 31 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 9308820e39..8d9e5dd68c 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,25 @@ Enable `page-break-lines-mode` in an individual buffer like 
this:
 Alternatively, customize `page-break-lines-modes` and enable the mode globally 
with
 `global-page-break-lines-mode`.
 
+Issues and limitations
+======================
+
+If `page-break-lines-char` is displayed at a different width to
+regular characters, the rule may be either too short or too long:
+rules may then wrap if `truncate-lines` is nil. On some systems,
+Emacs may erroneously choose a different font for the page break
+symbol, which choice can be overridden using code such as:
+
+```lisp
+(set-fontset-font "fontset-default"
+                  (cons page-break-lines-char page-break-lines-char)
+                  (face-attribute 'default :family))
+```
+
+Use `describe-char` on a page break char to determine whether this
+is the case.
+
+
 [marmalade]: http://marmalade-repo.org
 [melpa]: http://melpa.milkbox.net
 
diff --git a/page-break-lines.el b/page-break-lines.el
index 2cf6be541b..fde8cab177 100644
--- a/page-break-lines.el
+++ b/page-break-lines.el
@@ -34,9 +34,18 @@
 
 ;; Issues and limitations:
 
-;; If `page-break-lines-char' is a different width to regular
-;; characters, the rule may be either too short or too long: rules may
-;; wrap if `truncate-lines' is nil.
+;; If `page-break-lines-char' is displayed at a different width to
+;; regular characters, the rule may be either too short or too long:
+;; rules may then wrap if `truncate-lines' is nil. On some systems,
+;; Emacs may erroneously choose a different font for the page break
+;; symbol, which choice can be overridden using code such as:
+
+;; (set-fontset-font "fontset-default"
+;;                   (cons page-break-lines-char page-break-lines-char)
+;;                   (face-attribute 'default :family))
+
+;; Use `describe-char' on a page break char to determine whether this
+;; is the case.
 
 ;; Adapted from code http://www.emacswiki.org/emacs/PageBreaks