From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Fri, 17 Jun 2022 12:17:51 +0000 (+0200)
Subject: Mention face quirks after the final line in the lispref manual
X-Git-Tag: emacs-28.1.90~28
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=e0bac17bbc51fc53d3555011b540b775942961d9;p=emacs.git

Mention face quirks after the final line in the lispref manual

* doc/lispref/display.texi (Face Attributes): Mention the quirks
about point after the final line (bug#56011).
---

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 1147ba112a6..404cf1b247a 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2593,6 +2593,13 @@ doesn't specify an explicit value for a face, the value from the
 original face definition by @code{defface} is inherited
 (@pxref{Defining Faces}).
 
+Some modes, like @code{hl-line-mode}, use a face with an
+@code{:extend} property to mark the entire current line.  Note,
+however, that Emacs will always allow you to move point after the
+final character in a buffer, and if the buffer ends with a newline
+character, point can be placed on what is seemingly a line at the end
+of the buffer---but Emacs can't highlight that ``line'', because it
+doesn't really exist.
 @end table
 
 @defun font-family-list &optional frame