Syntax


CLONE

[ filename | * ] [ .prof-name ]


Operands


filename | * 

The name of the file to be cloned. If the filename operand is omitted, and the command is issued from the Edit tab for a file, the filename being edited will be cloned from the current disk version, NOT the edit session contents.


The filename may contain system variables ( %xxx% ) if desired, they will be substituted from the System variable settings.


If a single * is entered, it requests the filename to be fetched from the current clipboard contents.

.prof-name

If entered, you may specify a different Profile name to use. If omitted, the Profile will be assigned in the normal manner, based on the file extension.


Description


The CLONE command will open a new edit session using a copy of the named file. You will be prompted for a new filename to be used for this cloned file. 


When you use CLONE, the cloning action uses the current on-disk version of the filename, not the contents of the file that might exist in any edit session. If you want the cloned session to include the current state of the edit session and there are unsaved changes, then you must SAVE the current session before using the CLONE command.


Because CLONE copies an existing on-disk copy of a file, an on-disk copy of the file must exist. 

That means you cannot CLONE the following:

    • a NEW Empty File
    • a SET Edit session
    • an EFT Edit session
    • a CLIP Edit session


Cloning a file from its contents on disk is the same action that takes place when the Clone line command C is used in File Manager.


Cloning the current Edit / Browse file


If you wish to CLONE the current Edit / Browse session, simply enter CLONE with no operands. .


Created with the Personal Edition of HelpNDoc: iPhone web sites made easy