Updating README and CHANGELOG for version 1.5.0

Author: leonid-shevtsov

CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog for SearchInProject
 
+## v1.5.0 2015-01-21 "The Tested Release"
+
+* No more using bash to locate executables.
+* Actually, no more using shell when invoking search engine at all! This leads to a huge performance boost on typical systems.
+* The search string is now passed as a single argument to the engine. This means you no longer have to quote special characters.
+* Fix The Silver Searcher empty results incorrectly reporting as an error message.
+* Show error messages in a nice error box instead of the list view.
+* Do not run search with empty query.
+* Do not use selection text as preset query if it is multi-line.
+* Tested for full compatibility with OSX and Linux. Unfortunately, Windows compatibility will have to wait for the next release.
+* Multiple compatibility fixes for ag, ack, git-grep.
+
 ## v1.4.1 2014-06-30
 
 * Fix for erros when search engine output contains binary or non-UTF text

README.md

@@ -1,26 +1,28 @@
-# Search In Project v1.4.0
+# Search In Project
 
-A plugin for [Sublime Text](http://www.sublimetext.com/). Versions 2 and 3 are supported.
-
-## Synopsis
-
-This plugin lets you use your favorite search tool (`grep`, `ack`, `ag`, `git grep`, or `findstr`) to find strings aross your entire current Sublime Text project.
+This plugin for [Sublime Text 2 and 3](http://www.sublimetext.com/) lets you use your favorite search tool (`grep`, `ack`, `ag`, `git grep`, or `findstr`) to find strings aross your entire current Sublime Text project.
 
 It opens a quick selection panel to browse results, and highlights matches inside files.
 
 It's easy to add another search tool, if you so desire.
 
+**Important note for Windows users: the current release has known issues with running executables, I'd appreciate any bug reports from the field.**
+
 ## Installation
 
 * [Package Control](http://sublime.wbond.net): install package **Search in Project** (this is the recommended method)
 
 * Download an [archive of the repository](https://github.com/leonid-shevtsov/SearchInProject_SublimeText/archive/master.zip), and unzip into the Sublime Text Packages folder.
 
+### Installing search engines
+
+My idea is that if you use this plugin it's because you already use one of the superior search engines like [The Silver Searcher](https://github.com/ggreer/the_silver_searcher) and want to use it from within Sublime Text.
+
 ## Usage
 
 * Use the key binding (`⌘⌥⇧F` on OS X, `Ctrl+Alt+Shift+F` on Windows), or
 * Call the "Search in Project" command;
-* Enter the search query; **the query is passed directly to the shell command.** You are responsible for escaping the query, but on the up side you can specify any command line options to go with it. This plugin doesn't make an effort to abstract you away from search tools, but provides a convenient way of running them from Sublime Text 2 instead.
+* Enter the search query;
 * Hit `Enter` (`Return`). In a short while you'll be presented with a "quck select" panel with the search results. Select any file from that panel (it supports fuzzy searching) to go to the match. The search string will be highlighted with an outline and a circle symbol in the gutter area.
 
 If you select text and then run Search In Project, it will pre-fill the search string with the selection text; for example, to search for a word project-wide, do `⌘D, ⌘⌥⇧F, ↩`
@@ -32,7 +34,11 @@ If you run Search In Project again, it will remember the last search string, so
 Configuration is stored in a separate, user-specific `SearchInProject.sublime-settings` file. See the default file for configuration options; links to both could be
 found in the main menu in `Preferences -> Package Settings -> Search In Project`.
 
-You should install and use [ack](http://betterthangrep.com/) instead of the default `grep`/`findstr`, because it's much faster. [Here's how to install ack on Windows](http://stackoverflow.com/questions/1023710/how-can-i-install-and-use-ack-library-on-windows).
+## Issues with locating executables
+
+If Search In Project has problems with locating executables in Mac, install the [Fix Mac Path plugin](https://github.com/int3h/SublimeFixMacPath).
+
+You can always configure the full path to any search engine in the settings, as a catch-all solution.
 
 * * *