wedref.gml

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

.np
To perform an fgrep:
.begstep
.step Choose Fgrep
from the Edit menu.
.result
A dialog appears.
.step Enter the text you want to search for.
.step Select any options you want to use during the search.
.step Click on OK.
.endstep
.np
You can set the default "fgrep" file extensions in the
.us File Specific...
dialog of the Options menu. For a description of the options, refer to
the section entitled :HDREF refid='filespo'..
.np
The
.us Files Containing
dialog shows the name of all files that contain the string as well as
the beginning of the line that contains the string.
.figure *depth='3.20' *scale=66 *file='VI7' The Files Containing Dialog shows you all files with occurrences of a string.
.np
From the Fgrep dialog you can:
.begpoint $break
.point Edit
Select an individual occurrence and open that file. The file opens in
the background, but the Fgrep dialog remains.
.point Goto
Open the selected file for editing at the first occurrence of the search
pattern in the Fgrep dialog.
.point Get All
Open all found files. The files open, with the last one in the list
the currently open file.
.point Cancel
Leave the Fgrep dialog.
.endpoint
.*
.section Configuring the &editor
.*
.np
.ix '&editor' 'configure'
.ix 'configure' '&editor'
The Options menu items contain all of the control and formatting
options available with the &editor.. You can configure the &editor as
you like. Most options apply to the &editor, but some apply only to
the current file. A description of each of the dialogs follows.
.*
.beglevel
.*
.section Status Bar Contents
.*
.np
.ix 'editor' 'status bar settings'
.ix 'status bar' 'editor'
Use the Status Bar Contents dialog to set the contents of the status
bar.
.figure *depth='3.15' *scale=77 *file='VI8' The Status Bar Contents dialog
.np
The options in the Status Bar Contents dialog are divided into three
areas:
.begbull $compact
.bull
Items
.bull
Alignment
.bull
Commands
.endbull
.*
.beglevel
.*
.section Status Bar Contents : Items
.*
.np
.ix 'editor' 'status bar items'
The items in this area are:
.begbull $compact
.bull
Time of day
.bull
Current date
.bull
Current insertion mode
.bull
Line number
.bull
Column number
.bull
Menu help text
.endbull
.np
Any of these items may be dragged to one of the windows in the status
bar.
When an item is dragged to one of these windows, it replaces the
contents of that window.
For example, you can drag the "Date" item into the status bar window
displaying the current line number and the current date will be
displayed in its place.
.figure *depth='2.63' *scale=68 *file='VI9' The Status Bar consists of several small windows
.*
.section Status Bar Contents : Alignment
.*
.np
.ix 'editor' 'status bar alignment'
The items in this area are:
.begbull $compact
.bull
Left aligned
.bull
Center aligned
.bull
Right aligned
.endbull
.np
When any of these items are dragged to a window in the status bar, it
affects the alignment of the item currently displayed in the window.
For example, you can drag the "Center aligned" item (the middle one)
into the status bar window displaying the current time and the current
time will be centered in the window.
.*
.section Status Bar Contents : Commands
.*
.np
.ix 'editor' 'status bar commands'
The items in this area are:
.begbull $compact
.bull
Split
.bull
Clump
.bull
Defaults
.endbull
.np
When the "split" item is dragged to a window in the status bar, the
window is split into two evenly-sized smaller windows.
You can adjust the size of a window by dragging the bar between two
windows to the left or right.
.np
When the "clump" item is dragged to a window in the status bar, the
window is removed from the status bar.
.np
When the "defaults" item is dragged to any place on the status bar,
the default settings for the status bar are re-established.
.*
.endlevel
.*
.section General Options
.*
.np
.ix 'editor' 'general options'
Use the General Options dialog to set the general features of the &editor
including save, search, and word definitions.
.figure *depth='2.85' *scale=68 *file='VI10' The General Options Dialog
.np
The options in the General Options dialog are divided into six categories:
.begbull $compact
.bull
Features
.bull
VI Emulation
.bull
Searching
.bull
Word Definitions
.bull
Filenames/Paths
.bull
Miscellaneous
.endbull
.*
.beglevel
.*
.section General Options : Features
.*
.np
.ix 'editor features'
The Features section allow you to set options such as undo, autosave,
automatic save of configuration, and save of files upon &vip build.
.begpoint $break
.point Undo
.ix '&editor' 'undo'
.ix 'undo' 'setting in &editor'
Turn this option on to allow an unlimited number of undo's.
.point AutoSave
.ix 'autosave' '&editor'
.ix '&editor' 'autosave'
Enable or disable the autosave option. This option allows you to
determine how often a copy of your file is saved to the Temp
Directory. Enter the time in seconds in the Interval box.
.point Save configuration on exit
.ix '&editor' 'save configuration'
.ix 'configure' '&editor'
Turn this option on if you want the &editor to save the current
configuration when you leave the &editor..
.point Save files on IDE build
.ix '&editor' 'save files'
.ix 'save files' '&editor'
Turn this option on if you want the &editor to be notified whenever
you start an IDE make.
It will cause the &editor to prompt you for each file that was
modified and has not been saved to disk since the last make (build).
.endpoint
.*
.section General Options : VI Emulation
.*
.np
.ix 'VI emulation'
Beneath the &editor.'s mild-mannered exterior lurks the
full power of the &company VI editor, complete with scripting,
commands and bookmarks.
Turning on VI emulation causes the &editor to emulate the behaviour of
the &company VI editor.
.*
.section General Options : Searching
.*
.np
.ix 'search and replace' 'options'
Use the Searching options dialog to set the default
search and replace options.
.begpoint $break
.point Ignore case
.ix '&editor' 'ignore case'
.ix 'ignore case'
.ix 'case' 'ignoring'
Turn this option on if you do not want the Search function to match
case when searching for a string.
.point Wrap at EOF
.ix 'EOF' 'wrap at'
.ix '&editor' 'wrap at EOF'
Turn this option on if you want the search to continue at the beginning
of the file when it reaches the end of the file. It will then
continue to the starting point of the search.
.endpoint
.*
.section General Options : Word Definitions
.*
.np
.ix 'word definitions'
.ix 'words' 'defining'
Use the Word Definition options to define pairs or ranges
that are considered valid
parts of a word. The default for Ctrl-Left/Right
.ix 'Ctrl-Left/Right' 'in &editor'
.ix '&editor' 'Ctrl-Left/Right'
is __09AZaz which defines the underscore
character, all numbers, and all upper and lower case letters.
.ix 'mouse clicks' 'defining words for in &editor'
.ix '&editor' 'mouse clicks'
The default for mouse clicks is ::..\__09AZaz which defines the colon,
period, backslash, and underscore characters as well as all numbers,
and upper and lower case letters.
.*
.section General Options : Filenames/Paths
.*
.np
.ix 'directory' 'default in &editor'
.ix '&editor' 'default directory'
.ix 'default directory' 'in &editor'
Use the Filenames/Paths option to define the default directory to
which the &editor writes temporary files and the &editor's history
file.
.np
The Temp Directory is set, by default, from the
.ev TMPDIR
environment variable if it is defined.
.np
Autosave files are written to the Temp Directory.
.*
.section General Options : Miscellaneous
.*
.np
Use the miscellaneous options to set:
.begpoint $break
.point Beep on error
.ix '&editor' 'beep on error'
.ix 'error' 'beep on'
Turn this option on if you want an audible beep to sound when
the &editor encounters an error.
.point Same-file check on open
.ix 'same-file check'
.ix '&editor' 'same-file check'
Use this option to have the &editor check that a file you are opening
is not already open. You can open multiple copies of the same file,
however, the &editor keeps only the last version of the file saved. To
open multiple copies of the same file, you must specify different
paths.
.point Close rotates forward
.ix '&editor' 'rotate files forward'
Turn this option on if you want the &editor to rotate forward through
the open files when you close the current file.
.endpoint
.*
.endlevel
.*
.section *refid=filespo File Specific Options
.*
.np
.ix '&editor' 'file specific options'
.ix 'file specific options'
The File Specific Options dialog contains settings that control your file
including tabs, tags, line numbers, and default file extensions.
.figure *depth='3.20' *scale=63 *file='VI11' The File Specific Options Dialog
The settings are divided into five categories:
.begbull $compact
.bull
Source
.bull
Language
.bull
Tabs
.bull
Tags
.bull
Miscellaneous
.endbull
.*
.beglevel
.*
.section File Specific Options : Source
.*
.np
.ix '&editor' 'source options'
.ix 'source options'
The source section contains a number of options that allow you to control
your source code.
.begpoint $break
.point Read entire file
Turn this on if you want the &editor to read the entire file when it
opens a new file. Turn this option off if you want the &editor to load
small pieces of the file as needed.
.point Check read-only flag
.ix 'read only flag'
Turn this option on if you want files that you open to be read only. You
cannot change or write the files under the same name.
.point Ignore Ctrl-Z
Turn this option on if you want the &editor to ignore Ctrl-Z as the end
of file marker.
.point CRLF Autodetect
Turn this option on if you want the &editor to detect if the file it is
opening has CR and LF at the end of each line. If it does, it will write
the file in the same format.
.point Write CRLFs
.ix 'CRLF' 'write'
Turn this option on if you want both a CR and an LF at the end of each line.
This is the standard format for DOS files.
.point Use eight-bit characters
.ix 'eight-bit characters'
Turn this option on if you want to edit the IBM extended characters,
such as line drawing. If this option is off, you can edit normal text
only.
.endpoint
.*
.section File Specific Options : Language
.*
.np
.ix '&editor' 'language options'
.ix 'language options'
The &editor allows you to highlight different parts of the syntax for the
language you are using. This allows you to easily find the parts of code
you are looking for because they are different &colour.s and/or fonts.
The &editor highlights lexical elements for C, C++, Fortran, Java
and JavaScript, and HTML code (among others).
.np
The Language section also allows you to turn on C Indent Assist.
The &editor then uses common C formatting conventions such as smart
indenting and outdenting with braces.
.*
.section File Specific Options : Tabs
.*
.np
.ix '&editor' 'tabs'
.ix 'tabs'
Use the tab options to define what the tab key does and the tab amounts.
.begpoint $break
.point Tab amount
.ix 'tab width' '&editor'
.ix '&editor' 'tab width'
Set the tab width if real tabs has not been set.
Tab amount specifies the number of spaces indented by tab key.
.point Shiftwidth
.ix '&editor' 'shiftwidth'
.ix 'shiftwidth'
Set the shiftwidth value. The default is four characters.
.point Real Tabs
.ix 'tabs' 'in &editor'
Turn Real Tabs on to use the ASCII tab character instead of spaces when
you press TAB. Turn this option off to have tabs replaced with the
appropriate number of spaces.
.point Hard Tabs
Set the width of hard tabs. The default is eight characters.
.point Autoindent
.ix 'autoindent'
.ix '&editor' 'autoindent'
Turn on the Autoindent feature. Each new line then indents to the same
level as the previous line.
.endpoint
.*
.section File Specific Options : Tags
.*
.np
.ix '&editor' 'tags'
.ix 'tags' 'configuring in the &editor'
Use the Tags options to control the file that contains the list of
code items in your source files.
.begpoint $break
.point Tag File
Enter the name of the tag file that contains your ctags.
.point Ignore Case
Turn this option on, if you want the tag file to ignore the case of
tags.
.point Prompt on multiple tags
Turn this option on, if you want to be prompted when you tag a function
that has multiple entries in the tags file.
.endpoint
.np
Tag files are created by the CTAGS utility, which is described in the 
&company VI editor documentation.
.*
.section File Specific Options : Miscellaneous
.*
.np
.ix '&editor' 'grep extensions'
.ix 'fgrep extensions'
.ix 'grep extensions'
Use the Miscellaneous options to define the default file extensions
for &editor files and to show matching brackets.
.begpoint $break
.point Grep extensions
Define the default file extension to grep when you choose fgrep from
the right mouse button pop-up menu.
.point Show matching brackets
Turn this option on for the cursor to flash to the opening brace when you
type the closing brace.
.ix 'matching brace'
.ix 'brace' 'matching'
.endpoint
.*
.endlevel
.*
.section Screen/Window Options
.*
.np
.ix '&editor' 'screen/window options'
Use the Screen and Window Options dialog to define how you move around
your screen and what appears on it.
.figure *depth='2.51' *scale=80 *file='VI12' The Screen/Window Options Dialog
.*
.beglevel
.*
.section Screen/Window Options : Editing
.*
.np
The Editing section allows you to to define how the text moves around
the screen.
.begpoint $break
.point Jumpy Scrolling
.ix '&editor' 'scrolling'
.ix 'scrolling' '&editor'
Turn this option on to scroll two lines at a time instead of one.
.point Line-based Selection
Turn this option on
to select a whole line no matter where you are in the line when you select
more than one line. You can still however, select part of one line.
If this option is off, you can select any part of the first and last
line in the block of lines you select.
.point Paging
.ix '&editor' 'page up and down'
.ix 'paging' '&editor'
Enter the number of lines that you want to overlap when you use the Page Up
and Page Down keys.
.endpoint
.*
.section Screen/Window Options : Miscellaneous
.*
.np
The Miscellaneous options allow you to set the following:
.begbull
.bull
Enter your own string to appear at the end of the file.
.ix '&editor' 'EOF string'
.ix 'end-of-file string' '&editor'
For example, you may want the word
.ul
END
to appear at the end of the file.
.bull
Save the &editor's screen position when you exit the file.
.bull
Clear messages after the next key is pressed instead of having them
remain until the next error message occurs.
.endbull
.*
.endlevel
.*
.section Saving the Configuration
.*
.np
.ix '&editor' 'saving configuration'
.ix 'saving configuration'
The Save Configuration menu item will save your current configuration
regardless of the status of the "Save configuration on exit" setting.
The configuration information is saved to a
.fi weditor.ini
file either in the user's home directory (on multi-user systems) or
in the Windows system directory.
.*
.endlevel
.*