home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / fileutil / lcopy / lcopy.doc next >
Encoding:
Text File  |  1989-12-05  |  9.1 KB  |  186 lines
  1. TITLE:         ListCopy (LCOPY.EXE) ver 1.05
  2.  
  3. PURPOSE:       Extended file copy program
  4.  
  5. DATE:          12-5-89
  6.  
  7. AUTHOR:        Thomas A. Lundin
  8.                9129 Colfax Avenue South
  9.                Bloomington, MN 55420
  10.                day phone: (612) 588-7571
  11.  
  12. DESCRIPTION:   LCOPY is a file copying program that extends the 
  13.                capabilities of the DOS COPY command. Features in LCOPY are:
  14.                . ability to copy two or more different wild card 
  15.                  specifications at one time
  16.                . ability to copy multiple files through a DIRLIST 
  17.                  (redirected DIR file)
  18.                . option to clear out target subdirectory before copying
  19.                . option to move files (removing source file after copy), 
  20.                  even across drives
  21.                . automatic overwrite protection, which can be optionally 
  22.                  bypassed
  23.                . automatic out-of-space warning which allows switching 
  24.                  floppies before continuing; also provides for optional 
  25.                  disk format before continuing
  26.                . option to prompt for OK before each file is copied
  27.                . option to copy only files that don't exist on target 
  28.                  subdirectory, or that exist as older files
  29.                . option to use DOS read-after-write VERIFY function during 
  30.                  copying
  31.                . option to exclude selected files from being copied
  32.                . runs under DOS and OS/2 real and protected modes
  33.  
  34. OPERATION:     The command line invocation is:
  35.  
  36.                C>lcopy [@]filespec[,[@]filespec,...] [to_path] [/options]
  37.  
  38.                As each file is copied, its name, destination, and size are 
  39.                listed on the screen.
  40.  
  41.                1.   The source "filespec" can consist of a drive, 
  42.                     subdirectory, and file name. Wild cards are allowed. 
  43.                     The file name is the only required portion of the 
  44.                     filespec. If the drive and subdirectory portions are 
  45.                     missing, the current drive and subdirectory will be 
  46.                     used. Multiple filespecs can be entered at one time, 
  47.                     separated by commas. These filespecs can access 
  48.                     different drives, subdirectories, and file names.
  49.                
  50.                2.   An "at-sign" (@) in front of the source filespec 
  51.                     indicates the use of a "dirlist", which is a file that 
  52.                     has been created from a redirected DIR command. For 
  53.                     example, the DOS command
  54.  
  55.                     dir *.txt >dirfile  ─┘ 
  56.  
  57.                     will create a disk file named "dirfile" which contains a 
  58.                     directory of all files with a ".TXT" extension. A 
  59.                     dirlist can be edited with a text editor to end up with 
  60.                     a list of specific, unrelated files to copy in one 
  61.                     pass.
  62.  
  63.                3.   If the "to_path" is missing, files are copied to the 
  64.                     current drive and subdirectory.
  65.                     
  66.                4.   OPTIONS:
  67.                
  68.                     /d   Deletes all files in the "to_path" before copying
  69.                     /m   Moves, rather than copies, files by deleting the 
  70.                          original files after the copy has taken place
  71.                     /o   forces all existing target files to be Overwritten
  72.                     /p   Prompts for confirmation before each file is copied
  73.                     /u   Updates files by copying only files that would be 
  74.                          new or more recent on the target subdirectory
  75.                     /v   use the DOS VERIFY feature
  76.                     /xfilespec[,filespec...]  will eXclude the specified 
  77.                          files from being copied
  78.                                         
  79.                     Options can be entered separately, each with a forward 
  80.                     slash (/d /m /v) or they can be listed in a group, with 
  81.                     a single forward slash (/dmv). (The /x option must be 
  82.                     the last one entered if all options are typed after one 
  83.                     slash.)
  84.                     
  85.                5.   If you're copying from a hard disk to floppy, and the 
  86.                     floppy runs out of space, the following message will 
  87.                     appear:
  88.                     
  89.                     Insert new disk in drive A:
  90.                        Press any key to continue;
  91.                        Press F to format new disk;
  92.                        Press ESC to quit.
  93.                        
  94.                     The any-key and ESC options should be obvious to you. 
  95.                     If you specified the /d option in your command line, 
  96.                     the new disk will be erased before copying continues. 
  97.  
  98.                     Pressing F allows you to format a new disk before 
  99.                     copying continues. The format program is called in one 
  100.                     of two ways:
  101.  
  102.                     1) if you have LFRMT.BAT on your system, it will be 
  103.                        run. This batch file can contain any set of commands 
  104.                        that will format a disk (e.g. FORMAT %1);
  105.                     2) if you do not have LFRMT.BAT on your system, the 
  106.                        program will prompt you to enter a command to format 
  107.                        a disk (e.g. FORMAT A:).
  108.  
  109.                     I have chosen not to automatically invoke the DOS 
  110.                     FORMAT program because there are other third-party 
  111.                     format programs which many people (including me) choose 
  112.                     over DOS. The batch file or prompt seems the best 
  113.                     approach to accommodate flexibility.
  114.                     
  115.                CTRL-C will cancel the program.
  116.                
  117. EXAMPLES:
  118.                C>lcopy *.asc,*.txt,*.dat a: /md
  119.                
  120.                the above command will copy three sets of files, ending in 
  121.                different extensions, to drive A:. The original files will 
  122.                be deleted. Drive A: will be cleared before copying.
  123.                
  124.                C>lcopy @dirlist,d:\lotus\*.wks e:\lotus /o
  125.                
  126.                the above command will copy all files from the list 
  127.                "dirlist", and all *.wks files from drive D: in subdirectory 
  128.                \LOTUS over to drive E: subdirectory \LOTUS. Any existing 
  129.                files will be overwritten.
  130.                
  131.                C>lcopy a:*.* /p
  132.                
  133.                the above command will copy all files from drive A: root 
  134.                directory to the current drive and subdirectory. A prompt 
  135.                must be answered before each file is copied.
  136.                
  137.                C>lcopy *.* a: /x*.exe,*.com,*.bat /v
  138.                
  139.                the above command will copy all files in the current 
  140.                subdirectory to drive A: except for files ending in *.EXE, 
  141.                *.COM, or *.BAT, and will use DOS verify during copying.
  142.                
  143.                C>lcopy d:*.txt /xd:readme.txt,d:order.txt
  144.                
  145.                the above command will copy all files on drive D: ending in 
  146.                *.TXT to the current subdirectory, except for the files 
  147.                D:README.TXT and D:ORDER.TXT
  148.  
  149. NOTES:         The program is written in Lattice C 6.0. Under OS/2, you 
  150.                must use DOS-compatible filenames.
  151.  
  152. MACHINE:       The program will run on any MS-DOS compatible computer using 
  153.                MS-DOS 2.x or higher, with a minimum of 256K RAM, or on any 
  154.                OS/2-compatible computer using Stardard Edition 1.0 or 
  155.                higher, with a minimum of 256K ram.
  156.  
  157. DISCLAIMER:    This program is distributed as user-supported software.  Use 
  158.                it, copy it, give it to your friends.  No warranties, either 
  159.                expressed or implied, are given by the author or distributor of 
  160.                the program, and the user accepts all risk of damage arising 
  161.                out of the application and use of the program.
  162.  
  163. BEG:           If you find this program to be of value, contributions in any 
  164.                amount ($10 suggested) will be gratefully accepted. Please make 
  165.                checks payable to Thomas Lundin.
  166.  
  167.                Send comments/bug reports/contributions to:
  168.  
  169.                          ╔══════════════════════════╗
  170.                          ║     Thomas A. Lundin     ║
  171.                          ║ 9129 Colfax Avenue South ║
  172.                          ║  Bloomington, MN  55420  ║
  173.                          ║ day phone (612) 588-7571 ║
  174.                          ╚══════════════════════════╝
  175.  
  176.                You can also reach me at my BBS home base:
  177.  
  178.                                 PC-ROCKLAND BBS
  179.                       If you can't find a program here,
  180.                           it probably doesn't exist!
  181.                                 (914) 353-2538
  182.                         (Leave msg. for "Tom Lundin")
  183.  
  184.                Thank you for using LCOPY.
  185.  
  186.