ENH: Write the announcement text and update the README.

git-svn-id: https://svn.enthought.com/svn/sandbox/grin/trunk@72 b5260ef8-a2c4-4e91-82fd-f242746c304a

Author: rkern

ANNOUNCE.txt

@@ -2,13 +2,26 @@ grin is a grep-like tool for recursively searching through text
 files, primarily source code.
 
  Download: http://pypi.python.org/pypi/grin
- Wiki:     https://svn.enthought.com/enthought/wiki/Grin
  SVN:      https://svn.enthought.com/svn/sandbox/grin/trunk
  License:  BSD
 
-grin 1.1.1 is a small bugfix release to clean up the issues found after release
-of 1.1.
+grin 1.2 is a feature release 
 
-  * grin now works with Python 2.4.
-  * The reported version number is now correct.
+  * Add several speed-enhancments from Paul Pelzl.
+
+  * Allow reading of sockets, thanks to Floris Bruynooghe.
+
+  * Added enhanced file extension recognition to handle extensions like # or
+    .tar.gz, thanks to Anders J. Munch.
+
+  * Add grinpython.py example which will search through Python files and only
+    find results in actual code, string literals, or comments, in any
+    combination.
+
+  * Silent handling of KeyboardInterrupt.
+
+  * Bug fixes and small enhancements from Sam Ockman, Adam Gomaa and Larry Hastings.
+
+  * Update the argparse 1.1 to use the new, non-deprecated handling of the
+    --version argument.
 

README.txt

@@ -71,7 +71,7 @@ easy_installable::
 
 Alternatively, download and unpack the tarball and install::
 
-  $ tar zxf grin-1.1.1.tar.gz
+  $ tar zxf grin-1.2.tar.gz
   $ python setup.py install
 
 On UNIX systems, use sudo for the latter command if you need to install the
@@ -219,6 +219,24 @@ that it preprocesses Python files to extract and normalize just the import
 statements. This lets you conveniently and robustly search for import
 statements. Look at "grinimports.py --help" for more information.
 
+examples/grinpython.py allows you to search through Python files and specify whether you want to search through actual Python code, comments or string literals in any combination. For example::
+
+    $ grinpython.py -i --strings grep grin.py
+    grin.py:
+      188 :     """ Grep a single file for a regex by iterating over the lines in a file.
+      292 :         """ Do a full grep.
+    ...
+
+    $ grinpython.py -i --comments grep grin.py
+    grin.py:
+      979 :     # something we want to grep.
+
+    $ grinpython.py -i --python-code grep grin.py
+    grin.py:
+      187 : class GrepText(object):
+      291 :     def do_grep(self, fp):
+    ...
+
 Similarly, it should be straightforward to write small tools like this which
 extract and search text metadata from binary files.
 
@@ -227,9 +245,6 @@ To Do
 -----
 
 * Figure out the story for grepping UTF-8, UTF-16 and UTF-32 Unicode text files.
-* Write some more examples of building small tools on top of grin.
-* Investigate ways to speed up searching. GNU grep is wicked-fast, and I'd like
-  grin to be at least "not slow".
 
 
 Bugs and Such