$upload->copy_to('/path/to/target');
+Please note the filename used for the copy target is the 'tempname' that
+is the actual filename on the filesystem, NOT the 'filename' that was
+part of the upload headers. This might seem counter intuitive but at this
+point this behavior is so established that its not something we can change.
+
+You can always create your own copy routine that munges the target path
+as you wish.
+
=cut
sub copy_to {
force a particular L<PerlIO> layer. If neither are found the filehandle is
set to :raw.
-This is useful if you are pulling the file into code and inspecting bit and
-maybe then sending those bits back as the response. (Please not this is not
+This is useful if you are pulling the file into code and inspecting bits and
+maybe then sending those bits back as the response. (Please note this is not
a suitable filehandle to set in the body; use C<fh> if you are doing that).
Please note that using this method sets the underlying filehandle IO layer