SourceInsight使用指南

Source Insight使用指南

第1页 共12页

目录

1. Source Insight 基本设置 ..................................................................................................................... 3

1.1 字体设置...............................................................................................................................................................................................3 1.2 自动缩进设置.......................................................................................................................................................................................3 1.3 其它设置...............................................................................................................................................................................................4

2. Source Insight中的宏 ............................................................................................................................. 5 2.1 使用宏...................................................................................................................................................................................................5 2.2 指定快捷键...........................................................................................................................................................................................6 3. Source Insight中的自定义命令 ............................................................................................................... 6 3.1 如何自定义命令...................................................................................................................................................................................6

3.2 指定快捷键...........................................................................................................................................................................................7 3.3 正则表达式语法...................................................................................................................................................................................7 3.4 集成编译器...........................................................................................................................................................................................8 3.5 集成版本控制工具.............................................................................................................................................................................10

4. 其它.....................................................................................................................................................11 4.1 特殊的注释.........................................................................................................................................................................................11

第2页 共12页

Source Insight使用指南

1. Source Insight 基本设置

1.1 字体设置

Option-〉Document Options 文档设置。

Screen Fonts 设置显示字体。推荐使用等宽字体，如“Courier”，这样在代码对齐时容易处理，但中文字体显示有锯齿。使用“宋体” 字时，代码可能存在对齐问题。

1.2 自动缩进设置

Option-〉Document Options-〉Auto Indent 自动缩进设置。详细缩进样式请参考Source Insight 帮助的Command Reference-> Document Options-〉Auto Indenting。

第3页 共12页

Source Insight使用指南

Auto Indent Type 选择 Smart

Smart Indent Options 两个复选框都不要选择

缩进后样式如：

if() { }

1.3 其它设置

? Editing Options 编辑器设置

Show line numbers 显示行号

Show right margin 显示右边界线（边界线显示在Margin width 处） Tab width TAB键宽度，设置为 4

Margin width 页空白宽度，页面右边界线的位置，设置为80。选择后在编辑窗口右

第4页 共12页

Source Insight使用指南

侧设置的宽度处出现分割线

Show page breaks 显示页面分割线，选择后在编辑窗口出现打印页分割线

? 如果编辑窗口中的中文字符中间分割过大或者出现对齐问题时，请尝试如下设置：

Options-> Preferences-> Display-> Spacing

选择 Layout tabstops using monospace calculations 和 Layout spaces using monospace calculations

? 定制Open命令

Options-> Preferences-> Files-〉Custom “Open” Command

2. Source Insight中的宏

2.1 使用宏

首先关闭当前使用中的Source Insight，然后复制macro\%utils.em 到 我的文档\\Source

第5页 共12页

Source Insight使用指南

Insight\\Projects\\Base，覆盖原有的文件。最后重新打开Source Insight，在Project-〉Open Project中找到 Base工程打开并做同步（Synchronize Files）。

宏中使用的代码修改者的名字是Source Insight安装时注册用的用户名。如果不合适，请重新安装Source Insight并指定正确的用户名。

2.2 指定快捷键

Option-〉Key Assignments

在Command栏中找到需要的宏，点击 Assign New Key来指定快捷键。（在这里你可以为Source Insight中的所有命令指定快捷键）。

3. Source Insight中的自定义命令

3.1 如何自定义命令

Source Insight的自定义命令执行类似于批处理的执行，并且Source Insight可以捕捉命令执行的输出。详细内容请参考Source Insight帮助的Command Reference-> Custom Commands部分。

Option-〉Custom Commands 自定义命令

第6页 共12页

Source Insight使用指南

Add 新增一条命令 Command 命令名称

Run 需要执行的命令，可以是单条命令，也可以是一个批处理程序

Iconic Window 命令执行时窗口最小化 Caputre Output 捕捉命令输出

Save Files First 执行命令前先保存编辑的文件 Pause When Done 命令执行完成后暂停

Parse Links in Output 解析输出中的连接信息 Pattern Contains 文件名和行号的顺序 Pattern 解析规则

3.2 指定快捷键

参考2.2节。

3.3 正则表达式语法

正则表达式一般用在文本查找、替换和命令执行结果解析时。例如从捕获的编译器输出中

第7页 共12页

Source Insight使用指南

解析出错误的位置信息等。

Source Insight正则表达式最重要的概念就是群组（Groups）。群组用来表示一个特定的字符串对象。一个群组以“\\(”开始，以“\\)”结束。在一个表达式中可以有多个群组，群组从左至右从1开始依次编号。

详细的正则表达式用法请参考Source Insight帮助的Source Insight Concepts-> Regular Expressions部分。

例1 从编译器的输出中解析错误的位置信息时，必须有两个群组，一个表示文件的位置，一个表示行号。

^\\([A-Za-z:]*[\\\\a-zA-Z0-9_./]+\\):\\([0-9]+\\)

\\([A-Za-z:]*[\\\\a-zA-Z0-9_./]+\\) 为一个群组，表示文件位置信息 \\([0-9]+\\) 为一个群组，表示行号

例2 如下替换方法将把文件中所有的 xyzabc 替换为 abcxyz。注意选择 Use Regular Expressions

3.4 集成编译器

在Source Insight的自定义命令中已经集成有 Build Project、Compile File和Clear Build。这三个默认的命令在工具栏上有相应的快捷方式。

对于Run一栏中所用的参数（%j %o等），请参考Command Reference-> Custom Commands-> Command Line Substitutions。

Pattern 栏中为： “^\\([A-Za-z:]*[\\\\a-zA-Z0-9_./\\-\\ ]+\\):\\([0-9]+\\)” 。 只解析错误（忽略警告信息）时，Pattern栏中填入：

“^\\([A-Za-z:]*[\\\\a-zA-Z0-9_./\\-\\ ]+\\):\\([0-9]+\\):[0-9]*: error:” 。

关于批处理程序中使用的命令请参考 Microsft Windows 的帮助。

以Workbench3.0为例，定制Build Project 命令 打开Custom Command窗口，做如下设置。

第8页 共12页

Source Insight使用指南

注意Run一栏中命令和参数根据实际情况做修改。使用Browse时只支持后缀为.exe和.com的文件，后缀为.bat的批处理文件可能无法找到，对于批处理文件直接写绝对路径即可。

vx_buildproj.bat文件内容如下书写(参考bat\\vx_buildproj.bat)：

rem Run 栏中格式如：x:\\file\\path\\vx_buildproj.bat %j %o rem 请将以下三个路径设置为实际使用的路径

set TORNADO_X86_DIR=C:\\Tornado2.2_X86 set TORNADO_PPC_DIR=C:\\Tornado2.2

set WORKBENCH_DIR=C:\\WindRiver-GPPVE-3.6-PPC-Eval

rem if %2 == XXXX XXXX是Source Insight中的工程名称，注意区分大小写。 if %2 == Vxtest ( path %TORNADO_X86_DIR%\\host\\x86-win32\\bin set WIND_BASE=%TORNADO_X86_DIR% set TGT_DIR=%TORNADO_X86_DIR%\\target

set WIND_HOST_TYPE=x86-win32 set BUILD_DIR=%1 set MAKE_FLAG=

) else if %2 == nfm2 (

path %WORKBENCH_DIR%\\workbench-3.0\\x86-win32\\bin;%WORKBENCH_DIR%\\gnu\\4.

1.2-vxworks-6.6\\x86-win32\\bin set WIND_BASE=%WORKBENCH_DIR%\\vxworks-6.6

set TGT_DIR=%WORKBENCH_DIR%\\vxworks-6.6\\target set WIND_HOST_TYPE=x86-win32

set WIND_HOME=%WORKBENCH_DIR%

set WIND_LICENSE=%WORKBENCH_DIR%\\license set BUILD_DIR=%1\\SIMNTgnu

第9页 共12页

Source Insight使用指南

set MAKE_FLAG= ) else (

path %TORNADO_PPC_DIR%\\host\\x86-win32\\bin set WIND_BASE=%TORNADO_PPC_DIR% set TGT_DIR=%TORNADO_PPC_DIR%\\target set WIND_HOST_TYPE=x86-win32 set BUILD_DIR=%1 set MAKE_FLAG= )

cd %BUILD_DIR%

make %MAKE_FLAG% clean make %MAKE_FLAG%

以上批处理文件中的%1表示引用Run栏中的第一个参数，%2表示引用第二个参数，依次类推。 变量BUILD_DIR为Makefile文件所在的目录，请根据实际情况修改。

Compile File和Clear Build命令请分别参考bat\\ vx_compilefile.bat和 bat\\vx_clear.bat书写。

3.5 集成版本控制工具

Source Insight中的版本控制工具集成方法是针对于Microsoft SourceSafe而设计的。基本的命令里包含了check in、check out、undo check out、Sync to Source Control Project和Sync File to Source Control Project。

鉴于SourceSafe和SVN的不同，对Source Insight中的版本控制命令做如下设置： Check out 命令：TortoiseProc.exe /command:update /path:%f /closeonend:0 。对应“SVN 更新”命令。 设置如下图示：

第10页 共12页

Source Insight使用指南

Check in命令：TortoiseProc.exe /command:commit /path:%f /closeonend:0 。对应“SVN 提交”命令。执行后打开提交对话框。

Undo check out命令：TortoiseProc.exe /command:diff /path:%f /closeonend:0 。比较本地和服务器上的最新版本。

Sync to Source Control Project 命令：TortoiseProc.exe /command:revert /path:%j /closeonend:0 。还原本地工程到最新版本。

Sync File to Source Control Project 命令：TortoiseProc.exe /command:revert /path:%f /closeonend:0 。还原本地指定文件到最新版本。

4. 其它

4.1 特殊的注释

SourceInsight中支持一些特殊的注释格式，以此来可以表示强调等作用。如下图例。注释 Command Query、Get User Information和Get User Information Failure三句出现了不同的效果。

第11页 共12页

Source Insight使用指南

这种效果的注释的格式是：//<数字1-4> “注释字串”。注意这种注释效果只能在Sourceinsight中使用！详细请参考帮助手册“Syntax Formatting and Styles”。

第12页 共12页

本文来源：https://www.bwwdw.com/article/47s.html