text: """SCons.Tool.filesystem
  
  Tool-specific initialization for the filesystem tools.
  
  There normally shouldn't be any need to import this module directly.
  It will usually be imported through the generic SCons.Tool.Tool()
  selection method.
  """
  
  #
  # Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 The SCons Foundation
  #
  # Permission is hereby granted, free of charge, to any person obtaining
  # a copy of this software and associated documentation files (the
  # "Software"), to deal in the Software without restriction, including
  # without limitation the rights to use, copy, modify, merge, publish,
  # distribute, sublicense, and/or sell copies of the Software, and to
  # permit persons to whom the Software is furnished to do so, subject to
  # the following conditions:
  #
  # The above copyright notice and this permission notice shall be included
  # in all copies or substantial portions of the Software.
  #
  # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
  # KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  # WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  #
  
  __revision__ = "src/engine/SCons/Tool/filesystem.py 3603 2008/10/10 05:46:45 scons"
  
  import SCons
  from SCons.Tool.install import copyFunc
  
  copyToBuilder, copyAsBuilder = None, None
  
  def copyto_emitter(target, source, env):
      """ changes the path of the source to be under the target (which
      are assumed to be directories.
      """
      n_target = []
  
      for t in target:
          n_target = n_target + map( lambda s, t=t: t.File( str( s ) ), source )
  
      return (n_target, source)
  
  def copy_action_func(target, source, env):
      assert( len(target) == len(source) ), "\ntarget: %s\nsource: %s" %(map(str, target),map(str, source))
  
      for t, s in zip(target, source):
          if copyFunc(t.get_path(), s.get_path(), env):
              return 1
  
      return 0
  
  def copy_action_str(target, source, env):
      return env.subst_target_source(env['COPYSTR'], 0, target, source)
  
  copy_action = SCons.Action.Action( copy_action_func, copy_action_str )
  
  def generate(env):
      try:
          env['BUILDERS']['CopyTo']
          env['BUILDERS']['CopyAs']
      except KeyError, e:
          global copyToBuilder
          if copyToBuilder is None:
              copyToBuilder = SCons.Builder.Builder(
                               action         = copy_action,
                               target_factory = env.fs.Dir,
                               source_factory = env.fs.Entry,
                               multi          = 1,
                               emitter        = [ copyto_emitter, ] )
  
          global copyAsBuilder
          if copyAsBuilder is None:
              copyAsBuilder = SCons.Builder.Builder(
                               action         = copy_action,
                               target_factory = env.fs.Entry,
                               source_factory = env.fs.Entry )
  
          env['BUILDERS']['CopyTo'] = copyToBuilder
          env['BUILDERS']['CopyAs'] = copyAsBuilder
  
          env['COPYSTR'] = 'Copy file(s): "$SOURCES" to "$TARGETS"'
  
  def exists(env):
      return 1
  