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#22036: 25.0.50; (emacs) Lax Search Date: Fri, 27 Nov 2015 20:30:00 -0800 (PST) Message-ID: <6e6838d0-d8c3-4a19-a09f-39d2578b5a0b@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1448685084 18285 80.91.229.3 (28 Nov 2015 04:31:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 28 Nov 2015 04:31:24 +0000 (UTC) To: 22036@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Nov 28 05:31:08 2015 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 1a2XAA-00017b-8k for geb-bug-gnu-emacs@m.gmane.org; Sat, 28 Nov 2015 05:31:06 +0100 Original-Received: from localhost ([::1]:59504 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2XAD-0006Nf-5Y for geb-bug-gnu-emacs@m.gmane.org; Fri, 27 Nov 2015 23:31:09 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55802) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2XA9-0006NW-7H for bug-gnu-emacs@gnu.org; Fri, 27 Nov 2015 23:31:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a2XA6-0006yc-0r for bug-gnu-emacs@gnu.org; Fri, 27 Nov 2015 23:31:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:39532) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2XA5-0006yY-TT for bug-gnu-emacs@gnu.org; Fri, 27 Nov 2015 23:31:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1a2XA5-0000Ad-PU for bug-gnu-emacs@gnu.org; Fri, 27 Nov 2015 23:31:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 28 Nov 2015 04:31:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 22036 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.1448685033621 (code B ref -1); Sat, 28 Nov 2015 04:31:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 28 Nov 2015 04:30:33 +0000 Original-Received: from localhost ([127.0.0.1]:57473 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a2X9c-00009w-5i for submit@debbugs.gnu.org; Fri, 27 Nov 2015 23:30:33 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:45633) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a2X9G-00008e-Bg for submit@debbugs.gnu.org; Fri, 27 Nov 2015 23:30:29 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a2X9E-0006hf-Nn for submit@debbugs.gnu.org; Fri, 27 Nov 2015 23:30:09 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:53212) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2X9E-0006hb-L9 for submit@debbugs.gnu.org; Fri, 27 Nov 2015 23:30:08 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55639) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2X9D-0006IJ-7M for bug-gnu-emacs@gnu.org; Fri, 27 Nov 2015 23:30:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a2X9A-0006dU-0e for bug-gnu-emacs@gnu.org; Fri, 27 Nov 2015 23:30:07 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:29064) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2X99-0006dM-Pa for bug-gnu-emacs@gnu.org; Fri, 27 Nov 2015 23:30:03 -0500 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id tAS4U1dZ012652 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 28 Nov 2015 04:30:01 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id tAS4U1aS012603 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Sat, 28 Nov 2015 04:30:01 GMT Original-Received: from abhmp0016.oracle.com (abhmp0016.oracle.com [141.146.116.22]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id tAS4U1fG028586 for ; Sat, 28 Nov 2015 04:30:01 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] 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-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: 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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:109349 Archived-At: Mostly minor suggestions. And I realize that some of the problems mentioned here are not new - they were already present in node `Special Isearch', for example. But things have deteriorated a bit more, I think. If you can make improvements, that will help readers. 1. "Normally, you'd want", "are normally perceived as equivalent", "letter-case differences usually don't matter", "normally ignore the case", "Searches in Emacs normally perform"... Please rephrase such text. There is nothing "normal" about one behavior or abnormal about the opposite behavior. There is no norm, here. Simply say what the behaviors are and what the default behavior is, without claiming that one is "normal". And it is not the case for all (even most?) users that "letter-case differences usually don't matter". There is no such "usually". Emacs users and use cases are all over the map. Saying "normally" or "usually" can make a reader think that it is important to stick with this behavior, whereas it is just a default that we chose because we thought it would be helpful. 2. Please cross-reference node `Replacement and Lax Matches' (which cross-references node `Lax Search'). 3. Why is regexp search not handled here as well? Why send someone off to node `Regexp Search' for info about lax matching during regexp search? Maybe there is a good reason, but as one user I would expect, a priori, to read all about lax matching here. 4. There is a problem with this text: "Hence, `foo bar' matches `foo bar', `foo bar', `foo bar', and so on (but not `foobar')." Those three are rendered identically - a single SPC char is used to separate the words in all cases. 5. Missing word "off" here? "you can turn lax space matching by typing" 6. Unclear: "To disable this feature entirely". When I read that far, I thought it was talking about disabling the feature of toggling. Also, just say that `M-s ' toggles lax whitespace search - no need to describe what toggling means (off, on again, etc.). 7. Everything in this manual is "in Emacs", so you can drop that phrase everywhere. 8. The explanation of case matching here seems to repeat what is said about it in node `Special Isearch'. More factoring needed, perhaps. 9. "This applies to regular expression search as well as to string search." Literal search, not string search. 10. The same paragraph is also repetitive: you explain the effect of an upper-case char, then you say that if it is removed the effect goes away (OK, but not needed), and then you describe the effect of option `search-upper-case' by repeating the description of the non-nil behavior. 11. "does not extend beyond the current incremental search to the next one" is repetitive. Presumably "to the next" is what was meant by "extend beyond". 12. Choose whether you want the term "character folding" to refer to (1) the general category of folding of chars, including specific kinds of character folding such as case folding and whitespace folding, or (2) what is called by the search and replace UI "character folding", which is just another specific kind of (character) folding. The equivalence classes recognized by this "character folding" (#2) do not include case folding - they are specifically about a set of predefined equivalences other than letter case, equivalences which involve ignoring diacritical marks plus a few others (quote marks etc.). We need to find a clear way to talk about this now, because now is when we are introducing more character folding than just case and whitespace. If you choose #1 then some more specific term is need here and in the UI for #2. It is also the case that, for the moment, at least, the equivalences defined by character-fold.el are a motley crew - diacriticals and compositions plus some ad hoc extras (e.g., quotations). This should all be sorted out before we go too far with this (useful) feature. 13. It's better to drop the future tense and use the present: "will match" -> "matches". 14. "the `nil' value" -> just "`nil'". We don't say "the 4" value; we say "4". Same with `nil', `t', etc. 15. "typing an explicit variant of a character, such as `=E4'". Consider adding the char name after this char, or do something else to help readers see that what is quoted is not just the letter "a". This is not obvious. Maybe a different char choice would be more obvious; dunno. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2015-11-27 Bzr revision: a5f2970207d792e5f5d40160485007f282a0569d Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/Devel/emacs/snapshot/emacs-25 --with-modules --enable-checking=3Dyes --enable-check-lisp-object-type --without-compress-install 'CFLAGS=3D-Og -ggdb3' LDFLAGS=3D-Lc:/Devel/emacs/lib 'CPPFLAGS=3D-DGC_MCHECK=3D1 -Ic:/Devel/emacs/include''