SF.net SVN: geany: [1437] trunk

[ntrel at users.sourceforge.net]

Revision: 1437
          http://svn.sourceforge.net/geany/?rev=1437&view=rev
Author:   ntrel
Date:     2007-04-05 04:27:44 -0700 (Thu, 05 Apr 2007)

Log Message:
-----------
Add filtering out version control files with Extra options info to
Find in Files section.

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/doc/geany.docbook

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2007-04-05 11:24:10 UTC (rev 1436)
+++ trunk/ChangeLog	2007-04-05 11:27:44 UTC (rev 1437)
@@ -3,6 +3,9 @@
  * tagmanager/tm_workspace.c:
    Write tm_tag_enumerator_t and tm_tag_macro_t (e.g. for GTK_STOCK_*)
    tags when creating a global tags file, and store the pointerOrder.
+ * doc/geany.docbook:
+   Add filtering out version control files with Extra options info to
+   Find in Files section.
 
 
 2007-04-03  Nick Treleaven  <nick.treleaven at btinternet.com>

Modified: trunk/doc/geany.docbook
===================================================================
--- trunk/doc/geany.docbook	2007-04-05 11:24:10 UTC (rev 1436)
+++ trunk/doc/geany.docbook	2007-04-05 11:27:44 UTC (rev 1437)
@@ -635,12 +635,13 @@
 					The search results are shown in the Messages window.
 				</para>
 			</section>
-			<section>
+			<section id="search_fif">
 				<title>Find in files</title>
 				<para>
 					Find in files is a more powerful version of Find usage that searches all files
 					in a certain directory using the Grep tool. The Grep tool must be correctly set
 					in Preferences to the path of the system's Grep utility.
+					GNU Grep is recommended.
 				</para>
 				<para>
 					<figure>
@@ -648,6 +649,33 @@
 					   <graphic fileref="images/find_in_files_dialog.png"></graphic>
 					</figure>
 				</para>
+				<para>
+					The <emphasis>Extra options</emphasis> field is used to pass any additional
+					arguments to the <literal>grep</literal> tool.
+				</para>
+				<section><title>Filtering out version control files</title>
+				<para>
+					When using the <emphasis>Recurse in subfolders</emphasis> option with a
+					directory that's under version control, you can set the
+					<emphasis>Extra options</emphasis> field to use <literal>grep</literal>'s
+					<literal>--exclude</literal> flag to filter out filenames.
+				</para>
+				<para>
+					SVN Example: <literal>--exclude=*.svn-base</literal>
+				</para>
+				<note>
+					<para>
+						The GNU Grep project added support for excluding directories,
+						using the <literal>--exclude-dir</literal> flag.
+						At the time of writing (April 2007) this is unreleased outside
+						of version control.
+						Check your Grep manual to see if your version supports it.
+					</para>
+					<para>
+						Example: <literal>--exclude-dir=.* --exclude-dir=CVS</literal>
+					</para>
+				</note>
+				</section>
 			</section>
 			<section>
 				<title>Replace</title>


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.