From: "Basil L. Contovounesios" <contovob@tcd.ie>
To: 31713@debbugs.gnu.org
Subject: bug#31713: 26.1.50; Docstring for 'empty' whitespace-style is clearer than manual
Date: Mon, 04 Jun 2018 18:06:01 +0100 [thread overview]
Message-ID: <874liifpmu.fsf@tcd.ie> (raw)
In-Reply-To: <87h8mifq3s.fsf@tcd.ie> (Basil L. Contovounesios's message of "Mon, 04 Jun 2018 17:55:51 +0100")
[-- Attachment #1: Type: text/plain, Size: 23 bytes --]
tags 31713 patch
quit
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-Improve-documentation-of-empty-whitespace-style.patch --]
[-- Type: text/x-diff, Size: 891 bytes --]
From 07fd69686c1a8a810d1d4e5a6f09f0785bdfa931 Mon Sep 17 00:00:00 2001
From: "Basil L. Contovounesios" <contovob@tcd.ie>
Date: Mon, 4 Jun 2018 17:39:40 +0100
Subject: [PATCH] Improve documentation of 'empty' whitespace-style
* doc/emacs/display.texi (Useless Whitespace): Clarify that the
'empty' whitespace-style option highlights empty lines only at
BOB/EOB, as per the docstring of whitespace-style. (bug#31713)
---
doc/emacs/display.texi | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index c60cf64914..2f5ce80d60 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -1253,7 +1253,7 @@ Useless Whitespace
Highlight newlines.
@item empty
-Highlight empty lines.
+Highlight empty lines at the beginning and/or end of the buffer.
@item big-indent
@vindex whitespace-big-indent-regexp
--
2.17.1
[-- Attachment #3: Type: text/plain, Size: 717 bytes --]
"Basil L. Contovounesios" <contovob@tcd.ie> writes:
> The 'empty' whitespace-style option is described under
> "(emacs) Useless Whitespace" as follows:
>
> ‘empty’
> Highlight empty lines.
>
> The docstring of whitespace-style, on the other hand, is a bit clearer
> w.r.t. which lines are considered empty:
>
> empty empty lines at beginning and/or end of buffer
> are visualized via faces.
> It has effect only if `face' (see above)
> is present in `whitespace-style'.
>
> I think the manual should also mention the BOB/EOB restriction.
I attach a potential amendment.
Thanks,
--
Basil
next prev parent reply other threads:[~2018-06-04 17:06 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-06-04 16:55 bug#31713: 26.1.50; Docstring for 'empty' whitespace-style is clearer than manual Basil L. Contovounesios
2018-06-04 17:06 ` Basil L. Contovounesios [this message]
2018-06-05 15:05 ` Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=874liifpmu.fsf@tcd.ie \
--to=contovob@tcd.ie \
--cc=31713@debbugs.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.