Editor Controls
This page describes the editor menus, controls, and status displays.
Editor Menus
File Menu
New--Clears the contents of the editor
Open--Opens a new file in the current editor
Reload--Reloads the current file from disk; any unsaved edits are
lost
Save--Saves the current file
Save as--Saves the current file to a new file name
Save all--Saves the contents in all active editors
Close--Closes (quits) the current editor
Edit Menu
Many of these menu items have keyboard accelerators associated with them.
The accelerators are listed to the right the items in the menu.
Undo--Reverses (one at a time) a series of
editor actions (accept Save)
Redo--Reverses (one at a time) a series of
Undo commands
Cut--Cuts the current selection to the clipboard
Copy--Copies the current selection to the clipboard
Paste--Pastes the contents of the
clipboard at the insert point
Delete line--Deletes the line the cursor is on
Insert file--Inserts a file at the cursor
position. Activates a filechooser.
Find--Finds a string of text
Replace--Finds and then replaces a
string of text
Repeat Last--Repeats the last Find or
Replace operation
View Menu
New Window--Starts a new editor window
Use For Tools Display--Instructs the WorkShop to use the current
editor for all tool displays. See Editor Reuse for more information.
Version Menu
This menu contains commands that enable you to check files
in and out of the version control system. See Version Control for more
information about version control commands.
Editor Tool Bar
Open a file--Equivalent to choosing File=>Open
Save the current file--Equivalent to choosing
File=>Save
The remaining controls on the editor tool bar are
available when using other WorkShop tools. For details see:
Editor Footer
The footer in the editor contains a number of different
status displays. These displays enable you to:
See Version Control for more
information about version control commands.
Editor Reuse
Many of the WorkShop tools use the source editor to display
source files. In addition, you can activate
multiple editors for your own editing needs. The WorkShop
source editor provides you with as much control
as possible over allocation of your screen real estate.
Choose View=>Use For Tools Display to control how WorkShop
tools (debugger, Source Browser, Build Manager) use the
source editor to display files.
When View=>Use For Tools Display
is selected (reuse this editor), the right-most icon on the editor footer is
a bullseye over a page:
When View=>Use For Tools Display is not
selected (do not reuse this editor), the right-most icon on the footer is
multiple pages:
Here are some things you should know about how the editor
reuse feature works:
- If the footer toggle in any active editor is set for reuse,
all of the WorkShop tools use that editor window
to display files.
- If you have unsaved changes in a reuse
editor window when a tool attempts to use the editor to display a
file, the WorkShop activates a dialog box. You can open an additional window to
display the file, or you can first save the file that has been
edited and then display the new file.
- Only one active editor can be designated for reuse at
any given time.
- If no active editor is set for reuse, the WorkShop tools
will spawn new editors whenever they display files.
- When a new editor window is opened, either by a tool
or by you (by choosing View=>New Window), it is
always set to be reused. Any already active reuse editor is
reset.
- If you want to preserve the contents of the file loaded
in a reuse editor, turn off the reuse setting so that
a new editor will be used and the existing contents will not be
replaced.
- When you click on the editor control on the main WorkShop tool bar:
- If no editors are already active, a reuse editor is started.
- If only non-reuse editors are already active, a reuse
editor is started.
- If a reuse editor is active, it is brought to the
front of the screen. If the reuse editor is already in front,
no action occurs.
Status Information
Line and Column Status
The line and column text fields display the current location
of the cursor in the file. You can also use these fields to
change the location of the cursor--enter the line and/or the
column number to which you want the cursor to move and press
Return.
Change Status
The change status area displays the following information
about the contents of the editor:
- New File--Indicates that a file has not
been opened in the editor. You can enter text to create
a new file. The status changes to "Unchanged" when you save
the file.
- Unchanged--Indicates that the file opened
in the editor has not been modified. The status changes to
"Changed" when you edit the file, and returns to "Unchanged"
when you save it.
- Changed--Indicates that the file that is open in the
editor has been modified. The status changes to
"Unchanged" when you save the file.
Read/Write Status
The read/write status area indicates whether you can save
your editing changes.
- Read-only--Indicates that the file cannot be
saved to the file system. Read-only status may indicate
that the file is not checked out for editing from the
version control system. You can edit a file that has
read-only status, but you cannot save it to the file name
that it was opened by. Use the Save as menu item to save
the file.
- Writable--Indicates that changes made to the
file can be saved to the same file name that it was opened by.
Version Control Status
The version control status area indicates whether the file is:
- Checked In--Indicates that the file is under
a file version control system, is currently checked into
that system, and is not editable.
- Checked Out--Indicates that the file is
under a file version control system, and is checked out of
that system for editing.
See Version Control for more
information about version control commands.