[svnbook] r4338 committed - * en/book/ch02-basic-usage.xml...

[svnbook at googlecode.com]

Revision: 4338
Author:   cmpilato at gmail.com
Date:     Fri Jan 18 13:31:01 2013
Log:      * en/book/ch02-basic-usage.xml
   (svn.tour.importing.naming): Warning about how different OSes
     allow/disallow certain path names, and recommend that users put some
     thought into such things.

http://code.google.com/p/svnbook/source/detail?r=4338

Modified:
  /trunk/en/book/ch02-basic-usage.xml

=======================================
--- /trunk/en/book/ch02-basic-usage.xml	Mon Sep  3 18:37:31 2012
+++ /trunk/en/book/ch02-basic-usage.xml	Fri Jan 18 13:31:01 2013
@@ -347,6 +347,23 @@
          use it will automatically escape illegal
          path characters as needed in URLs that you type.</para>

+      <warning>
+        <para>Of course, when it comes to choosing valid path names,
+          Subversion isn't the only limiting factor.  Teams using
+          multiple operating systems need to consider the limitations
+          placed on path names by those operating systems, too.  For
+          example, while Windows disallows the use of colon characters
+          in file names, a user on a Linux system can very easily add
+          such a file to version control, resulting in a dataset that
+          can no longer be checked out on Windows.  Adding multiple
+          files to a directory whose names differ only in their letter
+          casing will likewise cause problems for users checking out
+          working copies onto case-insensitive filesystems.  So, some
+          broad awareness of the various limitations introduced by
+          different operating systems and filesystems, then, is
+          recommended.</para>
+      </warning>
+
      </sect2>
    </sect1>