From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#31713: 26.1.50; Docstring for 'empty' whitespace-style is clearer than manual Date: Tue, 05 Jun 2018 18:05:21 +0300 Message-ID: <83vaax9sum.fsf@gnu.org> References: <87h8mifq3s.fsf@tcd.ie> <874liifpmu.fsf@tcd.ie> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: blaine.gmane.org 1528211078 25769 195.159.176.226 (5 Jun 2018 15:04:38 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 5 Jun 2018 15:04:38 +0000 (UTC) Cc: 31713-done@debbugs.gnu.org To: "Basil L. Contovounesios" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jun 05 17:04:33 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fQDVg-0006ZB-E6 for geb-bug-gnu-emacs@m.gmane.org; Tue, 05 Jun 2018 17:04:32 +0200 Original-Received: from localhost ([::1]:47399 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fQDXn-000416-Iy for geb-bug-gnu-emacs@m.gmane.org; Tue, 05 Jun 2018 11:06:43 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54419) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fQDXB-0003gm-O2 for bug-gnu-emacs@gnu.org; Tue, 05 Jun 2018 11:06:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fQDX8-0003yC-K6 for bug-gnu-emacs@gnu.org; Tue, 05 Jun 2018 11:06:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:55664) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fQDX8-0003xr-G3 for bug-gnu-emacs@gnu.org; Tue, 05 Jun 2018 11:06:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fQDX8-0004DC-7T for bug-gnu-emacs@gnu.org; Tue, 05 Jun 2018 11:06:02 -0400 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Tue, 05 Jun 2018 15:06:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 31713 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Mail-Followup-To: 31713@debbugs.gnu.org, eliz@gnu.org, contovob@tcd.ie Original-Received: via spool by 31713-done@debbugs.gnu.org id=D31713.152821112216137 (code D ref 31713); Tue, 05 Jun 2018 15:06:01 +0000 Original-Received: (at 31713-done) by debbugs.gnu.org; 5 Jun 2018 15:05:22 +0000 Original-Received: from localhost ([127.0.0.1]:35327 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fQDWT-0004CC-Ss for submit@debbugs.gnu.org; Tue, 05 Jun 2018 11:05:22 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:34543) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fQDWS-0004Bz-32 for 31713-done@debbugs.gnu.org; Tue, 05 Jun 2018 11:05:20 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fQDWJ-0003AL-Qj for 31713-done@debbugs.gnu.org; Tue, 05 Jun 2018 11:05:14 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:45333) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fQDWJ-0003AB-MV; Tue, 05 Jun 2018 11:05:11 -0400 Original-Received: from [176.228.60.248] (port=3884 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fQDWI-0007sb-7P; Tue, 05 Jun 2018 11:05:11 -0400 In-reply-to: <874liifpmu.fsf@tcd.ie> (contovob@tcd.ie) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:147022 Archived-At: > From: "Basil L. Contovounesios" > Date: Mon, 04 Jun 2018 18:06:01 +0100 > > tags 31713 patch > quit > > > 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, pushed.