[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] scratch/extend_face_id 1bf2a87 13/13: Document new :extend
From: |
Jimmy Aguilar Mena |
Subject: |
[Emacs-diffs] scratch/extend_face_id 1bf2a87 13/13: Document new :extend face attribute in manuals. |
Date: |
Mon, 23 Sep 2019 22:50:32 -0400 (EDT) |
branch: scratch/extend_face_id
commit 1bf2a871d1b07531d91d14844f88785fa4350bcd
Author: Jimmy Aguilar Mena <address@hidden>
Commit: Jimmy Aguilar Mena <address@hidden>
Document new :extend face attribute in manuals.
---
doc/emacs/mark.texi | 5 +++++
doc/lispref/display.texi | 22 ++++++++++++++++++++++
2 files changed, 27 insertions(+)
diff --git a/doc/emacs/mark.texi b/doc/emacs/mark.texi
index bbeb4cb..f012d72 100644
--- a/doc/emacs/mark.texi
+++ b/doc/emacs/mark.texi
@@ -23,6 +23,11 @@ When the mark is active, we say also that the region is
active; Emacs
indicates its extent by highlighting the text within it, using the
@code{region} face (@pxref{Face Customization}).
+This is one of the few faces that has the @code{:extend t} attribute
+by default, which implies that the same face is used to highlight the
+text and space between end of line and the window border. To
+highlight only the text you could set this attribute to @code{nil}.
+
@cindex deactivating the mark
After certain non-motion commands, including any command that
changes the text in the buffer, Emacs automatically @dfn{deactivates}
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 3c3ee1f..f4b35cc 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2482,6 +2482,17 @@ faces (@pxref{Displaying Faces}). If the face to
inherit from is
never merges @code{:inherit} attributes. If a list of faces is used,
attributes from faces earlier in the list override those from later
faces.
+
+@item :extend
+Whether or not this face will be extended until the end of the window.
+The value should be @code{t} to extend until end of the window using
+this face or @code{nil} fill the space between the end of the line and
+the end of the window with the default face. When a face is conformed
+by merging multiple other faces; only those with @code{:extend t} will
+be merged to conform a new face to extend until end of window. By
+default only @code{region} and @code{hl-line} have this attribute set
+to @code{t}.
+
@end table
@defun font-family-list &optional frame
@@ -2842,6 +2853,11 @@ This sets the @code{:inverse-video} attribute of
@var{face} to
This swaps the foreground and background colors of face @var{face}.
@end deffn
+@deffn Command set-face-extend face extend &optional frame
+This sets the @code{:extend} attribute of @var{face} to
+@var{extend}.
+@end deffn
+
The following functions examine the attributes of a face. They
mostly provide compatibility with old versions of Emacs. If you don't
specify @var{frame}, they refer to the selected frame; @code{t} refers
@@ -2900,6 +2916,12 @@ This function returns non-@code{nil} if face @var{face}
specifies
a non-@code{nil} @code{:inverse-video} attribute.
@end defun
+@defun face-extend-p face &optional frame
+This function returns non-@code{nil} if face @var{face} specifies
+a non-@code{nil} @code{:extend} attribute.
+@end defun
+
+
@node Displaying Faces
@subsection Displaying Faces
@cindex displaying faces
- [Emacs-diffs] branch scratch/extend_face_id created (now 1bf2a87), Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id 27cfeff 01/13: Simplify struct face to use only underline., Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id 78cdadb 04/13: Fixed extend face filtered for prop., Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id 85d33e2 02/13: Added face parameter :extend., Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id d071c8e 07/13: Fix last change in append_space_for_newline., Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id c4e4029 11/13: Optimization in extend_face, Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id 879aa2f 06/13: Add space for cursor to work also in terminal., Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id 170028a 08/13: Make hl-line face to extend all the line.., Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id cd723df 05/13: Changed handle_face_prop_general prototype., Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id af7a9ea 12/13: Fixed merge_face_ref recursive calls., Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id 1bf2a87 13/13: Document new :extend face attribute in manuals.,
Jimmy Aguilar Mena <=
- [Emacs-diffs] scratch/extend_face_id 675bc49 10/13: Extend_face simplify., Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id 09e5020 09/13: Added parameter attr_filter to face_at_string_position., Jimmy Aguilar Mena, 2019/09/23
- [Emacs-diffs] scratch/extend_face_id 2e156ae 03/13: Conditional merged face to extend after eol., Jimmy Aguilar Mena, 2019/09/23