Subject: 26.1.50; Docstring for 'empty' whitespace-style is clearer than manual
From: "Basil L. Contovounesios" <[email-masked]>
To: [email-masked]
Date: Mon, 04 Jun 2018 17:55:51 +0100
List-Id: <debbugs-submit.debbugs.gnu.org>

Severity: minor

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.

Thanks,

-- 
Basil

In GNU Emacs 26.1.50 (build 1, x86_64-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2018-06-03 built on thunk
Repository revision: 16e8541b743a6beb1926fef53cf1bfaed9c346db
Windowing system distributor 'The X.Org Foundation', version 11.0.11906000
System Description:	Debian GNU/Linux testing (buster)