notes/asp-dot-net-hack.txt

   1           Naming of working copy administrative directories
   2           =================================================
   3
   4 Description:
   5 ============
   6 Allow use of an alternate name for Subversion working copy
   7 administrative directories on Windows (which were formerly always
   8 named ".svn"), by setting the SVN_ASP_DOT_NET_HACK environment variable.
   9 When the variable is set (to any value), the administrative directory
  10 will be "_svn" instead of ".svn".
  11
  12
  13 Use case:
  14 =========
  15 This is a hack to work around unnecessarily restrictive behavior of
  16 ASP.NET on Windows which prevents access to directories beginning with
  17 a dot.
  18
  19
  20 Notes:
  21 ======
  22 Once the environment variable is set, normal working copies with
  23 ".svn" directories will stop working, and will need to be
  24 re-checked-out.
  25
  26 This hack prevents sharing of working copies between Windows and other
  27 operating systems (e.g. over network mounts).
  28
  29 Thread for more details:
  30 http://subversion.tigris.org/servlets/ReadMsg?list=dev&msgNo=105810
  31
  32
  33 Implementation:
  34 ===============
  35 Setting the SVN_ASP_DOT_NET_HACK environment variable only works on
  36 Windows, and only with the svn and svnversion binaries, and the
  37 language bindings.  It doesn't work for the core C libraries
  38 themselves; users of the libraries must call the new,
  39 platform-independent APIs introduced with Subversion 1.3.0 to take
  40 advantage of this work-around:
  41
  42 o svn_wc_is_adm_dir()
  43 o svn_wc_get_adm_dir()
  44 o svn_wc_set_adm_dir() - restricts the list of allowed names to .svn and _svn