[svnbook commit] r3100 - trunk/src/en/book

[cmpilato]

Author: cmpilato
Date: Tue Jun  3 14:54:57 2008
New Revision: 3100

Log:
* src/en/book/ch03-advanced-topics.xml
  Rewrite the tip regarding 'svn add --force .' for accuracy and clarity.


Modified:
   trunk/src/en/book/ch03-advanced-topics.xml

Modified: trunk/src/en/book/ch03-advanced-topics.xml
==============================================================================
--- trunk/src/en/book/ch03-advanced-topics.xml	(original)
+++ trunk/src/en/book/ch03-advanced-topics.xml	Tue Jun  3 14:54:57 2008
@@ -1471,16 +1471,29 @@
 
     <tip>
       <para>Even if <literal>svn:ignore</literal> is set, you may run
-        into problems if you use shell wildcards in a command (e.g.,
-        <command>svn add *</command>) the <literal>*</literal> will
-        expand into an explicit list of file names.  This
-        will have an effect similar to passing
-        the <option>--no-ignore</option> option to <command>svn
-        add</command>.  Instead of using a wildcard in this case,
-        use <command>svn add --force</command> instead and the files
-        that match your <literal>svn:ignore</literal> property will be
-        ignored.</para>
-    </tip>
+        into problems if you use shell wildcards in a command.  Shell
+        wildcards are expanded into an explicit list of targets before
+        Subversion operates on them, so running <command>svn
+        <replaceable>SUBCOMMAND</replaceable> *</command> is just like
+        running <command>svn <replaceable>SUBCOMMAND</replaceable>
+        file1 file2 file3 …</command>.  In the case of the
+        <command>svn add</command> command, this has an effect similar
+        to passing the <option>--no-ignore</option> option.  So
+        instead of using a wildcard, use <command>svn add --force
+        .</command> to do a bulk scheduling of unversioned things for
+        addition.  The explicit target will ensure that the current
+        directory isn't overlooked because of being already under
+        version control, and the <option>--force</option> option will
+        cause Subversion to crawl through that directory, adding
+        unversioned files while still honoring the
+        <literal>svn:ignore</literal> property and
+        <literal>global-ignores</literal> runtime configuration
+        variable.  Be sure to also provide the <option>--depth
+        files</option> option to the <command>svn add</command>
+        command if you don't want a fully recursive crawl for things
+        to add.</para>
+
+      </tip>
 
   </sect1>