From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#18296: 24.4.50; doc string of `whitespace-mode' Date: Sat, 30 Apr 2016 18:58:58 +0300 Message-ID: <83twijnl4t.fsf@gnu.org> References: <33f70bf0-28a5-45d3-ad74-dcc4775ca261@default> <87r3dnrzuy.fsf@gnus.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1462032044 11467 80.91.229.3 (30 Apr 2016 16:00:44 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 30 Apr 2016 16:00:44 +0000 (UTC) Cc: 18296@debbugs.gnu.org, larsi@gnus.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Apr 30 18:00:35 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1awXJo-0005pI-09 for geb-bug-gnu-emacs@m.gmane.org; Sat, 30 Apr 2016 18:00:32 +0200 Original-Received: from localhost ([::1]:58879 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awXJk-0000Tq-9i for geb-bug-gnu-emacs@m.gmane.org; Sat, 30 Apr 2016 12:00:28 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36660) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awXJZ-0000Fa-VS for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 12:00:24 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1awXJO-0006v4-AP for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 12:00:12 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:45704) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awXJO-0006s2-88 for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 12:00:06 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1awXJK-0007te-Si for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 12:00:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 30 Apr 2016 16:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 18296 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 18296-submit@debbugs.gnu.org id=B18296.146203196230273 (code B ref 18296); Sat, 30 Apr 2016 16:00:02 +0000 Original-Received: (at 18296) by debbugs.gnu.org; 30 Apr 2016 15:59:22 +0000 Original-Received: from localhost ([127.0.0.1]:58041 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awXIg-0007sD-CA for submit@debbugs.gnu.org; Sat, 30 Apr 2016 11:59:22 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:45417) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awXIf-0007rm-Gh for 18296@debbugs.gnu.org; Sat, 30 Apr 2016 11:59:21 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1awXIQ-0006ZC-RC for 18296@debbugs.gnu.org; Sat, 30 Apr 2016 11:59:13 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:59801) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awXIQ-0006Y1-ON; Sat, 30 Apr 2016 11:59:06 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:1844 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1awXIK-0005uj-LD; Sat, 30 Apr 2016 11:59:01 -0400 In-reply-to: (message from Drew Adams on Sat, 30 Apr 2016 07:52:03 -0800 (GMT-08:00)) 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:117364 Archived-At: > Date: Sat, 30 Apr 2016 07:52:03 -0800 (GMT-08:00) > From: Drew Adams > Cc: 18296@debbugs.gnu.org > > There are N faces, nicely documented in `whitespace.el'. > Why not put this info in the doc? Because it is confusing, unless expanded and elaborated. > `whitespace-space' highlight SPACE > `whitespace-hspace' highlight HARD SPACE > `whitespace-tab' highlight TAB > `whitespace-newline' highlight NEWLINE char mapping > `whitespace-trailing' highlight trailing blanks > `whitespace-line' highlight "long" lines > `whitespace-space-before-tab' highlight SPACEs before TAB > `whitespace-indentation' highlight 8+ SPACEs at bol > `whitespace-big-indent' highlight big indentation > `whitespace-empty' highlight empty lines at bob/eob > `whitespace-space-after-tab' highlight 8+ SPACEs after TAB Quick: what's the difference between "big indentation" and "SPACEs before TAB"? How can you determine which one will be applied to a specific line? And what's the difference between "SPACE" and "HARD SPACE"? And what is "NEWLINE char mapping"? Etc., etc. IOW, someone should work on this stuff before it can be put in a doc string.