THE RENAME FUNCTION

Access the RENAME function from the WORK menu.  Use RENAME to change file names and paths on ProDOS volumes.  The source path description is changed to the target path description.  RENAME does not allow one to change a file's path to another volume or to a subordinate file of the source file name.

Source files may be subject to filter tests, and wild card matching before passing to the target path.

Follow these steps when performing a RENAME operation:
	(1).  Determine if the correct filters are switched on for USE (if any).
	(2).  Determine that used FILTERS are correctly set.
	(3).  Determine that the OPTION menu switches are set to your satisfaction.
	(4).  Determine if the source and target paths are correctly made.
	(5).  Select the BEGIN button.

The affected file will be relocated and renamed with the modification date updated indicating a change (other file attributes will not change).

INITIAL STATES FOR THE SOURCE AND TARGET PATH DESCRIPTORS:

There are three initial states for both the source and the target paths.

The source path may provide files from:
	(1).  a folder (or a volume  -- seen as the same).
	(2).  a file,
	(3).  a wild card file name.

The target path may rename files to:
	(A).  an existing folder or volume,
	(B).  a file,
	(C).  a new folder(s).

(1).  Results of renaming a source folder:
	(A).  as a folder:  moves the source folder;
	(B).  as an existing file or folder:  invalid;
	(C).  as a new folder path:  creates non-existent target folders and moves the source folder.

(1-A).  Example of renaming a source folder to a target folder:

Source:
:A      <-- folder (volume)

Target:
:B      <-- folder (volume)

Result:
:A becomes :B    <-- Renames source folder (unless folders are filtered out)

(1-C).  Example of renaming a source folder to a new target folder:

Source:
A:System   <-- folder

Target:
:A:System:NewFolder1:NewFolder2:NewFolder3  <-- The folder NewFolder1 does not exist before renaming.

Result:
:B:System:NewFolder1:NewFolder2:NewFolder3  <-- The subdirectories 'NewFolder1', 'NewFolder2' are created, then the source folder 'System' is relocated as 'NewFolder3'.

(2).  Results of renaming a source file:
	(A).  as an existing folder or file:  invalid;
	(B).  to a new file:  relocates source file to the target file path;
	(C).  to a new file with a new path:  creates non-existent target folders and relocates the source file using the target path name.

(2-B).  Example of renaming a source file to a target file:

Source:
:A:Read.Me      <-- file

Target:
:A:System:Please.Read.Me   <-- file

Result:
:A:Read.Me becomes :A:System:Please.Read.Me    <-- Source file relocated using target file path.

(2-C).  Example of renaming a source file to a NEW target path.

Source:
:A:Read.Me      <-- file

Target:
:A:NewFolder1:NewFolder2:Read.Me.First   <-- NewFolder1 does not exist.

Result:
:A:NewFolder1:NewFolder2:Read.Me.First  <-- Creates 'NewFolder1', 'NewFolder2', and then relocates 'Read.Me' to the new target file name 'Read.Me.First'.

(3).  Results of renaming a source wild card file name:
	(A).  as an existing folder or file:  invalid;
	(B).  as a new file or folder:  relocates the source file name using the target file name (see 2-B);
	(C).  as a new folder path:  creates non-existent target folders and relocates the matching source file name.

(3-C).  Example of renaming from a source wild card file name to a new target path:

Source:
:A:?finder?

Passes:
:A:System:Finder.Data

Target:
:A:NewFolder1:Finder.Data    <-- 'NewFolder1' does not exist before BEGIN.

Results:
:A:NewFolder1:Finder.Data    <-- NewFolder1 is created when the target path is scanned for correctness.  'Finder.Data' is relocated to the new folder.

A new target path will be created provided that the source and target paths are syntactically correct, EVEN IF NO FILES ARE ACTUALLY PASSED.

OPTIONS

See the documentation describing OPTIONS.

Make selection dialog will only work when you're choosing from multiple source files.  Thus the selection dialog will only appear when you're using a source wild card file name.

BUTTONS

There are five buttons in the COPY window:  BEGIN, NEXT VOLUME, NEXT DEVICE, CHOOSE PATH, and CHOOSE TEMPLATE.

See the documentation describing common controls.