+---------------------------------+
|  MODIFY COMMAND | MODIFY FILE   |
+---------------------------------+
MODIFY COMMAND <file>
        | MODIFY FILE [<file>]
        [NOEDIT]
        [NOWAIT]
        [RANGE <expN1>, <expN2>]
        [[WINDOW <window name1>]
        [IN [WINDOW] <window name2>
        | SCREEN]]
        [SAVE]

-----------------------------------
Opens a text editor window.
-----------------------------------

This format of MODIFY invokes the FoxPro text editor for editing the
specified <file>.  If the COMMAND option is used, a .PRG extension is
assumed.  This is used for editing program files.  MODIFY FILE is used
for editing text files.  MODIFY COMMAND and MODIFY FILE support a
wildcard file skeleton, enabling you to open editing windows for files
that match a corresponding file template.

Unless an external editor is specified with TEDIT in the FoxPro
CONFIG.FP configuration file, FoxPro's built-in editor is used.

When modifications are made to a program or text file, the updated file
is written to disk.  A backup file with a .BAK extension is created if
you have checked the Make backup check box in the Preferences dialog
which appears when you choose Preferences... from the Edit menu popup.

Clauses
-------

MODIFY COMMAND <file>
        Edits program files.

MODIFY FILE <file>
        Edits text files.

NOEDIT
        The NOEDIT option prevents modification of text or information in the
editing windows opened by the MODIFY COMMAND or MODIFY FILE commands.
Text may be viewed but not changed.

NOWAIT
        When a MODIFY COMMAND or MODIFY FILE command is issued from within a
program, an editing window is opened and program execution is suspended
until the editing window is closed.  The NOWAIT option continues program
execution after the editing window is opened.  The program doesn't wait
for the window to be closed, but continues executing on the program line
immediately following that containing the MODIFY COMMAND or MODIFY FILE
command.

RANGE <expN1>, <expN2>
        The RANGE option lets you open an editing window with a RANGE of
characters already selected.  Characters are selected starting at the
position specified by <expN1>, and are selected up to (but not
including) the <expN2>th character.  If <expN1> is equal to <expN2>, no
characters are selected and the cursor is placed at the position
specified by <expN1> and <expN2>.

WINDOW <window name1>
        You may specify a window that the FoxPro editor will be opened in by
including the optional WINDOW <window name1> clause.  The FoxPro editor
will assume the attributes (GROW, FLOAT, ZOOM etc.) of the window it is
placed in.

IN [WINDOW] <window name2>
        If the IN WINDOW <window name2> option is used, the FoxPro editor is
opened independently within a parent window.  It does not assume the
characteristics of the parent window it is placed in.  FoxPro editor
activated inside a parent window may not be moved outside the parent
window, nor may it be sized larger than the parent window.  If the
parent window is moved, the FoxPro editor moves with it.

        The parent window the FoxPro editor is placed in must first be defined
with the DEFINE WINDOW command.

IN SCREEN
        You may also specifically place a program or text editing window on the
screen by including an IN WINDOW SCREEN or IN SCREEN clause.  These
clauses let you explicitly place a text editing window on the screen
instead of inside a window.  Program or text editing windows are opened
on the screen by default.

SAVE
        The SAVE option keeps an editing window on the screen after leaving the
editing window.  Normally, editing windows opened with the MODIFY
COMMAND and MODIFY FILE commands are removed from the screen after you
leave the editing windows.  This option is only available from within
programs.  Including the SAVE option in the MODIFY COMMAND and MODIFY
FILE commands has no effect when these commands are issued from within
the Command window.

-----------------------------------

See Also:  NOTE | * | &&, SET DEVELOPMENT

-----------------------------------