第1页 / 共394页
第2页 / 共394页
第3页 / 共394页
第4页 / 共394页
第5页 / 共394页
第6页 / 共394页
第7页 / 共394页
第8页 / 共394页
Source Insight 官方使用手册 pdf版.pdf
CHAPTER 1 Introduction
The Big Picture
Feature Highlights
System Requirements:
Technical Support
CHAPTER 2 Setup and Quick Start
Installing Source Insight
Installing on Windows NT/2000/XP
Upgrading from Version 2
Upgrading from Version 3.0 and 3.1
Insert the CD-ROM
Choosing a Drive for the Installation
Using Version 3 and Version 2 Together
Configuring Source Insight
Entering Your Serial Number
Creating Common Projects
Creating a Project
CHAPTER 3 Window Tour
Source Insight Application Window
Toolbars
Source File Windows
Symbol Windows
Floating Windows
Transparent Floating Windows
Project Window
Opening Files Quickly
Project Window Views
File List View
File Directory View
Symbol List View
File Types View
Symbol Class View
Context Window
Previewing Files
Showing Declarations and Definitions
Decoding Base Types to Show Structures
Customizing the Context Window
Relation Window
Outline and Graph Views
Relationship Types
Relation Window Performance
Relationship Rules
Call Graphs
Multiple Relation Windows
Customizing the Relation Window
Clip Window
What Is A Clip?
Creating a New Clip
Clip Storage
Search Results Window
CHAPTER 4 Source Insight Concepts
Projects
The Current Project
Project Features
Creating a Project
Project Directories
Project Source Directory
Normalized File Names
The Project List
Adding Files to a Project
Removing Files from a Project
Closing Projects
Opening Projects
Removing a Project
Changing Project Settings
Working in a Team Environment
Using a Network
Adding Remote Files to a Project
Using Source Control
Source Control Commands
Source Control Toolbar
Understanding Symbols and Projects
Languages Used to Parse Source Files
Symbol Naming
Updating the Symbol Database
File Names Are Like Symbols
Synchronizing Project Files
Using Common Projects: The Project Symbol Path
Searching the Project Symbol Path
Working With No Project Open
The Base Project
Programming Languages
Built-In Languages
Custom Languages
.Net Framework Support
Using HTML
Using HTML and ASP Compound Languages
Java Language Editing
C/C++ Language Features
Working with Inactive Code - ifdef Support
Conditional Parsing
Condition Variables
Preprocessor Token Macros
Token Macro Files
Parsing Considerations
Coding Tips for Good Parsing Results
Document Types
Document-Specific Options
Associating Files with Document Types
Associating Special File Names
Adding New File Types
Editing the Document Options
Typing Symbol Names with Syllable Indexing
What is a Symbol Syllable?
Symbol Indexes for Projects
Full Name Index.
Member Name Index.
Syllable Index.
Setting Index Options for Projects
Controlling Syllable Matching
Using Syllable Matching
Using Syllable Shortcuts
Analysis Features
Parsing
Symbol Navigation Commands
Jump to Definition command
Jump to Caller command
Refresh Relation Window command
Browse Project Symbols command
Project Window Symbol List
Call Trees and Reference Trees
Context Window
Command Line Symbol Access
Finding References to Symbols
Creating a Project Report
Smart Renaming
Syntax Formatting and Styles
How a Style Works
Formatting Properties
Parent Styles
How Styles Apply to Source Code
Language Keyword Styles
Declaration Styles
Reference Styles
Inactive Code Style
Comment Styles
Comment Heading Styles
Comment Right Style
Single and Multi Line Comment Styles
Comment Styles and Custom Languages
Syntax Decorations
Operator Substitutions
Scaled Nested Parentheses
Goto Arrows
End Brace Annotations
Controlling Syntax Formatting
Changing Style Properties
The Syntax Formatting Command
The Syntax Decorations Command
Turning Off Syntax Formatting
Switching Off Syntax Formatting Temporarily
I Don't Want Fonts to Change
I Want All Characters to Have the Same Width
Searching and Replacing Text
Searching for Symbol References
Renaming an Identifier
Searching the Current File
Replacing in the Current File
Searching Multiple Files
Replacing in Multiple Files
Searching for Keywords
Regular Expressions
Wildcard Matching
Matching the Beginning or End of a Line
Matching a Tab or Space
Matching 0, 1, or More Occurrences
Matching Any in a Set of Characters
Regular Expression Groups
Overriding Regular Expression Characters
Regular Expression Summary
Bookmarks
Navigation with the Selection History
Go Back and Go Forward commands
Navigation Using Source Links
Searching and Source Links
Creating Source Links
Source Links from Custom Command Output
Navigating with Source Links
Scrolling and Selecting Text
Moving Through a File
Scrolling Commands
Selection Commands
Extending the Selection
Selection Shortcuts
Selecting Whole Words
Selecting Whole Functions or Symbols
Selecting Matching Parentheses and Blocks
Selecting the Enclosing Block
Selecting a Whole Line
Selecting the Whole File
Selecting a Paragraph of Text
Selecting Between Lines
File Buffer Basics
Time stamping
What Happens when you Start Source Insight
Recovering From Crashes
Recovery Procedure
Warnings
Command Line Syntax
Specifying File Arguments
Opening Files
How a File is Located
Opening Workspaces
Command Line Options
Suppressing New Program Instances
Running a Source Insight Command
Specifying a Project to Open
Closing the Current Project
Using a Temporary Project
Finding a Symbol
Synchronizing Files in Batch Mode
Suppressing the Splash Screen
User-Level Commands
Custom Commands
Customizing Source Insight
Preferences
Document Options
Key Assignments
Menu Assignments
Loading and Saving Configurations
Project Settings
Project-Specific Configurations
Saving Configurations
Configuration Files
Where Are Configuration Files Stored?
Loading a Configuration
Saving a Configuration
Saving and Restoring Workspaces
Loading and Saving Workspaces
Managing Tasks With Workspaces
Performance Tuning
Factors That Affect Performance
Machine Speed
Project Size
Project Index Settings
Symbol Memory Usage
Virtual Memory Capacity
Physical Memory Capacity
Operating Systems
Custom Parsing Expressions
Location of Files on a Network
Location of the “My Documents” Folder
Speeding Up Program Features
Speeding Up Syntax Formatting
Speeding Up Typing in Browse Dialog Boxes
Speeding Up Building and Synchronizing Projects
Speeding Up Relation Windows
Speeding Up Auto-Completion
Speeding Up .Net Framework Auto-Completion
Speeding Up Searching Files
Speeding Up Lookup References
Files Created by Source Insight
Files in the Program Directory
Per-User Data Folder
Files Created for Each User
Configuration Template for All Users
Files Created for Each Project
CHAPTER 5 Command Reference
Commands Overview
About Source Insight
Activate Menu Commands
Activate Global Symbol List
Activate Relation Window
Activate Search Results
Activate Symbol Window
Add and Remove Project Files
What Files Should You Add to a Project?
Add and Remove Project Files Dialog Box
Add File
Add File List
Advanced Options
Back Tab
Backspace
Beginning of Line
Beginning of Selection
Blank Line Down
Blank Line Up
Block Down
Block Up
Bookmark
Bottom of File
Bottom of Window
Browse Files
Browse Project Symbols
Browse Global Symbols Dialog box
Browse Local File Symbols
Cascade Windows
Checkpoint
Checkpoint All
Clear Highlights
Clip Properties
Clip Window Properties
Close
Close All
Close Project
Close Window
Color Options
Command Shell
Complete Symbol
Context Window
Context Window Properties
Symbol Tracking Options
Copy
Copy Line
Copy Line Right
Copy List
Copy Symbol
Copy To Clip
Create Key List
Create Command List
Cursor Down
Cursor Left
Cursor Right
Cursor Up
Custom Commands
Custom Command Dialog box
The 'Run' Field Format
Running the Command Shell
Command Line Substitutions
ShellExecute Commands
ShellExecute Examples
Running Custom Commands in the Background
Creating a Compile and Build command
Cut
Cut Line
Cut Line Left
Cut Line Right
Cut Selection or Paste
Cut Symbol
Cut To Clip
Cut Word
Cut Word Left
Delete
Delete All Clips
Delete Character
Delete Clip
Delete File
Delete Line
Display Options
Character Spacing Options
Document Options
Document Types
Document Options Dialog box
Auto Indenting
Draft View
Drag Line Down
Drag Line Down More
Drag Line Up
Drag Line Up More
Duplicate
Duplicate Symbol
Edit Condition
Project vs. Global Conditions
Edit Condition Dialog box
Enable Event Handlers
End of Line
End of Selection
Exit
Exit and Suspend
Expand Special
File Options
File Options Dialog box
Folder Options
Folder Options Dialog box
Function Down
Function Up
General Options
General Options Dialog box
Background Tasks
Go Back
Using Go Back to View a Function Call Chain
Go Back Toggle
Go Forward
Go To First Link
First Source Link
Using Links With Compiler Errors
Using Links With Search Output
Go To Line
Go To Next Change
Go To Previous Change
Go To Next Link
Go To Previous Link
Help
Help Mode
Highlight Word
Incremental Search
Incremental Search Mode
Incremental Search Backward
Horizontal Scroll Bar
HTML Help
Indent Left
Indent Right
Insert ASCII
Insert File
Insert Line
Insert Line Before Next
Insert New Line
Join Lines
Jump To Base Type
Jump To Caller
Jump To Definition
Jump To Link
Jump To Prototype
Key Assignments
Key Assignments Dialog box
Numeric Keypad Keys
Assigning Keys and Mouse Clicks
Keyword List
Keywords and Styles
Language Keywords Dialog box
Importing and Exporting Keyword Lists
Language Options
Special Language Options
Language Properties
Language Info
Basic Language Options
Comments and Ranges
Range Definition
Custom Parsing
Custom Parsing Expression
Line Numbers
Link All Windows
Link Window
Load Configuration
Global Configuration
Partial Configurations
Load File
Load Search String
Lock Context Window
Lock Relation Window
Lookup References
Lookup References Dialog box
Keyword Expressions
Keyword Variations
Keyword Search Results
Make Column Selection
Menu Assignments
New
New Clip
New Relation Window
New Project
Where Should You Create A Project?
New Window
Next File
Next Relation Window View
Open
Open Project
Page Down
Page Setup
Header and Footer Codes
Page Up
Paren Left
Paren Right
Parse Source Links
Maintaining Multiple Parse Patterns
Paste
Paste From Clip
Paste Line
Paste Symbol
Play Recording
Preferences
Print
Color Printing
Print Relation Window
Project Document Types
Project File Browser
Project File List
Project Symbol Classes
Project Symbol List
Project Window Properties
Project Settings
Index Performance
Project Report
Project Window command
Rebuild Project
Record New Default Properties
Redo
Redo All
Redraw Screen
Reform Paragraph
Refresh Relation Window
Relation Graph Properties
Relation Window
Relation Window Properties
Relation Window Properties Dialog Box
Relationship Rules
Call Graph Filter
Symbol Type Filter
Symbol Tracking Options
Reload File
Reload Modified Files
Remove File
Remove Project
Remote Options
Rename
Renumber
Repeat Typing
Replace
Replace Files
Restore File
Restore Lines
Save
Save A Copy
Save All
Save Modified Files Dialog Box
Saving Without Prompts
Saving When You Switch to Another Program
Prompting for Each File Separately
Save All Quietly
Save As
Adding a New File to the Current Project
Save Configuration
Having Multiple Configurations
Save Selection
Save Workspace
Working With Multiple Workspaces
Scroll Half Page Down
Scroll Half Page Up
Scroll Left
Scroll Line Down
Scroll Line Up
Scroll Right
SDK Help
Search
Search Backward
Search Backward for Selection
Search Files
To Search a Set of Files
Search Forward
Search Forward for Selection
Search List
Search Project
Searching Options
Select All
Select Block
Select Char Left
Select Char Right
Select Function or Symbol
Select Line
Select Line Down
Select Line Up
Select Match
Select Next Window
Select Sentence
Select Symbol
Select To
Select To End Of File
Select To Top Of File
Select Word
Select Word Left
Select Word Right
Selection History
Setup Common Projects
What Are Common Projects?
Set Common Projects Dialog box
Setup HTML Help
Setup WinHelp File
Show Clipboard
Show File Status
Simple Tab
Smart End of Line
Smart Beginning of Line
Smart Rename
Smart Tab
Smart Tab Examples
Sort Symbol Window
Sort Symbols By Line
Sort Symbols by Name
Sort Symbols By Type
Source Dynamics on the Web
Start Recording
Stop Recording
Style Properties
Formatting Properties
Style Properties Dialog Box
Symbol Info
Symbol Lookup Options
Symbol Window command
Symbol Window Properties
Sync File Windows
Synchronize Files
Syntax Decorations
Syntax Formatting
Basic Options
Apply Styles for Language Elements
Comment Headings
Symbol Reference Lookups
Tile Horizontal
Tile One Window
Tile Two Windows
Tile Vertical
Toggle Insert Mode
Top of File
Top of Window
Touch All Files in Relation
Typing Options
Undo
Undoing Cursor Movement
Undoing All Changes
The Undo History
Restoring Lines
Undo All
Vertical Scroll Bar
View Clip
View Relation Outline
View Relation Window Horizontal Graph
View Relation Window Vertical Graph
Window List
Word Left
Word Right
Zoom Window
CHAPTER 6 Macro Language Guide
Macro Language Overview
Basic Syntax Rules
Macro Functions
Macro Scopes and References
Running Macros
Macros as Commands
Running Inline Macro Statements
Statements
Variables
Declaring a Variable
Variable Initialization
Global Variables
Variable Name Expansion
Expanding Variables in a String
Variable Arithmetic
Indexing Into Strings
Record Variables
Record Variable Storage
Array Techniques
Special Constants
Operators
Conditions and Loops: if-else and while
The if Statement
The while statement
Break and Continue
Conditional Evaluation
Naming Conventions
Standard Record Structures
Bookmark Record
Bufprop Record
DIM Record
Link Record
ProgEnvInfo Record
ProgInfo Record
Rect Record
Selection Record
Symbol Record
SYSTIME Record
Internal Macro Functions
String Functions
AsciiFromChar (ch)
cat (a, b)
CharFromAscii (ascii_code)
islower (ch)
IsNumber (s)
isupper (ch)
strlen (s)
strmid (s, ichFirst, ichLim)
strtrunc (s, cch)
tolower (s)
toupper (s)
User Input and Output Functions
Ask (prompt_string)
AssignKeyToCmd(key_value, cmd_name)
Beep ()
CharFromKey (key_code)
CmdFromKey(key_value)
EndMsg ()
FuncFromKey (key_code)
GetChar ()
GetKey ()
GetSysTime(fLocalTime)
IsAltKeyDown (key_code)
IsCtrlKeyDown (key_code)
IsFuncKey (key_code)
KeyFromChar(char, fCtrl, fShift, fAlt)
Msg (s)
StartMsg (s)
Buffer List Functions
BufListCount ()
BufListItem (index)
File Buffer Functions
AppendBufLine (hbuf, s)
ClearBuf (hbuf)
CloseBuf (hbuf)
CopyBufLine (hbuf, ln)
DelBufLine (hbuf, ln)
GetBufHandle (filename)
GetBufLine (hbuf, ln)
GetBufLineCount (hbuf)
GetBufLineLength (hbuf, ln)
GetBufLnCur (hbuf)
GetBufName (hbuf)
GetBufProps (hbuf)
GetBufSelText (hbuf)
GetCurrentBuf ()
InsBufLine (hbuf, ln, s)
IsBufDirty (hbuf)
IsBufRW (hbuf)
MakeBufClip (hbuf, fClip)
NewBuf (name)
OpenBuf (filename)
OpenMiscFile (filename)
PasteBufLine (hbuf, ln)
PrintBuf (hbuf, fUseDialogBox)
PutBufLine (hbuf, ln, s)
RenameBuf (hbuf, szNewName)
SaveBuf (hbuf)
SaveBufAs (hbuf, filename)
SetBufDirty (hbuf, fDirty)
SetBufIns (hbuf, ln, ich)
SetBufSelText (hbuf, s)
SetCurrentBuf (hbuf)
Environment and Process Functions
GetEnv (env_name)
GetReg (reg_key_name)
IsCmdEnabled (cmd_name)
PutEnv (env_name, value)
RunCmd (cmd_name)
RunCmdLine (sCmdLine, sWorkingDirectory, fWait)
SetReg (reg_key_name, value)
ShellExecute (sVerb, sFile, sExtraParams, sWorkingDirectory, windowstate)
ShellExecute Parameters
sVerb Values
Window List Functions
WndListCount ()
WndListItem (index)
Window Functions
CloseWnd (hwnd)
GetApplicationWnd ()
GetCurrentWnd ()
GetNextWnd (hwnd)
GetWndBuf (hwnd)
GetWndClientRect (hwnd)
GetWndDim (hwnd)
GetWndHandle (hbuf)
GetWndHorizScroll (hwnd)
GetWndLineCount (hwnd)
GetWndLineWidth (hwnd, ln, cch)
GetWndParent (hwnd)
GetWndRect (hwnd)
GetWndSel (hwnd)
GetWndSelIchFirst (hwnd)
GetWndSelIchLim (hwnd)
GetWndSelLnFirst (hwnd)
GetWndSelLnLast (hwnd)
GetWndVertScroll (hwnd)
IchFromXpos (hwnd, ln, xp)
IsWndMax (hwnd)
IsWndMin (hwnd)
IsWndRestored (hwnd)
MaximizeWnd (hwnd)
MinimizeWnd (hwnd)
NewWnd (hbuf)
ScrollWndHoriz (hwnd, pixel_count)
ScrollWndToLine (hwnd, ln)
ScrollWndVert (hwnd, line_count)
SetCurrentWnd (hwnd)
SetWndRect (hwnd, left, top, right, bottom)
SetWndSel (hwnd, selection_record)
ToggleWndMax (hwnd)
XposFromIch (hwnd, ln, ich)
Bookmark Functions
BookmarksAdd (name, filename, ln, ich)
BookmarksCount ()
BookmarksDelete (name)
BookmarksItem (index)
BookmarksLookupLine (filename, ln)
BookmarksLookupName (name)
Symbol List Functions
SymListCount ()
SymListFree (hsyml)
SymListInsert (hsyml, isym, symbolNew)
SymListItem (hsyml, isym)
SymListNew ()
SymListRemove (hsyml, isym)
Symbol Functions
Symbol Record
GetBufSymCount(hbuf)
GetBufSymLocation(hbuf, isym)
GetBufSymName(hbuf, isym)
GetCurSymbol ()
GetSymbolLine (symbol_name)
GetSymbolLocation (symbol_name)
Locating File Names
GetSymbolLocationEx (symbol_name, output_buffer, fMatchCase, LocateFiles, fLocateSymbols)
Locating File Names
GetSymbolFromCursor (hbuf, ln, ich)
GetSymbolLocationFromLn (hbuf, ln)
JumpToLocation (symbol_record)
JumpToSymbolDef (symbol_name)
SymbolChildren (symbol)
SymbolContainerName (symbol)
SymbolDeclaredType (symbol)
SymbolLeafName (symbol)
SymbolParent (symbol)
SymbolRootContainer (symbol)
SymbolStructureType (symbol)
Searching Functions
GetSourceLink (hbufSource, lnSource)
LoadSearchPattern(pattern, fMatchCase, fRegExp, fWholeWordsOnly)
ReplaceInBuf(hbuf, oldPattern, newPattern, lnStart, lnLim, fMatchCase, fRegExp, fWholeWordsOnly, fConfirm)
SearchForRefs (hbuf, word, fTouchFiles)
SearchInBuf (hbuf, pattern, lnStart, ichStart, fMatchCase, fRegExp, fWholeWordsOnly)
SetSourceLink (hbufSource, lnSource, target_file, lnTarget)
Project Functions
AddConditionVariable(hprj, szName, szValue)
AddFileToProj(hprj, filename)
CloseProj (hprj)
DeleteConditionVariable(hprj, szName)
DeleteProj (proj_name)
EmptyProj ()
GetCurrentProj ()
GetProjDir (hprj)
GetProjFileCount (hprj)
GetProjFileName (hprj, ifile)
GetProjName (hprj)
GetProjSymCount (hprj)
GetProjSymLocation (hprj, isym)
GetProjSymName (hprj, isym)
NewProj (proj_name)
OpenProj (proj_name)
RemoveFileFromProj(hprj, filename)
SyncProj (hprj)
SyncProjEx(hprj, fAddNewFiles, fForceAll, fSupressWarnings)
Miscellaneous Macro Functions
DumpMacroState (hbufOutput)
GetProgramEnvironmentInfo ()
GetProgramInfo ()
Other Information about Macros
Debugging
Persistence
No Self-Modifying Macros
Sample Macros
Event Handlers
CHAPTER 7 Macro Event Handlers
Macro Event Handlers
Event Handler Uses
Adding Event Handlers to Source Insight
Enabling Event Handlers
Editing Event Handler Files
Errors in Event Handlers
Synchronous Vs. Asynchronous Events
Other Tips
Application Events
event AppStart()
event AppShutdown()
event AppCommand(sCommand)
Document Events
event DocumentNew(sFile)
event DocumentOpen(sFile)
event DocumentClose(sFile)
event DocumentSave(sFile)
event DocumentSaveComplete(sFile)
event DocumentChanged(sFile)
event DocumentSelectionChanged(sFile)
Project Events
event ProjectOpen(sProject)
event ProjectClose(sProject)
Statusbar Events
event StatusbarUpdate(sMessage)
CHAPTER 8 Appendix: Upgrading From Older Versions
Upgrading from Version 3.1 or Version 3.0
Per-User Data Folder
Per-User Project List
Project File Storage
Custom Command Directory Expansion
.Net Framework Support
Upgrading from Version 2
Installing Version 3
Opening Older Projects
Finding Your Old Projects
Loading Old Customizations
Using Version 3 and Version 2 Together
What's New in Version 3
Improved Language Features
Improved Browsing and Analysis Features
Improved Editing and Display Features
New Commands
New Command List
File Format Compatibility with Older Versions
CHAPTER 9 License Agreement
Contents
Contents
CHAPTER 1
INTRODUCTION ........................................................................................ 1
The Big Picture ................................................................................................. 2
Feature Highlights............................................................................................ 3
System Requirements:.............................................................................................14
Technical Support .......................................................................................... 14
CHAPTER 2
SETUP AND QUICK START........................................................................ 15
Installing Source Insight................................................................................. 15
Installing on Windows NT/2000/XP .........................................................................15
Upgrading from Version 2.......................................................................................15
Upgrading from Version 3.0 and 3.1 ........................................................................16
Insert the CD-ROM..................................................................................................16
Choosing a Drive for the Installation .......................................................................16
Using Version 3 and Version 2 Together ...................................................................17
Configuring Source Insight .....................................................................................17
Entering Your Serial Number ...................................................................................17
Creating Common Projects .....................................................................................17
Creating a Project ...................................................................................................18
CHAPTER 3 WINDOW TOUR ...................................................................................... 21
Source Insight Application Window............................................................... 21
Toolbars ......................................................................................................... 22
Source File Windows ...................................................................................... 26
Symbol Windows ........................................................................................... 27
Floating Windows .......................................................................................... 29
Project Window.............................................................................................. 30
Opening Files Quickly .............................................................................................31
Project Window Views.............................................................................................31
Context Window ............................................................................................ 34
Previewing Files ......................................................................................................35
Showing Declarations and Definitions ....................................................................35
Decoding Base Types to Show Structures.................................................................37
Customizing the Context Window ..........................................................................38
Source Insight User Manual
i
Contents
CHAPTER 4
Relation Window............................................................................................ 39
Outline and Graph Views........................................................................................ 40
Relationship Types ................................................................................................. 40
Relation Window Performance............................................................................... 40
Relationship Rules.................................................................................................. 41
Call Graphs............................................................................................................ 41
Multiple Relation Windows..................................................................................... 41
Customizing the Relation Window.......................................................................... 41
Clip Window................................................................................................... 42
What Is A Clip? ....................................................................................................... 42
Creating a New Clip ............................................................................................... 42
Clip Storage ........................................................................................................... 43
Search Results Window.................................................................................. 43
SOURCE INSIGHT CONCEPTS .................................................................... 45
Projects .......................................................................................................... 45
Project Features ..................................................................................................... 47
Creating a Project .................................................................................................. 47
Project Directories.................................................................................................. 47
Normalized File Names .......................................................................................... 48
The Project List....................................................................................................... 49
Adding Files to a Project ......................................................................................... 49
Removing Files from a Project................................................................................. 50
Closing Projects ..................................................................................................... 50
Opening Projects.................................................................................................... 50
Removing a Project ................................................................................................ 51
Changing Project Settings ...................................................................................... 51
Working in a Team Environment.................................................................... 51
Using a Network .................................................................................................... 52
Adding Remote Files to a Project............................................................................. 52
Using Source Control.............................................................................................. 53
Understanding Symbols and Projects............................................................ 54
Languages Used to Parse Source Files ..................................................................... 54
Symbol Naming..................................................................................................... 54
Updating the Symbol Database ............................................................................. 55
File Names Are Like Symbols................................................................................... 55
Synchronizing Project Files ..................................................................................... 55
Using Common Projects: The Project Symbol Path................................................... 56
Searching the Project Symbol Path ......................................................................... 57
Working With No Project Open ............................................................................... 57
The Base Project..................................................................................................... 57
Programming Languages .............................................................................. 58
Built-In Languages................................................................................................. 58
Custom Languages ................................................................................................ 58
.Net Framework Support ........................................................................................ 59
ii
Source Insight User Manual
Contents
Using HTML............................................................................................................59
Using HTML and ASP Compound Languages...........................................................59
Java Language Editing ...........................................................................................60
C/C++ Language Features.............................................................................. 60
Working with Inactive Code - ifdef Support..............................................................60
Conditional Parsing................................................................................................61
Preprocessor Token Macros.....................................................................................62
Parsing Considerations ...........................................................................................65
Coding Tips for Good Parsing Results ......................................................................65
Document Types ............................................................................................ 66
Document-Specific Options ....................................................................................67
Associating Files with Document Types ...................................................................67
Associating Special File Names ...............................................................................68
Adding New File Types ............................................................................................68
Editing the Document Options................................................................................68
Typing Symbol Names with Syllable Indexing ............................................... 68
What is a Symbol Syllable?......................................................................................69
Symbol Indexes for Projects.....................................................................................69
Setting Index Options for Projects............................................................................70
Controlling Syllable Matching.................................................................................70
Using Syllable Matching .........................................................................................70
Using Syllable Shortcuts .........................................................................................71
Analysis Features............................................................................................ 71
Parsing...................................................................................................................72
Symbol Navigation Commands ..............................................................................72
Project Window Symbol List ....................................................................................73
Call Trees and Reference Trees .................................................................................73
Context Window.....................................................................................................73
Command Line Symbol Access................................................................................73
Finding References to Symbols ................................................................................74
Creating a Project Report ........................................................................................74
Smart Renaming ....................................................................................................74
Syntax Formatting and Styles ........................................................................ 74
How a Style Works ..................................................................................................75
Formatting Properties.............................................................................................75
Parent Styles...........................................................................................................76
How Styles Apply to Source Code ............................................................................77
Language Keyword Styles .......................................................................................77
Declaration Styles...................................................................................................78
Reference Styles......................................................................................................78
Inactive Code Style .................................................................................................79
Comment Styles .....................................................................................................79
Syntax Decorations ................................................................................................81
Controlling Syntax Formatting................................................................................82
Searching and Replacing Text ........................................................................ 83
Searching for Symbol References.............................................................................84
Renaming an Identifier ...........................................................................................84
Source Insight User Manual
iii
Contents
Searching the Current File ...................................................................................... 84
Replacing in the Current File................................................................................... 84
Searching Multiple Files ......................................................................................... 85
Replacing in Multiple Files ...................................................................................... 85
Searching for Keywords.......................................................................................... 85
Regular Expressions ....................................................................................... 85
Wildcard Matching ................................................................................................ 85
Matching the Beginning or End of a Line................................................................. 86
Matching a Tab or Space ........................................................................................ 86
Matching 0, 1, or More Occurrences........................................................................ 86
Matching Any in a Set of Characters ....................................................................... 86
Regular Expression Groups..................................................................................... 87
Overriding Regular Expression Characters .............................................................. 87
Regular Expression Summary ................................................................................. 88
Bookmarks ..................................................................................................... 89
Navigation with the Selection History ........................................................... 89
Go Back and Go Forward commands...................................................................... 89
Navigation Using Source Links...................................................................... 90
Searching and Source Links.................................................................................... 90
Creating Source Links............................................................................................. 91
Source Links from Custom Command Output ......................................................... 91
Navigating with Source Links ................................................................................. 91
Scrolling and Selecting Text........................................................................... 92
Moving Through a File ........................................................................................... 92
Scrolling Commands.............................................................................................. 93
Selection Commands ............................................................................................. 93
Extending the Selection.......................................................................................... 95
Selection Shortcuts ................................................................................................ 96
File Buffer Basics............................................................................................. 97
Time stamping....................................................................................................... 99
What Happens when you Start Source Insight ........................................................ 99
Recovering From Crashes............................................................................... 99
Recovery Procedure.............................................................................................. 100
Warnings............................................................................................................. 100
Command Line Syntax ................................................................................. 101
Specifying File Arguments .................................................................................... 101
Opening Files....................................................................................................... 101
Opening Workspaces ........................................................................................... 102
Command Line Options ....................................................................................... 103
User-Level Commands ................................................................................. 104
Custom Commands ..................................................................................... 105
Customizing Source Insight ......................................................................... 105
Loading and Saving Configurations ..................................................................... 106
Project Settings .................................................................................................... 106
Saving Configurations.................................................................................. 106
Configuration Files............................................................................................... 107
iv
Source Insight User Manual
CHAPTER 5
Contents
Where Are Configuration Files Stored?...................................................................107
Loading a Configuration.......................................................................................108
Saving a Configuration.........................................................................................108
Saving and Restoring Workspaces ............................................................... 109
Loading and Saving Workspaces...........................................................................109
Managing Tasks With Workspaces ........................................................................109
Performance Tuning..................................................................................... 110
Factors That Affect Performance ...........................................................................110
Speeding Up Program Features .............................................................................113
Files Created by Source Insight .................................................................... 117
Files in the Program Directory ...............................................................................117
Per-User Data Folder.............................................................................................117
Files Created for Each User ....................................................................................118
Configuration Template for All Users .....................................................................119
Files Created for Each Project ................................................................................119
COMMAND REFERENCE..........................................................................121
Commands Overview ...........................................................................................121
About Source Insight ............................................................................................122
Activate Menu Commands....................................................................................122
Activate Global Symbol List...................................................................................122
Activate Relation Window.....................................................................................122
Activate Search Results .........................................................................................123
Activate Symbol Window ......................................................................................123
Add and Remove Project Files................................................................................123
Add File ................................................................................................................125
Add File List ..........................................................................................................127
Advanced Options ................................................................................................127
Back Tab...............................................................................................................127
Backspace ............................................................................................................127
Beginning of Line..................................................................................................127
Beginning of Selection ..........................................................................................128
Blank Line Down ..................................................................................................128
Blank Line Up .......................................................................................................128
Block Down..........................................................................................................128
Block Up...............................................................................................................128
Bookmark ............................................................................................................128
Bottom of File .......................................................................................................129
Bottom of Window ...............................................................................................129
Browse Files..........................................................................................................129
Browse Project Symbols ........................................................................................129
Browse Global Symbols Dialog box .......................................................................130
Browse Local File Symbols.....................................................................................132
Cascade Windows ................................................................................................134
Checkpoint...........................................................................................................134
Checkpoint All ......................................................................................................134
Source Insight User Manual
v
Contents
Clear Highlights ................................................................................................... 134
Clip Properties...................................................................................................... 135
Clip Window Properties ........................................................................................ 135
Close ................................................................................................................... 136
Close All............................................................................................................... 137
Close Project ........................................................................................................ 137
Close Window...................................................................................................... 137
Color Options ...................................................................................................... 138
Command Shell ................................................................................................... 139
Complete Symbol................................................................................................. 139
Context Window .................................................................................................. 140
Context Window Properties.................................................................................. 140
Copy.................................................................................................................... 142
Copy Line............................................................................................................. 143
Copy Line Right.................................................................................................... 143
Copy List.............................................................................................................. 143
Copy Symbol........................................................................................................ 143
Copy To Clip......................................................................................................... 144
Create Key List...................................................................................................... 144
Create Command List........................................................................................... 144
Cursor Down........................................................................................................ 144
Cursor Left ........................................................................................................... 144
Cursor Right......................................................................................................... 144
Cursor Up ............................................................................................................ 145
Custom Commands ............................................................................................. 145
Cut ...................................................................................................................... 152
Cut Line ............................................................................................................... 152
Cut Line Left......................................................................................................... 153
Cut Line Right ...................................................................................................... 153
Cut Selection or Paste........................................................................................... 153
Cut Symbol .......................................................................................................... 153
Cut To Clip ........................................................................................................... 153
Cut Word ............................................................................................................. 153
Cut Word Left....................................................................................................... 153
Delete.................................................................................................................. 154
Delete All Clips ..................................................................................................... 154
Delete Character.................................................................................................. 154
Delete Clip ........................................................................................................... 154
Delete File............................................................................................................ 154
Delete Line........................................................................................................... 154
Display Options ................................................................................................... 155
Document Options .............................................................................................. 161
Draft View ........................................................................................................... 166
Drag Line Down................................................................................................... 167
Drag Line Down More .......................................................................................... 167
Drag Line Up........................................................................................................ 167
Drag Line Up More ............................................................................................... 167
Duplicate............................................................................................................. 167
Duplicate Symbol................................................................................................. 167
vi
Source Insight User Manual
Contents
Edit Condition ......................................................................................................167
Enable Event Handlers ..........................................................................................169
End of Line ...........................................................................................................169
End of Selection....................................................................................................169
Exit.......................................................................................................................169
Exit and Suspend ..................................................................................................169
Expand Special .....................................................................................................170
File Options ..........................................................................................................170
Folder Options......................................................................................................174
Function Down.....................................................................................................175
Function Up..........................................................................................................175
General Options ...................................................................................................175
Go Back................................................................................................................178
Go Back Toggle.....................................................................................................178
Go Forward ..........................................................................................................178
Go To First Link .....................................................................................................179
Go To Line ............................................................................................................181
Go To Next Change ...............................................................................................181
Go To Previous Change .........................................................................................181
Go To Next Link.....................................................................................................181
Go To Previous Link...............................................................................................181
Help .....................................................................................................................181
Help Mode............................................................................................................182
Highlight Word.....................................................................................................182
Incremental Search ..............................................................................................182
Incremental Search Mode .....................................................................................183
Incremental Search Backward ..............................................................................183
Horizontal Scroll Bar.............................................................................................183
HTML Help ...........................................................................................................183
Indent Left............................................................................................................183
Indent Right .........................................................................................................183
Insert ASCII...........................................................................................................184
Insert File..............................................................................................................185
Insert Line ............................................................................................................186
Insert Line Before Next ..........................................................................................186
Insert New Line.....................................................................................................186
Join Lines .............................................................................................................186
Jump To Base Type................................................................................................186
Jump To Caller......................................................................................................187
Jump To Definition ...............................................................................................187
Jump To Link ........................................................................................................187
Jump To Prototype................................................................................................187
Key Assignments...................................................................................................187
Keyword List.........................................................................................................190
Language Options................................................................................................193
Language Properties ............................................................................................196
Line Numbers .......................................................................................................202
Link All Windows ..................................................................................................202
Link Window ........................................................................................................203
Source Insight User Manual
vii
Contents
Load Configuration.............................................................................................. 204
Load File .............................................................................................................. 206
Load Search String............................................................................................... 207
Lock Context Window .......................................................................................... 207
Lock Relation Window.......................................................................................... 207
Lookup References ............................................................................................... 208
Make Column Selection........................................................................................ 211
Menu Assignments............................................................................................... 211
New..................................................................................................................... 212
New Clip .............................................................................................................. 213
New Relation Window.......................................................................................... 213
New Project ......................................................................................................... 213
New Window ....................................................................................................... 214
Next File............................................................................................................... 214
Next Relation Window View ................................................................................. 214
Open ................................................................................................................... 214
Open Project........................................................................................................ 215
Page Down .......................................................................................................... 215
Page Setup .......................................................................................................... 216
Page Up............................................................................................................... 218
Paren Left ............................................................................................................ 218
Paren Right.......................................................................................................... 218
Parse Source Links................................................................................................ 218
Paste ................................................................................................................... 219
Paste From Clip .................................................................................................... 219
Paste Line ............................................................................................................ 219
Paste Symbol ....................................................................................................... 219
Play Recording..................................................................................................... 220
Preferences .......................................................................................................... 220
Print .................................................................................................................... 220
Print Relation Window ......................................................................................... 221
Project Document Types....................................................................................... 221
Project File Browser .............................................................................................. 222
Project File List ..................................................................................................... 222
Project Symbol Classes ......................................................................................... 223
Project Symbol List............................................................................................... 223
Project Window Properties ................................................................................... 224
Project Settings .................................................................................................... 225
Project Report ...................................................................................................... 228
Project Window command................................................................................... 229
Rebuild Project..................................................................................................... 229
Record New Default Properties ............................................................................. 230
Redo.................................................................................................................... 230
Redo All ............................................................................................................... 230
Redraw Screen ..................................................................................................... 231
Reform Paragraph ............................................................................................... 231
Refresh Relation Window ..................................................................................... 231
Relation Graph Properties .................................................................................... 232
Relation Window ................................................................................................. 233
viii
Source Insight User Manual
相关推荐
2023年江西萍乡中考道德与法治真题及答案.doc
2012年重庆南川中考生物真题及答案.doc
2013年江西师范大学地理学综合及文艺理论基础考研真题.doc
2020年四川甘孜小升初语文真题及答案I卷.doc
2020年注册岩土工程师专业基础考试真题及答案.doc
2023-2024学年福建省厦门市九年级上学期数学月考试题及答案.doc
2021-2022学年辽宁省沈阳市大东区九年级上学期语文期末试题及答案.doc
2022-2023学年北京东城区初三第一学期物理期末试卷及答案.doc
2018上半年江西教师资格初中地理学科知识与教学能力真题及答案.doc
2012年河北国家公务员申论考试真题及答案-省级.doc
2020-2021学年江苏省扬州市江都区邵樊片九年级上学期数学第一次质量检测试题及答案.doc
2022下半年黑龙江教师资格证中学综合素质真题及答案.doc
