wguibrow.gml

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

.point Enums
The list box displays enumerator values for the selected enumerator.
.endpoint
.np
You can view detailed information for symbols in the list box by
double-clicking on the symbol.
Other symbols in the header information for the detail view are
highlighted.
Double-clicking on these symbols also displays a detail view.
.*
.beglevel
.*
.section Goto Definition
.*
.np
.ix '&br' 'Goto Definition function'
.ix 'Goto Definition function'
From a detail view,
.us Goto Definition
in the
.us Detail
menu allows you to edit the file that contains the symbol's definition.
The editor is positioned on the line and column containing the symbols
definition.
This allows you to make edits to your source code while you are
browsing.
When you are done, save any changes made and exit the editor to return
to the &br session.
.np
Note that any changes to your source code will make the Browser
database out-of-date.
.*
.section Source References
.*
.np
.ix '&br' 'source references'
.ix 'Source References'
Selecting
.us Source References
from the
.us Detail
menu displays all locations in the source code where a symbol is
referenced.
This allows you to analyze all uses of a particular symbol.
.np
When modifying a symbol, you can use this feature to locate all
occurrences of the symbol in the source code so you can update them.
.begstep To view the source references for a symbol:
.step Position yourself at the detail view of the symbol
whose source references you want to view.
.step Choose
.us Source References
from the
.us Detail
menu.
.result
This opens the
.us Source References
window for the selected symbol.
This window displays the filename, line number, and column number of
each occurrence of the selected symbol in the source code.
.endstep
.figure *depth='4.20' *scale=50 *file='brow9' Use the Source References window to view all the occurrences of the selected symbol in the source code.
.*
.section Symbol References
.*
.np
.ix 'Symbol references'
.ix '&br' 'symbol references'
.us Symbol References
allows you to view a list of all symbols that use a particular
symbol.
When modifying a symbol you can use this feature to locate all
symbols using the modified symbol.
This allows you to determine if all referencing symbols need to be
updated.
.begstep To view the symbol references for a symbol:
.step Position yourself at the detail view of the symbol
whose symbol references you want to view.
.step Choose
.us Symbol References
from the
.us Detail
menu.
.result
This opens the
.us Symbol Referencing
window for the selected symbol.
This window displays a list of all symbols that use the selected
symbol.
The display is the same as the list view of symbols.
Each symbol has a icon indicating its symbol type.
.figure *depth='4.20' *scale=50 *file='brow10' Use the Symbols window to view a list of all symbols that use the selected symbol.
.np
You can perform the same actions in this window as from the
.us List
window.
Refer to the section entitled :HDREF refid='brlist'. for more
information.
.endstep
.np
From this window you can invoke the editor to make changes to the
source code that contains the symbols that reference a particular
symbol.
Select the reference you want to edit in one of two ways:
.begbull
.bull
Double click on the desired reference.
.bull
Click once on the desired reference to select it and press ENTER.
.endbull
.np
This invokes the editor and positions the cursor at the line that
contains the selected reference.
.*
.endlevel
.*
.section Locating Symbols
.*
.np
.ix 'Symbols' 'locating'
.ix '&br' 'locating symbols'
When a global view is displayed and your program contains many
symbols, it can be difficult to scroll through the global view to
locate a particular symbol.
There are two functions that can help you locate a symbol in a global
view:
.begbull $compact
.bull
Find
.bull
Find Selected
.endbull
.*
.beglevel
.*
.section Find
.*
.np
Choose
.us Find
from the
.us Locate
menu to open the
.us Find
dialog.
Use this dialog to specify the criteria to be used to locate a symbol.
For example, you can search for a particular symbol or a set of
symbols with common characteristics.
.figure *depth='1.52' *scale=55 *file='brow11' Use the Find dialog to locate one symbol or a set of symbols.
.*
.beglevel
.*
.section Find Pattern
.*
.np
.ix '&br' 'find pattern'
.ix 'find pattern'
In the
.us Pattern
field of the
.us Find
dialog, enter a pattern for the symbol(s) you wish to locate.
The matching behaviour depends on the switches set in this dialog.
.begpoint $break
.point Match Case
When enabled, the &br performs a case sensitive compare when
attempting to find a match.
.point Match Whole Symbols Only
When enabled, the &br locates symbols that exactly match the specified
pattern.
This switch only applies when the
.us Use Regular Expressions
switch is disabled.
.point Use Regular Expressions
When enabled, the &br interprets the pattern specified as a regular
expression.
The
.us Edit
button, when pressed, displays the
.us Regular Expression Options
dialog.
This dialog allows you to specify the regular expression.
.endpoint
.np
Dropping the combo box of the
.us Pattern
field displays a list of previous patterns entered.
You can select a pattern from this list instead of entering a new one.
.*
.section Find Filters
.*
.np
.ix 'find filters'
.ix '&br' 'find filters'
Clicking on the
.us Filters
button on the
.us Find
dialog opens the
.us Find Filters
dialog.
This dialog allows you to specify the characteristics of the symbol(s)
to be located.
.figure *depth='2.47' *scale=52 *file='brow12' Use the Find Filters dialog to specify characteristics of the symbol(s) you want to locate.
.np
In the
.us Symbol Type
section of the dialog click on the symbol types you want to view.
To search for all symbol types, select the
.us All
button.
.np
In the
.us Symbol Scope
section, you can specify the scope for locating symbols.
.begpoint $break
.point Member of Class:
Specify the class that the symbol must be a member of in order to be
located.
.point Local Symbols of Function:
Specify the function that the symbol must be local to in order to be
located.
.endpoint
.*
.beglevel
.*
.section Find File Filters
.*
.np
The
.us Source Files
button, when pressed, displays the
.us Source Files
dialog that allows you to specify the files to be searched when
attempting to locate a symbol.
This dialog lists
all source files that make up the database file.
Each source file in the list has a check box.
An X in this box indicates that the source file is searched when
trying to locate a symbol.
Click in the check box of the source file you want to disable.
This removes the X. The blank box indicates that the source file will
not be searched when trying to locate a symbol.
To re-enable the source file,
click in the check box again.
This places an X in the box indicating that the source file will be
searched.
.figure *depth='2.89' *scale=52 *file='brow13' Choose the source files to be searched using the Source Files dialog.
.np
The
.us Pattern
section of the dialog, allows you to specify wild card directory
specifications for files that are to be included or excluded in the
search.
For example, specifying "d:\watcom\h\*.h" and pressing the
.us Exclude
button, will prevent any file in the "d:\watcom\h" directory with
extension ".h" from being searched.
To include these files in the search again, specify the same pattern
and press the
.us Include
button.
.np
Pressing the
.us Set All
button includes all files in the search.
.np
Pressing the
.us Clear All
button excludes all files in the search.
This is useful, for example, if you wish to only search files in the
current directory.
Simply press the
.us Clear All
button, specify "*.*" in the Pattern section, and press the
.us Include
button.
.*
.endlevel
.*
.section Performing the Find
.*
.np
Once the filter criteria are set, perform the find operation by
clicking on the
.ul
OK
button on the
.us Find
dialog.
This closes the dialog and performs the search.
The &br examines the symbols in the current global view and selects the
first symbol that matches the search criteria.
.np
To find the next symbol that matches the search criteria, choose
.us Find Next
from the
.us Locate
menu.
.*
.endlevel
.*
.section Find Selected
.*
.np
.ix '&br' 'find selected'
Because the symbols displayed in a global view are often many, only a
portion of the display is visible in the window at any time.
When you temporarily scroll away from the selected symbol or node, a
quick method of locating that symbol is to select
.us Find Selected
from the
.us Locate
menu.
This will immediately locate and display the currently selected symbol
in the global view.
.*
.endlevel
.*
.section *refid='brconf' Configuring the &br
.*
.np
.ix '&br' 'configure'
There are several options in the &br that you can configure:
.begbull $compact
.bull
Regular expression processing for find and query
.bull
Global Symbol Queries
.bull
Enumerator styles for detail views of enumeration constants
.bull
Member filters for detail views of classes
.bull
Auto-arranging of graph views
.bull
Line drawing method for graph views
.bull
Orientation of graph views
.bull
Line styles and &colour.s for inheritance graphs
.bull
Line styles and &colour.s for call graphs
.bull
Selection of text editor
.bull
Automatic saving of options on exit
.endbull
.np
This section describes each configuration option.
.*
.beglevel
.*
.section Regular Expressions for Find and Query
.*
.np
.ix '&br' 'set regular expressions for find'
.ix '&br' 'set regular expressions for queries'
.ix 'regular expressions' 'in &br'
.us Regular Expressions
in the
.us Options
menu allows you to configure the regular expression used to find a
symbol and specify a query.
.figure *depth='2.37' *scale=52 *file='brow14' Use the Regular Expressions Options dialog to configure a regular expression for Find and Query.
.np
Choose
.us Regular Expressions
from the
.us Options
menu to open the
.us Regular Expressions Options
dialog.
In the
.us Search String Meaning
section of the dialog you
select the anchoring method used to find a match.
.begpoint $break
.point Starts With
Matches only if the pattern is found at the beginning of the symbol
.point Contains
Matches if it occurs anywhere in the symbol
.endpoint
.np
In the
.us Regular Expression Characters
section of the dialog you select the characters you want the &br to
interpret as meta-characters.
.np
Select the desired characters by clicking once in the corresponding
check box.
An X in the check box indicates that the character will be interpreted
as a meta-character.
Unchecked characters are matched as standard keyboard characters.
To de-select a character, click again on its check box.
.np
The other buttons on this dialog are:
.begpoint $break
.point Set All
Click on Set All to enable all of the characters.
.point Clear All
Click on Clear All to disable all of the characters.
.point Defaults
Click on Defaults to discard the current settings in this dialog and
replace them with the settings configured at the start of the &br
session.
.point OK
Click on
.us OK
to close this dialog.
This changes the configuration for the current &br session.
.endpoint
.*
.section *refid='brglob' Global Symbol Queries
.*
.np
Choose
.us Query
from the
.us Options
menu to open the
.us Query
dialog.
Use this dialog to specify the criteria to be used to display symbols
in a global view.
.figure *depth='1.52' *scale=55 *file='brow15' Use the Query dialog to configure global view symbol queries.
.*
.beglevel
.*
.section Query Pattern
.*
.np
.ix '&br' 'specifying the query pattern'
.ix 'query pattern'
In the
.us Pattern
field of the
.us Query
dialog, enter a pattern for the symbol(s) you
wish to display in the global views.
The matching behaviour depends on the switches set in this
dialog.
.begpoint $break
.point Match Case
When enabled, the &br performs a case sensitive compare when
attempting to find a match.
.point Match Whole Symbols Only
When enabled, the &br includes symbols that exactly match the specified
pattern.
This switch only applies when the
.us Use Regular Expressions
switch is disabled.
.point Use Regular Expressions
When enabled, the &br interprets the pattern specified as a regular
expression.
The
.us Edit
button is enables and, when pressed, displays the
.us Regular Expression Options
dialog.
This dialog allows you to specify the regular expression.
.endpoint
.np
Dropping the combo box of the
.us Pattern
field displays a list of previous patterns entered.
You can select a pattern from this list instead of entering a new one.
.*
.section Query Filters
.*
.np
.ix 'query filters'
.ix '&br' 'query filters'
Clicking on the
.us Filters
button on the
.us Query
dialog opens the
.us Query Filters
dialog.
This dialog allows you to specify the characteristics of the symbol(s)
to be displayed in the global views.
.np
In the
.us Symbol Type
section of the dialog click on the symbol types you want to view.
To display symbols of all types, click on the
.us All
button.
.np
In the
.us Symbol Scope
section, you can specify the scope of the symbols to be displayed.
.begpoint $break
.point Member of Class:
Specify the class that the symbol must be a member of in order to be
displayed.
.point Local Symbols of Function:
Specify the function that the symbol must be local to in order to be
displayed.
.endpoint
.np
In the
.us Symbol Attributes
section, you can specify the attributes of the symbols to be displayed.
Selecting
.us Artificial
will cause compiler-generated symbols to be displayed.
Selecting
.us Anonymous
will cause unnamed types to be displayed.
Unnamed types will be displayed as square brackets enclosing the
symbols whose type they define.
Selecting
.us Declared Only
will cause only symbols that have been defined to be displayed.
For example, a function prototype for an unreferenced function will
not be displayed when
.us Declared Only
is selected.
.*
.beglevel
.*
.section Query File Filters
.*
.np
The
.us Source Files
button, when pressed, displays the
.us Source Files
dialog that allows you to specify the files that a symbol must be
defined in in order to be displayed.
This dialog lists