This is the readme.txt for WCopy 1.0.1.
It contains brief information of the following items.

1. Installation notes
2. The purpose of WCopy
3. Examples of usage
4. WCopy is shareware
5. Distribution issues
6. Version information
7. Contact information

- - - - - - - - - - - - - - - - - - - - - - - - - - - - 
1. Installation notes
- - - - - - - - - - - - - - - - - - - - - - - - - - - - 

WCopy doesn't need to be installed. It is a stand-alone
executable, that is run from the command prompt. 

WCopy is a 32-bit console application: it can be used
in Windows 95, Windows 98 and NT 4.0.

WCopy cannot be run under DOS or Windows 3.x.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - 
2. The purpose of WCopy
- - - - - - - - - - - - - - - - - - - - - - - - - - - - 

WCopy is a program that concatenates two wav files 
together. WCopy is run from the command line, which
makes it possible to create efficient batches for
concatenating your wav files. (See next section for 
examples of usage)

#1 The command line syntax is the following:

WCopy <infile1> <infile2> <outfile>

<infile1> and <infile2> are the filenames of the wav 
files that need to be concatenated.
<outfile> is the resulting file.

NOTE: These three parameters are _always_ required for
concatenation purpose.

#2 Use the following syntax for displaying information
of the sound file:

WCopy <infile1>


- - - - - - - - - - - - - - - - - - - - - - - - - - - - 
3. Examples of usage
- - - - - - - - - - - - - - - - - - - - - - - - - - - - 

Example 1:
    WCopy first.wav second.wav out.wav

    Explanation: The sound of second.wav is appended at
    the end of the sound of first.wav. The result is 
    stored in out.wav.

Example 2:
    WCopy first.wav second.wav second.wav

    Explanation: The sound of second.wav is appended at
    the end of the sound of first.wav. The result is 
    stored in second.wav.

Example 3:
    WCopy song.wav silence.wav song.wav

    Explanation: silence.wav is added at the end of 
    song.wav. This is a usable feature, if you want to 
    add silence after your songs.

Example 4:
    For %1 in (song*.wav) do WCopy %1 silence.wav %1

    Explanation: silence.wav is added in all files 
    matching the wild card song*.wav. This is extremely 
    powerful if you want to process multiple files at
    once.


Besides the one line commands above, you can create
powerful batch files (*.bat) for processing your wav 
files. For error detection, WCopy returns the following 
exit codes:

  0	WCopy terminates succesfully.
  1	WCopy terminates succesfully showing file information.

File errors:
 -1	No parameters error - WCopy is run without 
	parameters.
 -2	File open error - Either <infile1> or <infile2> 
	can't be opened. Check that the files exist and 
	that they are not in use by another program. 
	WCopy shows, which of the files	caused the error.
 -3	Cannot replace original file - If the destination
	file is	the same as <infile1> or <infile2> a 
	temporary file is created. Before termination 
	the temporary file replaces either of the
	infiles. If this isn't done succesfully, this 
	errorcode is returned.

Wave-format errors:
-10	Input file formats differ. WCopy shows the file 
	information. about the differences.


- - - - - - - - - - - - - - - - - - - - - - - - - - - - 
4. WCopy is shareware
- - - - - - - - - - - - - - - - - - - - - - - - - - - - 

WCopy is shareware. 

The non-registered version of it has one restriction:
the resulting wav file must not exceed 240 seconds in length.

You can get the fully functional version by registering
WCopy. The registration fee is $15 USD. For more info
contact the author: toti@kolumbus.fi


- - - - - - - - - - - - - - - - - - - - - - - - - - - - 
5. Distribution issues
- - - - - - - - - - - - - - - - - - - - - - - - - - - - 

You are allowed to distribute WCopy in any electronic
format on any media. In case of redistribution, following
rules have to be applied:

1.  WCopy must be as WCopy10.zip (Simtel archive package).

2.  The Author (Erik Lindberg) must be mentioned along
    with the email address: toti@kolumbus.fi

3.  The Author must be notified about this: 
    Email: toti@kolumbus.fi 


- - - - - - - - - - - - - - - - - - - - - - - - - - - - 
6. Version information
- - - - - - - - - - - - - - - - - - - - - - - - - - - - 

WCopy version information is available at:
http://www.kolumbus.fi/toti/WCopy


- - - - - - - - - - - - - - - - - - - - - - - - - - - - 
7. Contact information
- - - - - - - - - - - - - - - - - - - - - - - - - - - - 

WCopy home page is located at:

http://www.kolumbus.fi/toti/WCopy

WCopy author can be contacted by email: toti@kolumbus.fi
