wedref.gml

开放源码的编译器open watcom 1.6.0版的源代码

.chap The &edname
.*
:CMT. :helplvl level=3.
.np
The &edname is a text editor designed for the Windows environment. It
contains a toolbar and menu items which you can use to make your
choices. It can use proportional fonts. It also contains drag and drop
toolbars or palettes that allow you to make choices and then simply
drag them to the elements to which you want to apply them.
.figure *depth='2.63' *scale=68 *file='VI0' The &edname
.*
.section Startup Options
.*
.np
When the &editor is started under Windows, a set of default options
are used.
To find out what options are available, modify the "Command Line:" of
.kw Program Item Properties
dialog by adding "-?" after the program name and then start
the &editor..
Alternatively, you can use the Program Manager
.kw Run
dialogue to start the &editor, specifying "-?" after the program name.
.*
.section Using Menus
.*
.np
.ix '&editor menus'
.ix 'menus' '&editor'
The &editor follows standard Windows conventions for its menus.
A brief description of each menu item appears in the status bar
on the bottom right of the screen when you select it.
.np
The File and Edit menus contain items standard to most Windows
applications.
.*
.section Using Drag and Drop Palettes
.*
.np
.ix 'drag and drop dialogs'
.ix 'dialogs' 'drag and drop'
The &editor contains two drag and drop palettes.
You can affect elements of the &editor by dragging and dropping
&colour.s or fonts onto them.
.*
.section Using the Right Mouse Button
.*
.np
.ix 'context-sensitive menus' '&editor'
.ix '&editor context-sensitive menus'
.ix 'right mouse button'
.ix 'mouse button' 'right'
The &editor has two context-sensitive menus&mdash. one for the current
cursor location if less than one line is selected, and one if several
lines are selected. You can access both of
them by clicking on the right mouse button.
.*
.beglevel
.*
.section When Less Than One Line is Selected
.*
.np
When the cursor is in a word or a word is selected you can press the
right mouse button to select the following options:
.begnote $break
.note Windows Help
Choose Windows Help to find information about the currently selected
text.
.note CLib Help
Choose CLib Help to find information from the C Library Reference
manual about the currently selected text.
.note Open
Choose Open to open a new file. The name of the new file is the
selected text.
.ix 'Open' '&editor'
.note Cut
Choose Cut to delete the selected text and place it on the Windows
clipboard.
.note Copy
Choose Copy to copy the selected text to the Windows clipboard and
leave the original.
.note Find
Choose Find to look for the first occurrence of the selected text. The
Find dialog appears.
.note Fgrep
Choose Fgrep to find all files in the current directory which match
the grep default mask and contain the selected text.
.ix 'Fgrep'
.note Tag
Choose Tag to look for a tag whose name is the selected text.
.endnote
.*
.section When More Than One Line is Selected
.*
.np
When several lines are selected, press the right mouse button to
select the following options:
.begnote $break
.note Cut
Choose Cut to delete the selected lines and place them on the Windows
clipboard.
.note Copy
Choose Copy to copy the selected lines to the Windows clipboard and
leave the original lines.
.note >>Shift Right
.ix 'Shift Right'
.ix 'Right' 'Shift'
Choose Shift Right to move the selected lines right by a number of
spaces equal to the shift width setting.
.note <<Shift Left
.ix 'Shift Left'
.ix 'Left' 'Shift'
Choose Shift Left to move the selected lines left by a number of
spaces equal to the shift width setting.
.endnote
.*
.endlevel
.*
.section Starting and Quitting the &editor
.*
.np
.ix '&editor' 'starting and leaving'
.ix 'start' '&editor'
You can start the &editor from within the &company &vip. or through
Windows.
.np
To open the &editor from within the &company &vip., double click on a
source module. To start the &editor from Windows, double click on
the &edname icon.
.np
.ix 'leave' '&editor'
To leave the &editor, choose Exit from the File menu.
.*
.section Opening and Closing Files
.*
.np
.ix '&editor' 'opening files'
.ix 'opening' '&editor files'
.ix '&editor' 'closing files'
.ix 'closing' '&editor files'
There are three items that you can select from the File menu to open
and close files:
.begpoint $break
.point New
Open a new file.
.point Open
Open an existing file.
.point Close
Close an open file.
.endpoint
.*
.beglevel
.*
.section Opening a New File
.*
.ix '&editor' 'open new file'
.ix 'open' '&editor file'
.begstep
.step Start the &editor..
.step Choose New
from the File menu.
.result
An empty text window appears.
.endstep
.*
.section Opening an Existing File
.*
.ix '&editor' 'open existing file'
.ix 'open' '&editor file'
.begstep
.step Start the &editor..
.step Choose Open
from the File menu.
.result
The standard Windows Open dialog appears.
.step Choose the file and click on OK.
.result
You may have to change the current drive and directory to find the
file. The file then opens.
.endstep
.*
.section Closing a File
.*
.np
.ix '&editor' 'closing a file'
.ix 'close' '&editor file'
To close a file, choose Close from the File menu.
.np
You can also close any
open file by choosing File List from the File menu. You can then select
the file from the list of open files and click on the Close button.
.*
.endlevel
.*
.section Saving Files
.*
.np
.ix '&editor' 'save files'
.ix 'save' '&editor files'
There are three items that you can select from the File menu to save
files:
.begpoint $break
.point Save
Save the changes made to the current file.
.point Save As...
Save the current file under a different name. This is the standard
Windows Save As... dialog. When you save the current file with a new
name, only the new file remains open.
.point Save All
Save the changes made to all open files.
.endpoint
.*
.section The &editor Toolbar
.*
.np
.ix '&editor' 'tool bar'
.ix 'tool bar' '&editor'
In the &edname window, the toolbar appears below the menu bar
when the Toggle Toolbar in the Options menu is selected (default). A
check mark beside the menu option indicates that it is enabled. To
disable this feature, choose the option again from the Options menu
and the toolbar disappears.
.figure *depth='2.63' *scale=68 *file='VI1' You can access up to 15 &editor functions from the toolbar.
.np
The following explains the function each icon performs, as well as the
equivalent function on the menu bar.
.begpoint $break
.point New
:HBMP 'new.bmp' i
.ix 'new file'
Open a new file. This is equivalent to New in the File menu.
.point Open
:HBMP 'open.bmp' i
.ix 'open file'
Open a new or existing file. This is equivalent to Open in the File
menu.
.point Save
:HBMP 'save.bmp' i
.ix 'save file'
Save the current file. This is equivalent to Save in the File menu.
.point Cut
:HBMP 'cut.bmp' i
.ix 'cut text'
Delete the selected text to the clipboard.
This is equivalent to Cut in the Edit menu.
.point Copy
:HBMP 'copy.bmp' i
.ix 'copy text'
Copy the selected text to the clipboard.
This is equivalent to Copy in the Edit menu.
.point Paste
:HBMP 'paste.bmp' i
.ix 'paste text'
Insert the clipboard contents at the current cursor position.
This is equivalent to Paste in the Edit menu.
.point Undo
:HBMP 'undo.bmp' i
.ix 'undo change'
Undo the last change to the current file.
This is equivalent to Undo in the Edit menu.
.point Redo
:HBMP 'redo.bmp' i
.ix 're-do change'
Undo the last undo.
This is equivalent to Redo in the Edit menu.
.point Find
:HBMP 'finddlg.bmp' i
.ix 'find text'
Search for the specified text.
This is equivalent to Find in the Edit menu.
.point Find Next
:HBMP 'refind.bmp' i
.ix 'find next'
Repeat the last search.
This is equivalent to Find Next in the Edit menu.
.point Match
:HBMP 'bmatch.bmp' i
.ix 'find match'
.ix 'match text'
Find matching brackets from the current cursor position.
.point File List
:HBMP 'files.bmp' i
.ix 'file list'
.ix 'list files'
Display a list of all files being edited.
This is equivalent to File List in the File menu.
.point Previous File
:HBMP 'prevfile.bmp' i
.ix 'previous file'
Switch to the previous file.
.point Next File
:HBMP 'nextfile.bmp' i
.ix 'next file'
Switch to the next file.
.point IDE
:HBMP 'hammer.bmp' i
.ix 'previous file'
Reactivate the &vip..
This icon is present on the toolbar if the &editor was invoked from
the &vip..
.endpoint
.*
.section Searching Text
.*
.np
.ix 'finding text'
.ix 'searching text'
.ix 'regular expressions'
The &editor has a powerful search function that you can use to locate
strings of text, including regular expressions. For more information
on regular expressions, refer to the
chapter entitled :HDREF refid='regexp'..
.figure *depth='2.53' *scale=80 *file='VI2' The Find Dialog
.np
To search for a string of text:
.begstep
.step Choose Find
from the Edit menu.
.result
The cursor flashes in the Find box.
.step Enter the search string
in the Find box.
.step Set the find options.
.step Click on the Find button.
.result
When the search is successful, you are repositioned to the line
containing the string.
.endstep
.np
You can use Find Next and Find Previous in the Edit menu to repeat a
search for the same string.
.*
.beglevel
.*
.section Setting Search Options
.*
.np
.ix 'find options'
.ix 'search options'
The Find dialog contains a number of default options that you can set
in the
.us General...
dialog of the Options menu. You can change the default settings for
the current session in the Find dialog.
.np
You can set the following options:
.begpoint $break
.point Ignore Case
You can have the search match the case exactly or match the characters
only and ignore the case.
.point Regular Expressions
You can use regular expressions in your "Find" text if you check this
box.
.point Search Backwards
By default, a search is conducted through the lines that follow the
current cursor position.
Select this option if you wish to search backwards from the current
cursor position.
.point Wrap Search
By default, the search ends when it reaches the end of the file.
However, if your search begins in the middle of the file and you want
to search through the whole file, you can set the search to go to the
beginning of the file and continue until it reaches the search
starting point.
.endpoint
.*
.endlevel
.*
.section Replacing Text
.*
.np
.ix 'search and replace'
.ix 'replacing text'
.ix 'regular expressions'
The &editor has a powerful search and replace function that you can
use to replace strings of text, including regular expressions. For
more information on regular expressions, refer to the
chapter entitled :HDREF refid='regexp'..
.figure *depth='3.20' *scale=77 *file='VI3' The Replace Dialog
.np
To search and replace a string of text:
.begstep
.step Choose Replace
from the Edit menu.
.result
The cursor flashes in the Find box.
.step Enter the search string
in the Find box.
.step Press Tab.
.result
The cursor moves to the Replace box.
.step Enter the replace string.
.step Set the replace options.
.step Click on the Replace button.
.result
When the replace is complete, you return to the file.
.np
If the
.us Prompt on Replace
option is turned on, you must confirm each replacement. If it is
off, all occurrences of the string are replaced automatically.
.endstep
.*
.beglevel
.*
.section Setting Search and Replace Options
.*
.np
.ix 'search and replace options'
.ix 'replace options'
The Replace dialog contains a number of default options that you can
set in the
.us General...
dialog of the Options menu. You can change the default settings for
the current session in the Replace dialog.
.np
You can set the following options:
.begpoint $break
.point Ignore Case
You can have the search match the case exactly or match the characters
only and ignore the case.
.point Regular Expressions
You can use regular expressions in your "Find" and "Replace" text if
you check this box.
.point Prompt on Replace
By default, all found strings are replaced with the replace string.
Turn this option on to be prompted for each replacement.
.point Wrap Search
By default, the search ends when it reaches the end of the file.
However, if your search begins in the middle of the file and you want
to search through the whole file, you can set the search to go to the
beginning of the file and continue until it reaches the search
starting point.
.endpoint
.*
.endlevel
.*
.section Changing the Font
.*
.np
.ix '&editor' 'changing the font'
.ix 'fonts' 'changing in &editor'
You can define the font for the message window, status window, and
all syntax elements in the edit buffers.
.np
Within the edit buffer, all fonts must be the same typeface and point
size. Other areas, such as message or status windows, can have
any typeface or point size.
.figure *depth='2.75' *scale=77 *file='VI4' The Font Settings Dialog
.np
You can use the drag and drop feature with the Font dialog.
To use drag and drop:
.ix 'drag and drop'
.begstep
.step Choose Fonts
from the Options menu.
.step Choose the typeface, style, and point size
that you want. A sample of the text appears in the Drag and Drop
box.
.step Click in the drag and drop box and drag the cursor
to the element to which you want to apply the font characteristics.
.result
All elements change to the new font style. All buffers are
affected when you change one.
.endstep
.*
.section Changing &ccolour.s
.*
.np
.ix '&colour.s' 'defining in the &editor'
.ix 'drag and drop'
Use the Colors drag and drop palette to set the &colour of your windows
and code. You can define the &colour of the toolbar, message window,
status window, and all syntax elements in the edit buffers.
.figure *depth='2.72' *scale=77 *file='VI5' The Colors Palette
.np
To change the &colour of an element in your file:
.begstep
.step Choose Colors
from the Options menu.
.step Click on the &colour you want and drag it
to the screen or syntax element to which you want to apply the &colour.
The element is changed to the new &colour.
.result
Use the left mouse button to &colour foreground elements and the right
mouse button to &colour background elements.
.ix 'mouse buttons' 'right and left in the &editor'
.np
Press Control and the right mouse button to affect the &colour of all
backgrounds. Press Control and the left mouse button to affect all
foregrounds.
.endstep
.*
.section Accessing Help
.*
.np
A description of the currently selected option appears in the Status
bar on the bottom right of the screen.
.np
You can also choose items from the Help menu to see more information
about an item.
.*
.section Using Fgrep Capabilities
.*
.np
.ix 'fgrep'
Fgrep stands for
.us File Global Regular Expression and Print.
It is a powerful tool that allows you to search through a number
of files to find all occurrences of a regular expression.
.figure *depth='2.10' *scale=82 *file='VI6' The Fgrep Dialog permits you to search files containing a certain string.