GNU bug report logs - #18296
24.4.50; doc string of `whitespace-mode'

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Severity: minor; Reported by: Drew Adams <drew.adams@HIDDEN>; dated Tue, 19 Aug 2014 14:32:01 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

Message received at 18296 <at> debbugs.gnu.org:


Received: (at 18296) by debbugs.gnu.org; 30 Apr 2016 17:22:51 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Apr 30 13:22:51 2016
Received: from localhost ([127.0.0.1]:58229 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1awYbT-0003KA-9a
	for submit <at> debbugs.gnu.org; Sat, 30 Apr 2016 13:22:51 -0400
Received: from aserp1040.oracle.com ([141.146.126.69]:43216)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <drew.adams@HIDDEN>) id 1awYbS-0003Jx-2X
 for 18296 <at> debbugs.gnu.org; Sat, 30 Apr 2016 13:22:50 -0400
Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233])
 by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id
 u3UHMieJ001656
 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK);
 Sat, 30 Apr 2016 17:22:44 GMT
Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75])
 by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u3UHMhfW001232
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK);
 Sat, 30 Apr 2016 17:22:44 GMT
Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25])
 by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id u3UHMgsu008232;
 Sat, 30 Apr 2016 17:22:43 GMT
MIME-Version: 1.0
Message-ID: <e0d1ce19-bf90-4cf7-bdeb-9df669adf6dd@default>
Date: Sat, 30 Apr 2016 09:22:39 -0800 (GMT-08:00)
From: Drew Adams <drew.adams@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>, Drew Adams <drew.adams@HIDDEN>
Subject: RE: bug#18296: 24.4.50; doc string of `whitespace-mode'
References: <<33f70bf0-28a5-45d3-ad74-dcc4775ca261@default>
 <87r3dnrzuy.fsf@HIDDEN>> <<e7d578d3-0f13-4bff-a780-9cffd6761845@default>>
 <<83twijnl4t.fsf@HIDDEN>>
In-Reply-To: <<83twijnl4t.fsf@HIDDEN>>
X-Priority: 3
X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9  (901082) [OL
 12.0.6744.5000 (x86)]
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
X-Source-IP: aserv0021.oracle.com [141.146.126.233]
X-Spam-Score: -3.3 (---)
X-Debbugs-Envelope-To: 18296
Cc: 18296 <at> debbugs.gnu.org, larsi@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> IOW, someone should work on this stuff before it can be put
> in a doc string.

I agree.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#18296; Package emacs. Full text available.

Message received at 18296 <at> debbugs.gnu.org:


Received: (at 18296) by debbugs.gnu.org; 30 Apr 2016 15:59:22 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Apr 30 11:59:22 2016
Received: from localhost ([127.0.0.1]:58041 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1awXIg-0007sD-CA
	for submit <at> debbugs.gnu.org; Sat, 30 Apr 2016 11:59:22 -0400
Received: from eggs.gnu.org ([208.118.235.92]:45417)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>) id 1awXIf-0007rm-Gh
 for 18296 <at> debbugs.gnu.org; Sat, 30 Apr 2016 11:59:21 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <eliz@HIDDEN>) id 1awXIQ-0006ZC-RC
 for 18296 <at> debbugs.gnu.org; Sat, 30 Apr 2016 11:59:13 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-0.2 required=5.0 tests=BAYES_50,RP_MATCHES_RCVD
 autolearn=disabled version=3.3.2
Received: from fencepost.gnu.org ([2001:4830:134:3::e]:59801)
 by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <eliz@HIDDEN>)
 id 1awXIQ-0006Y1-ON; Sat, 30 Apr 2016 11:59:06 -0400
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 <eliz@HIDDEN>)
 id 1awXIK-0005uj-LD; Sat, 30 Apr 2016 11:59:01 -0400
Date: Sat, 30 Apr 2016 18:58:58 +0300
Message-Id: <83twijnl4t.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Drew Adams <drew.adams@HIDDEN>
In-reply-to: <e7d578d3-0f13-4bff-a780-9cffd6761845@default> (message from Drew
 Adams on Sat, 30 Apr 2016 07:52:03 -0800 (GMT-08:00))
Subject: Re: bug#18296: 24.4.50; doc string of `whitespace-mode'
References: <33f70bf0-28a5-45d3-ad74-dcc4775ca261@default>
 <87r3dnrzuy.fsf@HIDDEN> <e7d578d3-0f13-4bff-a780-9cffd6761845@default>
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2001:4830:134:3::e
X-Spam-Score: -6.0 (------)
X-Debbugs-Envelope-To: 18296
Cc: 18296 <at> debbugs.gnu.org, larsi@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Reply-To: Eli Zaretskii <eliz@HIDDEN>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -6.0 (------)

> Date: Sat, 30 Apr 2016 07:52:03 -0800 (GMT-08:00)
> From: Drew Adams <drew.adams@HIDDEN>
> Cc: 18296 <at> 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.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#18296; Package emacs. Full text available.

Message received at 18296 <at> debbugs.gnu.org:


Received: (at 18296) by debbugs.gnu.org; 30 Apr 2016 15:52:14 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Apr 30 11:52:13 2016
Received: from localhost ([127.0.0.1]:58012 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1awXBl-0007fr-O8
	for submit <at> debbugs.gnu.org; Sat, 30 Apr 2016 11:52:13 -0400
Received: from userp1040.oracle.com ([156.151.31.81]:17156)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <drew.adams@HIDDEN>) id 1awXBj-0007fe-TP
 for 18296 <at> debbugs.gnu.org; Sat, 30 Apr 2016 11:52:12 -0400
Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74])
 by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id
 u3UFq5lG013518
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Sat, 30 Apr 2016 15:52:06 GMT
Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75])
 by userv0022.oracle.com (8.14.4/8.13.8) with ESMTP id u3UFq5sG013044
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Sat, 30 Apr 2016 15:52:05 GMT
Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25])
 by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id u3UFq5gV013685;
 Sat, 30 Apr 2016 15:52:05 GMT
MIME-Version: 1.0
Message-ID: <e7d578d3-0f13-4bff-a780-9cffd6761845@default>
Date: Sat, 30 Apr 2016 07:52:03 -0800 (GMT-08:00)
From: Drew Adams <drew.adams@HIDDEN>
To: Lars Ingebrigtsen <larsi@HIDDEN>
Subject: RE: bug#18296: 24.4.50; doc string of `whitespace-mode'
References: <33f70bf0-28a5-45d3-ad74-dcc4775ca261@default>
 <87r3dnrzuy.fsf@HIDDEN>
In-Reply-To: <87r3dnrzuy.fsf@HIDDEN>
X-Priority: 3
X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9  (901082) [OL
 12.0.6744.5000 (x86)]
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
X-Source-IP: userv0022.oracle.com [156.151.31.74]
X-Spam-Score: -3.3 (---)
X-Debbugs-Envelope-To: 18296
Cc: 18296 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> > 1. Please mention which faces are used for which kinds of highlighting.
>=20
> Well, there's a lot of faces, and I think it's unusual for modes like
> this to enumerate them.

There are N faces, nicely documented in `whitespace.el'.
Why not put this info in the doc?

`whitespace-space'            highlight SPACE
`whitespace-hspace'           highlight HARD SPACE
`whitespace-tab'              highlight TAB
`whitespace-newline'          highlight NEWLINE char mapping
`whitespace-trailing'=09        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

(Quickly abbreviated from the commentary - not suggesting
that those are the best descriptions.  E.g., what is a newline
char mapping? what is "big" indentation?)

> But perhaps a link to the customisation group would be nice?

That would be OK too.  But the mode help is where I think
it belongs.

> Is there a syntax for that?

Dunno - not that I can think of.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#18296; Package emacs. Full text available.

Message received at 18296 <at> debbugs.gnu.org:


Received: (at 18296) by debbugs.gnu.org; 30 Apr 2016 13:27:23 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Apr 30 09:27:23 2016
Received: from localhost ([127.0.0.1]:56461 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1awUvb-0005UB-MH
	for submit <at> debbugs.gnu.org; Sat, 30 Apr 2016 09:27:23 -0400
Received: from hermes.netfonds.no ([80.91.224.195]:56562)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <larsi@HIDDEN>) id 1awUvZ-0005U0-Hv
 for 18296 <at> debbugs.gnu.org; Sat, 30 Apr 2016 09:27:22 -0400
Received: from cm-84.215.1.64.getinternet.no ([84.215.1.64] helo=mouse)
 by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.84_2) (envelope-from <larsi@HIDDEN>)
 id 1awUvV-0002e7-Sg; Sat, 30 Apr 2016 15:27:19 +0200
From: Lars Ingebrigtsen <larsi@HIDDEN>
To: Drew Adams <drew.adams@HIDDEN>
Subject: Re: bug#18296: 24.4.50; doc string of `whitespace-mode'
References: <33f70bf0-28a5-45d3-ad74-dcc4775ca261@default>
Date: Sat, 30 Apr 2016 15:27:17 +0200
In-Reply-To: <33f70bf0-28a5-45d3-ad74-dcc4775ca261@default> (Drew Adams's
 message of "Tue, 19 Aug 2014 07:30:52 -0700 (PDT)")
Message-ID: <87r3dnrzuy.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 18296
Cc: 18296 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 0.0 (/)

Drew Adams <drew.adams@HIDDEN> writes:

> 1. Please mention which faces are used for which kinds of highlighting.

Well, there's a lot of faces, and I think it's unusual for modes like
this to enumerate them.  But perhaps a link to the customisation group
would be nice?  Is there a syntax for that?

> 2. Wording:
>
>  So, for example, if indentation and indentation::space are
>  included in `whitespace-style' list, the indentation value is
>  evaluated instead of indentation::space value.
>
>  One reason for not visualize spaces via faces (if `face' is not
>  included in `whitespace-style') is to use exclusively for
>  cleaning up a buffer.  See `whitespace-cleanup' and
>  `whitespace-cleanup-region' for documentation.
>
> A minimal fix:
>
>  For example, if `indentation' and `indentation::space' are included in
>  `whitespace-style', the `indentation' value is used instead of the
>  `indentation::space' value.
>
>  One reason to not use faces to visualize spaces (i.e., not include
>  `face' in `whitespace-style') is to use `whitespace-mode' only for
>  cleaning up a buffer.  See `whitespace-cleanup' and
>  `whitespace-cleanup-region'.

Installed.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#18296; Package emacs. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 19 Aug 2014 14:31:36 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Aug 19 10:31:36 2014
Received: from localhost ([127.0.0.1]:47505 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1XJkRj-0000rH-Ss
	for submit <at> debbugs.gnu.org; Tue, 19 Aug 2014 10:31:36 -0400
Received: from eggs.gnu.org ([208.118.235.92]:54841)
 by debbugs.gnu.org with esmtp (Exim 4.80)
 (envelope-from <drew.adams@HIDDEN>) id 1XJkRh-0000r3-6P
 for submit <at> debbugs.gnu.org; Tue, 19 Aug 2014 10:31:34 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <drew.adams@HIDDEN>) id 1XJkRR-0006o8-TP
 for submit <at> debbugs.gnu.org; Tue, 19 Aug 2014 10:31:28 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-0.0 required=5.0 tests=BAYES_20 autolearn=disabled
 version=3.3.2
Received: from lists.gnu.org ([2001:4830:134:3::11]:38613)
 by eggs.gnu.org with esmtp (Exim 4.71)
 (envelope-from <drew.adams@HIDDEN>) id 1XJkRR-0006o4-Qf
 for submit <at> debbugs.gnu.org; Tue, 19 Aug 2014 10:31:17 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:56462)
 by lists.gnu.org with esmtp (Exim 4.71)
 (envelope-from <drew.adams@HIDDEN>) id 1XJkRJ-00041V-1i
 for bug-gnu-emacs@HIDDEN; Tue, 19 Aug 2014 10:31:17 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <drew.adams@HIDDEN>) id 1XJkRA-0006lU-9y
 for bug-gnu-emacs@HIDDEN; Tue, 19 Aug 2014 10:31:08 -0400
Received: from aserp1040.oracle.com ([141.146.126.69]:34882)
 by eggs.gnu.org with esmtp (Exim 4.71)
 (envelope-from <drew.adams@HIDDEN>) id 1XJkRA-0006ky-3h
 for bug-gnu-emacs@HIDDEN; Tue, 19 Aug 2014 10:31:00 -0400
Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93])
 by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id
 s7JEUsqr023772
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK)
 for <bug-gnu-emacs@HIDDEN>; Tue, 19 Aug 2014 14:30:55 GMT
Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231])
 by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s7JEUr8q011041
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO)
 for <bug-gnu-emacs@HIDDEN>; Tue, 19 Aug 2014 14:30:54 GMT
Received: from abhmp0004.oracle.com (abhmp0004.oracle.com [141.146.116.10])
 by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s7JEUrb6018640
 for <bug-gnu-emacs@HIDDEN>; Tue, 19 Aug 2014 14:30:53 GMT
MIME-Version: 1.0
Message-ID: <33f70bf0-28a5-45d3-ad74-dcc4775ca261@default>
Date: Tue, 19 Aug 2014 07:30:52 -0700 (PDT)
From: Drew Adams <drew.adams@HIDDEN>
To: bug-gnu-emacs@HIDDEN
Subject: 24.4.50; doc string of `whitespace-mode'
X-Priority: 3
X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2  (807160) [OL
 12.0.6691.5000 (x86)]
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
X-Source-IP: ucsinet21.oracle.com [156.151.31.93]
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic]
X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address
 (bad octet value).
X-Received-From: 2001:4830:134:3::11
X-Spam-Score: -4.0 (----)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -4.0 (----)

1. Please mention which faces are used for which kinds of highlighting.

2. Wording:

 So, for example, if indentation and indentation::space are
 included in `whitespace-style' list, the indentation value is
 evaluated instead of indentation::space value.

 One reason for not visualize spaces via faces (if `face' is not
 included in `whitespace-style') is to use exclusively for
 cleaning up a buffer.  See `whitespace-cleanup' and
 `whitespace-cleanup-region' for documentation.

A minimal fix:

 For example, if `indentation' and `indentation::space' are included in
 `whitespace-style', the `indentation' value is used instead of the
 `indentation::space' value.

 One reason to not use faces to visualize spaces (i.e., not include
 `face' in `whitespace-style') is to use `whitespace-mode' only for
 cleaning up a buffer.  See `whitespace-cleanup' and
 `whitespace-cleanup-region'.


In GNU Emacs 24.4.50.1 (i686-pc-mingw32)
 of 2014-06-28 on ODIEONE
Bzr revision: 117431 rgm@HIDDEN
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=3D/c/Devel/emacs/snapshot/trunk
 --enable-checking=3Dyes,glyphs 'CFLAGS=3D-O0 -g3'
 LDFLAGS=3D-Lc:/Devel/emacs/lib 'CPPFLAGS=3D-DGC_MCHECK=3D1
 -Ic:/Devel/emacs/include''




Acknowledgement sent to Drew Adams <drew.adams@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#18296; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Sat, 30 Apr 2016 17:30:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.