From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#14731: 24.3.50; doc string of `search-invisible' Date: Thu, 27 Jun 2013 10:31:38 -0700 (PDT) Message-ID: <3e740bbc-086d-4286-8740-1dc5dd36fe66@default> References: <34b6a796-8a11-46cd-bd39-ec906cb1c674@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1372354334 29946 80.91.229.3 (27 Jun 2013 17:32:14 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 27 Jun 2013 17:32:14 +0000 (UTC) Cc: 14731-done@debbugs.gnu.org To: Stefan Monnier Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jun 27 19:32:10 2013 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 1UsG3E-0001ZO-Vr for geb-bug-gnu-emacs@m.gmane.org; Thu, 27 Jun 2013 19:32:09 +0200 Original-Received: from localhost ([::1]:54984 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UsG3E-00061b-EQ for geb-bug-gnu-emacs@m.gmane.org; Thu, 27 Jun 2013 13:32:08 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50899) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UsG39-0005y0-PM for bug-gnu-emacs@gnu.org; Thu, 27 Jun 2013 13:32:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UsG38-0005T4-Rb for bug-gnu-emacs@gnu.org; Thu, 27 Jun 2013 13:32:03 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:51263) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UsG38-0005Sw-OP for bug-gnu-emacs@gnu.org; Thu, 27 Jun 2013 13:32:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1UsG38-00082u-4m for bug-gnu-emacs@gnu.org; Thu, 27 Jun 2013 13:32:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 27 Jun 2013 17:32:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 14731 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 14731-done@debbugs.gnu.org id=D14731.137235431130899 (code D ref 14731); Thu, 27 Jun 2013 17:32:02 +0000 Original-Received: (at 14731-done) by debbugs.gnu.org; 27 Jun 2013 17:31:51 +0000 Original-Received: from localhost ([127.0.0.1]:45579 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UsG2w-00082H-Fh for submit@debbugs.gnu.org; Thu, 27 Jun 2013 13:31:51 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:45858) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1UsG2t-00081w-Bz for 14731-done@debbugs.gnu.org; Thu, 27 Jun 2013 13:31:48 -0400 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by userp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r5RHPLMh002878 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 27 Jun 2013 17:25:22 GMT Original-Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r5RHVdII015950 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 27 Jun 2013 17:31:40 GMT Original-Received: from abhmt119.oracle.com (abhmt119.oracle.com [141.146.116.71]) by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r5RHVduH015944; Thu, 27 Jun 2013 17:31:39 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.7 (607090) [OL 12.0.6668.5000 (x86)] X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:75649 Archived-At: > > "If t incremental search can match hidden text." >=20 > I don't see any reason why non-nil would be better. > People using non-nil non-t values are on their own, Huh? Did you read the rest of the doc string, which mentions `open'? The first line of the doc string should stand on its own. There are specifically three useful values: nil, t, and `open'. t and `open' do not behave the same. And those are the 3 values of user option `search-invisible'. `open' is hardly something hidden from users - they are not "on their own" with `open'. If you prefer, then say "If nil then incremental search does not match hidden text." That is also more correct, because it does not promise more than is delivered. `open' does NOT cause isearch to match text that is hidden using a text property (`invisible'). `open' works only for only certain kinds of hidden text (from specific kinds of overlays, not from text properties). Yes, you can hide behind the ambiguity of the words "CAN match", but it is clearer to say that nil means isearch does not match hidden text. (BTW, this fact is undocumented: t does cause isearch to match such hidden occurrences. Unlike `open', t does not require that the text be hidden using an overlay.)