
        Readme file for rcopy v. 1.0.0.4

  rcopy is a command line program to recursively copy
  files matching FilePattern to a Destination Folder.
  If FilePattern contains a valid path, it will be set
  as the working directory, or starting point for the copy.
  Otherwise the current path in the command prompt is the
  working directory.  The target folder must already exist.
  No folder structure is created.  All files are copied to
  the same target folder.

  Platform: Windows XP and later both x32 and x64. Itanium
  not supported.

  Install:  Copy the 3 files, rcopy.exe rcopy_slave.exe and
  rcopy_slave_x64.exe to a folder in the PATH.  rcopy.exe
  selects the correct slave program to run depending if the
  OS is 32 bit or 64 bit. The reason for the 2 slave versions
  is on 64 bit Windows, when 32 bit programs are run, some folder
  access is redirected. By running the 64 bit version on the
  64 bit OS, related problems are avoided.

  Usage:

      rcopy

        Run with no args shows Usage MsgBox with Donate Button.
        See this dialog for examples and more information.

      rcopy [/n] FilePattern  DestFolder

        /n = Do Not Overwrite existing files in DestFolder.
        Default is to overwrite target files.

  I wrote rcopy because other command line copy commands such
  as xcopy want to recreate the folder structure in the target.
  The idea of rcopy is to produce the same effect as searching
  a file pattern in Explorer, then dragging the files to a
  target folder, but using the command line.

  Note: When rcopy is run, it does a recursive file search and
  tallies the count of files matching FilePattern. If this total
  is greater than 128, it pops up a MsgBox confirming you wish to
  go ahead with the copy. This is a sanity check to avoid situations
  such as copying *.* in the root of C:\ drive etc..

  Why multiple exe files? The slave programs are written in
  AutoHotKey.  AHK provides no way to compile a console app.
  It cannot output to the command line in a way a user would
  expect from a command line program. The rcopy.exe program
  is a simple AutoIt3 console program to call the correct slave
  program and get the return value, the number of files copied,
  and output that information to the command line.

  AHK has excellent recursive copy capabilities that made it easy
  to write the utility. The reason for multiple exe files is using
  the correct tool for each part of the job.  The file redirection
  used on 64 bit Windows OS is another incentive to use multiple
  processes. Since all 3 exe files total less than 3 MB it's simpler
  just to copy them all to a folder in the PATH.

  Uninstall: None of the programs create any .ini files or Registry
  settings. Just delete the 3 exe files.

  Important Note: I wrote this utility for my own use. You are
  welcome to use it at your own risk. I only have English Language
  versions of Windows for testing. Your mileage may vary. I hope you
  find the utility useful.

  MilesAhead

revisions

v. 1.0.0.4  Initial release.
