From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: "Basil L. Contovounesios" Newsgroups: gmane.emacs.bugs Subject: bug#31713: 26.1.50; Docstring for 'empty' whitespace-style is clearer than manual Date: Mon, 04 Jun 2018 18:06:01 +0100 Message-ID: <874liifpmu.fsf@tcd.ie> References: <87h8mifq3s.fsf@tcd.ie> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: blaine.gmane.org 1528131909 15596 195.159.176.226 (4 Jun 2018 17:05:09 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 4 Jun 2018 17:05:09 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) To: 31713@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jun 04 19:05:05 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 1fPsul-0003vg-NN for geb-bug-gnu-emacs@m.gmane.org; Mon, 04 Jun 2018 19:05:03 +0200 Original-Received: from localhost ([::1]:41087 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fPswt-00028E-0C for geb-bug-gnu-emacs@m.gmane.org; Mon, 04 Jun 2018 13:07:15 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44105) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fPswj-00027P-F6 for bug-gnu-emacs@gnu.org; Mon, 04 Jun 2018 13:07:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fPswg-00069z-LG for bug-gnu-emacs@gnu.org; Mon, 04 Jun 2018 13:07:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:53924) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fPswg-00069g-DC for bug-gnu-emacs@gnu.org; Mon, 04 Jun 2018 13:07:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fPswg-0001NH-0J for bug-gnu-emacs@gnu.org; Mon, 04 Jun 2018 13:07:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Basil L. Contovounesios" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 04 Jun 2018 17:07:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31713 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 31713-submit@debbugs.gnu.org id=B31713.15281319715223 (code B ref 31713); Mon, 04 Jun 2018 17:07:01 +0000 Original-Received: (at 31713) by debbugs.gnu.org; 4 Jun 2018 17:06:11 +0000 Original-Received: from localhost ([127.0.0.1]:33588 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fPsvq-0001M6-VY for submit@debbugs.gnu.org; Mon, 04 Jun 2018 13:06:11 -0400 Original-Received: from mail-wm0-f50.google.com ([74.125.82.50]:53082) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fPsvp-0001Ln-OX for 31713@debbugs.gnu.org; Mon, 04 Jun 2018 13:06:10 -0400 Original-Received: by mail-wm0-f50.google.com with SMTP id p126-v6so6999882wmb.2 for <31713@debbugs.gnu.org>; Mon, 04 Jun 2018 10:06:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:subject:references:date:in-reply-to:message-id:user-agent :mime-version; bh=emEVsVxmw97cwjcZMlls9RQC0uP+cXfbZt3JB21T90A=; b=FrDAi8OU6BKkSlAUsuLwPwjNCLbHQ1DPbAEbbhSEF1fyGhXYViS+QC3T0QR4yyt4Qg leiaUS+mWmedYfvc3hV9fxP/n1wtrJQMnSOmYF/D6vUXIzVjGy0jdsEQWj3k01+SfnI7 JI84ao0CM7gIeo0wvnicN1ZYiiYY6Z6WDIy/4SZbFRp9L3skSymRmVYXkGKHtP3BZN2Z qSxIcBjhhZXKJ1C7cZV7P1iynoKVzJlHeaQVCJJeZX3rKinvlmdTKEb2kCWC6A1PM7z+ rEw74p4GwWjWFqDZPX76CdEPXHMQ7e6JHujVc65bE7UEW3qb8yc4X00ORZXkPIPX9yBo 5z0Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=emEVsVxmw97cwjcZMlls9RQC0uP+cXfbZt3JB21T90A=; b=nqJWyoNZ7+1Oc2o99l/FvyDGv6Xh7cTQVFh+CtgmGxFvKHqauuoeiMEggrJtcWVDUr p18Eo2+vl96mODe2nYACv7VqJz2C/6UKyknUFI0qf+zwTnZ791Z6HDuWk3193j31eG8V PTU8Skjdc93EkpLoxN9o1/5IVe1pQxBEL9DfqUuZEVV0gQKJSaDcTB2r1W3+Pz9YxYUW M/KLakI/+UiUrJaqOcYr+tMYDY2nXK/6YpHDjAl+BFy93Z8Y8EUxVssjP0NuuOSp1VeT kcg1CDzV3uOAqH4+BnEesMZ/wlcW+WpiIAq9CwprjuMS3INSFG3DdOFyHghROYH4blYE rgVw== X-Gm-Message-State: ALKqPwepQUtjejaA5oC7cG28KZMcj5w6ph9x7ynGd8uhKRS2j5GPTURc PvHNpr7ishpUP7puI5R0uucMk8yzUxQ= X-Google-Smtp-Source: ADUXVKJUBeZwOSfG23VcVTyVebMq3r1GnJmiQpqJDM+0loLYr57jJOMLKSurxhXTgxkrDmNzL7jbfA== X-Received: by 2002:aa7:c2cf:: with SMTP id m15-v6mr23952771edp.280.1528131964056; Mon, 04 Jun 2018 10:06:04 -0700 (PDT) Original-Received: from localhost ([213.233.149.10]) by smtp.gmail.com with ESMTPSA id x3-v6sm21808617eda.55.2018.06.04.10.06.02 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 04 Jun 2018 10:06:03 -0700 (PDT) In-Reply-To: <87h8mifq3s.fsf@tcd.ie> (Basil L. Contovounesios's message of "Mon, 04 Jun 2018 17:55:51 +0100") 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:146965 Archived-At: --=-=-= Content-Type: text/plain tags 31713 patch quit --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=0001-Improve-documentation-of-empty-whitespace-style.patch >From 07fd69686c1a8a810d1d4e5a6f09f0785bdfa931 Mon Sep 17 00:00:00 2001 From: "Basil L. Contovounesios" 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 --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable "Basil L. Contovounesios" writes: > The 'empty' whitespace-style option is described under > "(emacs) Useless Whitespace" as follows: > > =E2=80=98empty=E2=80=99 > 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, --=20 Basil --=-=-=--