Diff of /trunk/doc/netbeans.txt [r193] .. [r194] Maximize Restore

  Switch to side-by-side view

--- a/trunk/doc/netbeans.txt
+++ b/trunk/doc/netbeans.txt
@@ -1,4 +1,4 @@
-*netbeans.txt*  For Vim version 7.2.  最近更新: 2009年4月
+*netbeans.txt*  For Vim version 7.3.  最近更新: 2010年7月
 
 
 		  VIM 参考手册    by Gordon Prieur et al.
@@ -16,7 +16,7 @@
 4.  错误消息					|netbeans-messages|
 5.  从 NetBeans 模式里运行 Vim			|netbeans-run|
 6.  NetBeans 协议				|netbeans-protocol|
-7.  NetBeans 热键				|netbeans-key|
+7.  NetBeans 命令				|netbeans-commands|
 8.  已知问题					|netbeans-problems|
 9.  调试 NetBeans 协议				|netbeans-debugging|
 10. NetBeans 外部编辑器
@@ -48,6 +48,8 @@
 	http://www.a-a-p.org
 - Clewn,C 编写的 Vim 上的 gdb 集成:
 	http://clewn.sourceforge.net/
+- Pyclewn,Python 编写的 Vim 的 gdb 集成:
+	http://pyclewn.sourceforge.net/
 - VimPlugin,Eclipse 上的 Vim 集成:
 	http://vimplugin.sourceforge.net/wiki/pmwiki.php
 - PIDA,Python 编写的集成 Vim 的 IDE:
@@ -106,8 +108,8 @@
 如果你不想要 NetBeans 接口,你可以在 Makefile 里去掉包含 "--disable-netbeans"
 的一行的注释。
 
-目前,只有 GVim 支持这种集成,因为 NetBeans 没有办法提供 Vim 命令的终端模拟。
-另外,支持的 GUI 只有 GTK、GNOME 和 Motif。
+目前,支持 Netbeans 接口的有控制台运行的 Vim 和运行以下 GUI 的 Gvim: GTK、
+GNOME 和 Motif。
 
 如果需要 Motif 支持,用户应该提供 XPM 库。参见 |workshop-xpm| 了解如何得到最新
 版本的 XPM 的详情。
@@ -138,6 +140,12 @@
 Region is guarded, cannot modify
 		Vim 控制器定义了文本的保护区域,你不能编辑这个区域。
 		如果需要,设置当前缓冲区。
+
+							*E532*
+The defineAnnoType highlighting color name is too long
+		defineAnnoType 命令的 "fg" 或 "bg" 颜色参数最大长度是 32 个字
+		符。
+		2.5 版本新出现.
 
 							*E656*
 Writes of unmodified buffers forbidden
@@ -162,22 +170,35 @@
 ==============================================================================
 5. 从 NetBeans 模式里运行 Vim				*netbeans-run*
 
-Vim 必须用 |-nb| 参数启动。有三种形式可以使用,取决于如何指定连接所需的信息。
+有两种方式可以启动 Vim 的 NetBeans 模式:
+
+	+ IDE 可用 |-nb| 命令行参数启动 Vim
+	+ 在 Vim 内部,可用 |:nbstart| 命令启动 NetBeans
+
+							*netbeans-parameters*
+有三种形式可以用来设置 NetBeans 连接参数。
+在命令行上启动时,|-nb| 命令行参数可以是:
 
 	-nb={fname}				从文件读取
 	-nb:{hostname}:{addr}:{password}	直接
 	-nb					从文件或者环境变量里读取
 
+在 Vim 内部启动时,|:nbstart| 可选参数可以是:
+
+	={fname}				从文件读取
+	:{hostname}:{addr}:{password}		直接
+	<无参数>				从文件或者环境变量里读取
+
 							*E660* *E668*
-为了安全的原因,最好的方法是把信息写到只有用户能读得文件里。文件名字可以通过
-"-nb={fname}" 的参数传递。或者,在不带的参数的 "-nb" 形式里,由环境变量
-"__NETBEANS_CONINFO" 指定。文件里必须包含以下三行内容,顺序随意:
+在命令行上启动时,为了安全的原因,最好的方法是把信息写到只有用户能读得文件里。
+文件名字可以通过 "-nb={fname}" 的参数传递。或者,在不带的参数的 "-nb" 形式里,
+由环境变量 "__NETBEANS_CONINFO" 指定。文件里必须包含以下三行内容,顺序随意:
 
 	host={hostname}
 	port={addr}
 	auth={password}
 
-其他的行被忽略。Vim 的调用者须自己负责在不用的时候删除这个文件。
+其他的行被忽略。Vim 控制器须自己负责在不用的时候删除这个文件。
 
 {hostname} 指定 Vim 控制器运行的机器名。如果不提供,则取环境变量
 "__NETBEANS_HOST" 的值,如果还没有,缺省值是 "localhost"。
@@ -206,7 +227,7 @@
 起了若干问题,而 2.2 已修正了这个错误。为了减少这个混淆再次发生的可能性,
 netbeans_saved() 已经被改名为 netbeans_save_buffer()。
 
-我们现在已经使用 2.4 版本。2.3 和 2.4 版本间的差异可以在下面搜索 "2.4"。
+我们现在已经使用 2.5 版本。2.4 和 2.5 版本间的差异可以在下面搜索 "2.5"。
 
 目前,消息通过套接字传送。因为消息是简单的 UTF-8 文本,该协议也许可以用其它通
 信机制完成。
@@ -266,7 +287,10 @@
 
 number		十进制的参数。
 
-optnum		参数,或为十进制数字,或为 "none" (没有引号)。
+color		参数,或为十进制数字,或为 "none" (没有引号),或为在
+		|highlight-ctermfg| 和 |gui-colors| 中定义的色彩名 (没有引
+		号),
+		2.5 版本新出现。
 
 offset		数值参数,表示缓冲区的一个字节位置 (偏移量)。第一个字节的偏移
 		量为 0。行尾的字节计数决定于在文件里如何表示 (CR/LF 是两个字
@@ -318,9 +342,12 @@
 		   typeName	string	标识这个评注的名字
 		   tooltip	string	没有用到
 		   glyphFile	string	图标文件名
-		   fg		optnum	高亮行前景色
-		   bg		optnum	高亮行背景色
+		   fg		color	高亮行前景色
+		   bg		color	高亮行背景色
 		Vim 会定义评注所用的标号。
+		如果 color 为数值,解释为 "#rrggbb",即红绿蓝色彩值 (见
+		|gui-colors|),高亮只在 GVim 有定义。
+		如果 color 为名字,该颜色在带色彩的终端和 GVim 都有定义。
 		当 "fg" 和 "bg" 都是 "none" 的时候,不使用高亮行 (2.1 版本新出
 		现)。
 		当 "glyphFile" 为空时,不使用文本标号 (2.1 版本新出现)。
@@ -375,6 +402,7 @@
 		2.1 版本新出现。
 
 raise		把编辑器带到前台。
+		仅用于 GUI 版本的 Vim。
 		2.1 版本新出现。
 
 removeAnno serNum
@@ -454,6 +482,7 @@
 showBalloon text
 		在鼠标当前位置显示一个气泡 (弹出窗口),显示文本 "text",一个字
 		符串表达式。气泡在鼠标移动若干像素点后自动消失。
+		仅用于 GUI 版本的 Vim。
 		2.1 版本新出现。
 
 specialKeys
@@ -574,6 +603,7 @@
 balloonText text
 		如果设置了 'ballooneval',鼠标在某段文字上出现。"text" 是字符
 		串,鼠标下的文本。
+		仅用于 GUI 版本的 Vim。
 		2.1 版本新出现。
 
 buttonRelease button lnum col
@@ -627,7 +657,7 @@
 
 			X		不能识别的键
 
-		键名前面可能有 "C"、"S" 和/或 "M",分别代表 Control, Shift 和
+		键名前面可能有 "C"、"S" 和/或 "M",分别代表 Control、Shift 和
 		Meta (Alt) 修饰符。如果有的话,修饰符和键名以连字符分隔。例如:
 		"C-F2"。
 		ASCII 字符是 2.1 版本新出现的。
@@ -690,10 +720,20 @@
 
 
 ==============================================================================
-7. NetBeans 热键					*netbeans-key*
+7. NetBeans 命令					*netbeans-commands*
+
+							*:nbstart* *E511*
+:nbs[tart] {connection}	使用 {connection} 作为套接字连接参数,启动新的
+			NetBeans 会话。{connection} 的格式见
+			|netbeans-parameters|。在任何时候,用户可以用以下命令
+			检查 netbeans 套接字是否已连接:
+			':echo has("netbeans_enabled")'
+
+							*:nbclose*
+:nbc[lose]		关闭当前 NetBeans 会话。删除所有放置的标号。
 
 							*:nbkey*
-:nbkey key			把键传递给 Vim 控制器进行处理
+:nb[key] {key}		把 {key} 传递给 Vim 控制器进行处理
 
 用 specialKeys 命令安装了热键后,此命令用来生成热键的相应信息发给 Vim 控制器。
 生成的依次是 newDotAndMark、keyCommand 和 keyAtPos 事件。
@@ -704,6 +744,11 @@
 
 不可能有 NUL 字节。编辑器到 IDE 的转换使得它们成为 NL 字符。反之,IDE -> 编辑
 器却不能插入它们。
+
+NetBeans 会话可以在终端运行的 Vim 中启动,然后在运行了 |:gui| 命令后切换到 GUI
+环境中继续使用。此时 NetBeans 评注定义的高亮可能在 ":gui" 命令执行的 .gvimrc
+中被清除,因为该文件会载入 colorscheme,后者会执行命令 ":highlight clear"。
+2.5 版本新出现。
 
 ==============================================================================
 9. 调试 NetBeans 协议					*netbeans-debugging*