Syntax


COPY

[file-name ] 

[ from-line  to-line ]   

[ { BEFORE | AFTER }  line-label ]


Operands


file-name 

The name of the file you wish to include in the edit data.

from-line  to-line

Represents the starting line number, and ending line number, of the file you are copying from. If used, both the from-line and the to-line must be present, but need not be in ascending order. If one number is larger than the actual number of lines in the copied file, it is treated like the line number of the last line in the copied file was specified. If both numbers are larger than the actual number of lines in the copied file, the effect is the same as if an empty file were copied. When these numbers are omitted, the entire file is copied.

{ BEFORE | AFTER }

line-label

If specified, the file is copied before, or after, a defined line label. 


If a before/after line label is not specified, the file is copied into the current edit file in one of the following ways:

  • before a B line command
  • after an A line command
  • repeatedly before the lines in a BB block
  • repeatedly after the lines in an AA block
  • into a H/HH block, replacing the existing lines in that H/HH block


Description


COPY adds a copy of data that already exists to the edit session. 


To copy data into an empty file:

On the Command line, type:

COPY filename 


The filename operand is optional. If you do not specify it, the standard Windows file open dialog will be displayed. You may then select the filename in this dialog.


Press Enter. The data is copied.


To copy data into an existing edit file:


Use the A,  B, AA, BB, or H/HH line commands to indicate where the copied data is to be inserted, or use the BEFORE/AFTER line-label option

      • for the A or B command you may not enter a repeat value
      • for the AA and BB command you are allowed to specify the nth line option (see the Help for AA and BB line commands for details)
      • For the H/HH  commands, mark off the line existing lines you want replaced by the file you are copying in
      • To copy the file before or after a label instead of using the A/B line commands, define a label and use BEFORE label or AFTER label.


On the Command line, type:

COPY filename 


The filename operand is optional. If you do not specify it the standard Windows File Open dialog will be displayed. You may then select the filename in this dialog.


Press Enter. The data is copied. 


Note: If the current edit session is not empty, and you do not specify a destination, you will be asked to provide one of the destination options described above.


Determining the Default Directory


When COPY is specified with no filename operand at all, or with just a simple unqualified filename, the folder searched will be the one from which the currently loaded file was read. Or, if an Open dialog is displayed, Open dialog's starting directory will be determined as follows:


If there is a named file being edited in the tab where the command is issued, then the path for named file is used as the default for the command. 


If there is no active file being edited, when the tab header displays (New): 

    • If File Manager is active, the currently displayed directory of File Manager will be used. 
    • If File Manager is not active, then the General Options setting for the Default File Open Directory drop-down will be used, either Last Used Dir or Working Dir. 


Keep in mind that the “Working directory” means the directory that was active when SPFLite was started, if you start it from a command line. If you start SPFLite from a desktop icon, the working directory is the Start path defined in the icon's Property window.

Created with the Personal Edition of HelpNDoc: Upgrade Your Documentation Process with a Help Authoring Tool