Skip to content

Commit

Permalink
update for 8.0.
Browse files Browse the repository at this point in the history
  • Loading branch information
yianwillis committed Aug 17, 2017
1 parent 61ded6a commit 564e870
Show file tree
Hide file tree
Showing 18 changed files with 72 additions and 66 deletions.
3 changes: 2 additions & 1 deletion doc/autocmd.txt
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,8 @@
特殊模式 <buffer> 或 <buffer=N> 定义局部于缓冲区的自动命令。见
|autocmd-buflocal|

注意: 要在 ":autocmd" 命令之后紧跟其他命令, '|' 必须在 {cmd} 之前。可以这样: >
注意: 要在 ":autocmd" 命令之后紧跟其他命令, '|' 必须在 {cmd} 之前。可以这
样: >
:augroup mine | au! BufRead | augroup END
但下列命令会把 "augroup" 视为所定义命令的一部分: >
:augroup mine | au BufRead * set tw=70 | augroup END
Expand Down
2 changes: 1 addition & 1 deletion doc/change.txt
Original file line number Diff line number Diff line change
Expand Up @@ -372,7 +372,7 @@ CTRL-A 和 CTRL-X 命令可用于:
- 带符号或无符号十进制数
- 无符号二进制、八进制和十六进制数
- 字母

这取决于 'nrformats' 选项:
- 当 'nrformats' 包括 "bin" 时,Vim 假设 '0b' 或 '0B' 开始的数值为二进制。
- 当 'nrformats' 包括 "octal" 时,Vim 假设 '0' 开始的数值为八进制,除非该数值
Expand Down
10 changes: 5 additions & 5 deletions doc/channel.txt
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Netbeans 接口也使用通道。|netbeans|
1. 总览 *job-channel-overview*

有四种主要的作业类型:
1. 守护进程 (daemon), 服务于多个 Vim 实例。
1. 守护进程 (daemon)服务于多个 Vim 实例。
Vim 使用套接字连接。
2. 用于单个 Vim 实例的单个作业,异步操作。
使用套接字或管道。
Expand Down Expand Up @@ -110,7 +110,7 @@ Vim 不会等待响应。这样,服务器就可以稍后发送响应,响应
if ch_status(channel) == "open"
" use the channel
可用 |ch_status()|看到通道是否已打开。
可用 |ch_status()| 看到通道是否已打开。

{address} 的格式为 "hostname:port"。例如 "localhost:8765"。

Expand Down Expand Up @@ -193,7 +193,7 @@ Vim 不会等待响应。这样,服务器就可以稍后发送响应,响应
*E898* *E901* *E902*

读写通道时如果有错,会关闭通道。
*E630* *E631*
*E630* *E631*

==============================================================================
4. 使用 JSON 或 JS 通道 *channel-use*
Expand Down Expand Up @@ -427,7 +427,7 @@ JS 或 JSON 通道这里返回一条解码的信息。
\ "err_cb": "ErrHandler"})
如果要用相同的处理函数同时处理 stderr 和 stdout,使用 "callback" 选项: >
let job = job_start(command, {"callback": "MyHandler"})
let job = job_start(command, {"callback": "MyHandler"})
取决于系统,启动新的作业可能把 Vim 放到后台,使启动的作业获得焦点。要避免之,
可使用 `foreground()` 函数。但如果调用太早,可能无效,可在回调处理函数中使用,
Expand Down Expand Up @@ -537,7 +537,7 @@ ch_setoptions(channel, {options}) 对作业相关的通道给出。
|close_cb|
*job-drop*
"drop" 指定何时丢弃消息。与 |ch_open()| 的 "drop" 相同,见
|channel-drop|. 如用 "auto",不考虑 exit_cb。
|channel-drop|如用 "auto",不考虑 exit_cb。
*job-exit_cb*
"exit_cb": handler 作业结束时的回调。参数是作业和退出状态。
对退出的作业,Vim 作最多每秒十次的检查。也可以通过
Expand Down
2 changes: 1 addition & 1 deletion doc/editing.txt
Original file line number Diff line number Diff line change
Expand Up @@ -926,7 +926,7 @@ Unix 上当文件名不引用一个普通文件或者目录时,检测为设备
如果参数列表的最后一个文件还没有被编辑,该操作失败。
如果有其它标签页,并且退出的是当前标签页的最后一个窗
口,关闭当前标签页 |tab-page|
激活 |QuitPre| 自动命令事件。
激活 |QuitPre| 自动命令事件。

:conf[irm] q[uit] 退出,但如果已经有修改或者参数列表的最后一个文件还未被
编辑,给出提示。参见 |:confirm|'confirm'。 {Vi 无
Expand Down
56 changes: 29 additions & 27 deletions doc/eval.txt
Original file line number Diff line number Diff line change
Expand Up @@ -857,7 +857,7 @@ expr7 *expr7*
- expr7 一元减法: 取反 *expr-unary--*
+ expr7 一元加法: 原值 *expr-unary-+*

'!' 把|TRUE| 变为 |FALSE||FALSE| 变为 |TRUE| (一)。
'!' 把 |TRUE| 变为 |FALSE||FALSE| 变为 |TRUE| (一)。
'-' 改变数值的符号。
'+' 保持原值。

Expand Down Expand Up @@ -1141,7 +1141,7 @@ lambda expression *expr-lambda* *lambda*
另见 |:func-closure|。可以这样来检查匿名函数和闭包的支持: >
if has('lambda')
示例如何在 |sort()||map()||filter()|中使用匿名函数: >
示例如何在 |sort()||map()||filter()| 中使用匿名函数: >
:echo map([1, 2, 3], {idx, val -> val + 1})
< [2, 3, 4] >
:echo sort([3,7,2,1,4], {a, b -> a - b})
Expand Down Expand Up @@ -3007,7 +3007,7 @@ deepcopy({expr}[, {noref}]) *deepcopy()* *E698*
delete({fname} [, {flags}]) *delete()*
{flags}{flags} 为空: 删除名为 {fname} 的文件。{fname}
是符号链接也可以。

如果 {flags} 是 "d": 删除名为 {fname} 的目录。如果目录 {fname}
非空会失败。

Expand Down Expand Up @@ -3313,8 +3313,8 @@ feedkeys({string} [, {mode}]) *feedkeys()*
{string} 里的字符放在队列里等候处理,就像它们来自映射或者用
户输入一样。
缺省它们加在预输入 (typeahead) 缓冲区的尾端,所以如果
仍然在执行映射,这些字符会出现在映射内容之后。用 'i' 标志位则插入
位置在其它字符之前,这样,它们在映射其它字符之前就会执行。
仍然在执行映射,这些字符会出现在映射内容之后。用 'i' 标志位则
插入位置在其它字符之前,这样,它们在映射其它字符之前就会执行。
该函数不会等待 {string} 包含的键处理完毕。
{string} 如果要包含特殊键,可以使用双引号和 "\..." 记法
|expr-quote|。例如,feedkeys("\<CR>") 会模拟 <Enter> 键击。但
Expand Down Expand Up @@ -3529,8 +3529,8 @@ funcref({name} [, {arglist}] [, {dict}])
类似于 |function()|,但返回的函数引用通过引用来查找函数,而不
是名字。如果函数 {name} 之后被重定义,这很有意义。

|function()|不同,{name} 必须是已经定义的用户函数。自动载入
函数也可以{name} 不能是内建函数。
|function()| 不同,{name} 必须是已经定义的用户函数。自动载
入函数也可以{name} 不能是内建函数。

*function()* *E700* *E922* *E923*
function({name} [, {arglist}] [, {dict}])
Expand All @@ -3547,7 +3547,7 @@ function({name} [, {arglist}] [, {dict}])

提供 {arglist}{dict} 则会建立偏函数。这意味着参数列表和/或
字典会存放在函数引用里,并在调用函数引用时使用。

参数被传递到函数里,在其它参数之前。例如: >
func Callback(arg1, arg2, name)
...
Expand Down Expand Up @@ -3596,7 +3596,7 @@ function({name} [, {arglist}] [, {dict}])
garbagecollect([{atexit}]) *garbagecollect()*
清理不再使用但有循环引用的 |List||Dictionary||Channel|
|Job|

几乎没有需要调用这个函数,因为 Vim 内存不足或者 'updatetime'
之后等待用户按键时会自动执行此功能。没有循环引用的项目总是在不
再使用的时候就被立即释放了。
Expand Down Expand Up @@ -3875,7 +3875,8 @@ getcompletion({pat}, {type} [, {filtered}]) *getcompletion()*
如果没有匹配,返回空列表。如果 {type} 为非法值,报错。

*getcurpos()*
getcurpos() 返回光标位置。类似于 getpos('.'),但包含在列表中一个额外的项目:
getcurpos() 返回光标位置。类似于 getpos('.'),但包含在列表中一个额外的项
目:
[bufnum, lnum, col, off, curswant] ~
"curswant" 数值是垂直移动光标时的首选列。另见 |getpos()|

Expand Down Expand Up @@ -4102,7 +4103,8 @@ getregtype([{regname}]) *getregtype()*
如果没有指定 {regname},使用 |v:register|

gettabinfo([{arg}]) *gettabinfo()*
如果没指定 {arg},返回列表,包含所有标签页的信息。每个列表项是字典。
如果没指定 {arg},返回列表,包含所有标签页的信息。每个列表项是
字典。
否则,{arg} 指定标签页号,返回关于该标签页的信息。如果该标志页
不存在,返回空列表。

Expand Down Expand Up @@ -4599,7 +4601,7 @@ job_status({job}) *job_status()* *E916*
"run" 作业运行中
"fail" 作业无法启动
"dead" 作业启动后结束或被终止

Unix 上不存在的命令会报告 "dead" 而不是 "fail",因为在检测到问
题之前,fork 操作已经发生。

Expand Down Expand Up @@ -4798,7 +4800,7 @@ line({expr}) 返回数值,即 {expr} 给定的文件位置的行号。可接
如果设置了 '" 位置标记的话,下面的自动命令在打开文件后跳转到最
后已知的文件位置: >
:au BufReadPost *
\ if line("'\"") > 1 && line("'\"") <= line("$") && &ft !~# 'commit'
\ if line("'\"") > 1 && line("'\"") <= line("$") && &ft !~# 'commit'
\ | exe "normal! g`\""
\ | endif
<
Expand Down Expand Up @@ -5063,7 +5065,7 @@ matchaddpos({group}, {pos}[, {priority}[, {id}[, {dict}]]])
被高亮。
- 包含三个数值的列表,如 [23, 11, 3]。同上,但第三个数给出高亮
字节计的长度。

最多可有 8 个位置。

示例: >
Expand Down Expand Up @@ -5979,7 +5981,7 @@ setloclist({nr}, {list}[, {action}[, {what}]]) *setloclist()*
创建或替代或加入到窗口 {nr} 的位置列表。
{nr} 可以是窗口号或 |window-ID|
如果 {nr} 为零,使用当前窗口。

如果是位置列表窗口,修改所显示的位置列表。如果窗口号 {nr}
法,返回 -1。
其它同 |setqflist()|
Expand Down Expand Up @@ -6007,7 +6009,7 @@ setpos({expr}, {list})
设置位置标记的缓冲区。可以用 |bufnr()| 函数把文件名转化为缓冲
区号。
设置光标和 ' 位置标记时忽略 "bufnum",因为它们和窗口相关,而不
是缓冲区相关。
是缓冲区相关。
不修改跳转表。

"lnum" 和 "col" 是缓冲区里的位置。第一列为 1。"lnum" 为零则删
Expand Down Expand Up @@ -6063,11 +6065,11 @@ setqflist({list} [, {action}[, {what}]]) *setqflist()*
{action} 值: *E927*
'a' 把 {list} 项目加入已有的 quickfix 列表。如果该列表尚不
存在,建立新表。

'r' {list} 项目替换当前 quickfix 列表项目。也可用于清除列
表: >
:call setqflist([], 'r')
<
<
'f' 释放 quickfix 堆栈上的所有 quickfix 列表。

如果 {action} 不存在或者设为 ' ',那么建立新表。
Expand Down Expand Up @@ -6230,7 +6232,7 @@ sinh({expr}) *sinh()*

sort({list} [, {func} [, {dict}]]) *sort()* *E702*
{list} 项目排序,原地直接修改列表。返回 {list}

如果你不想修改列表,先构建一个备份: >
:let sortedlist = sort(copy(mylist))
Expand Down Expand Up @@ -6534,8 +6536,8 @@ submatch({nr}[, {list}]) *submatch()* *E935*

如果给出 {list} 且非零,submatch() 返回字符串的列表,和带两个
参数的 |getline()| 类似。文本中的 NL 代表文件中的 NUL 字符。
只在 |:substitute| 中可能返回多于一个项目,|substitute()|
此列表总是包含一个或零个项目,因为没有真正的行尾。
只在 |:substitute| 中可能返回多于一个项目,|substitute()| 中此
列表总是包含一个或零个项目,因为没有真正的行尾。

递归使用 substitute() 时,只能得到当前 (最深的) 调用的子匹配。

Expand Down Expand Up @@ -6689,7 +6691,7 @@ system({expr} [, {input}]) *system()* *E677*
需要用户输入的命令,以避免屏幕上显示多余的字符而需要用
|CTRL-L| 来清除。 >
:silent let f = system('ls *.vim')
<
<
注意: |shellescape()||expand()||::S|
|fnamemodify()| 可以转义命令参数里的特殊字符。{expr} 里的换行
可能会使命令失败。'shellquote''shellxquote' 里的字符也可能
Expand Down Expand Up @@ -6772,7 +6774,7 @@ taglist({expr}[, {filename}]) *taglist()*

如果传入 {filename},用于象 |:tselect| 那样给结果排序。见
|tag-priority|{filename} 必须是文件的完整路径。

每个列表项目是一个至少包含以下项目的字典:
name 标签名。
filename 标签定义的文件名。它或者相对于当前目
Expand Down Expand Up @@ -6870,10 +6872,10 @@ test_null_string() *test_null_string()*
test_override({name}, {val}) *test_override()*
覆盖 Vim 内部处理的部分行为,用于运行测试。只能用于 Vim 测试!
如果 {val} 非零,打开覆盖行为,{val} 为零时,关闭覆盖行为。
目前支持的名字是:
目前支持的名字是:

名字 {val} 非零的效果 ~
redraw 屏蔽 redrawing() 函数
redraw 屏蔽 redrawing() 函数
char_avail 屏蔽 char_avail() 函数
starting 复位 "starting" 变量,见下
ALL 复位所有覆盖 (不使用 {val})
Expand Down Expand Up @@ -7127,7 +7129,7 @@ wildmenumode() *wildmenumode()*
win_findbuf({bufnr}) *win_findbuf()*
返回包含缓冲区 {bufnr} 的窗口的所有 |window-ID| 的列表。如果
没有这样的窗口,返回空列表。

win_getid([{win} [, {tab}]]) *win_getid()*
返回指定窗口的 |window-ID|
忽略 {win} 则使用当前窗口。
Expand Down Expand Up @@ -9323,7 +9325,7 @@ Geddes 提供的方法)
: echo "你_永远_看不到这条消息"
:endif
要在 |+eval|特性关闭时才执行命令需要一点技巧,如下例所示: >
要在 |+eval| 特性关闭时才执行命令需要一点技巧,如下例所示: >
silent! while 0
set history=111
Expand Down
3 changes: 2 additions & 1 deletion doc/if_lua.txt
Original file line number Diff line number Diff line change
Expand Up @@ -185,7 +185,8 @@ Lua 中列表引用的改变会反映在 Vim 中,反之亦然。列表 "l" 有
----------
o "#l" 是列表 "l" 的项目数,相当于 Vim 中的 "len(l)"。
o "l[k]" 返回 "l" 的第 k 项;"l" 索引从零开始,和 Vim 一样。要修改第 k
项,可用 "l[k] = newitem";特别地,"l[k] = nil" 删除 "l" 的第 k 项。
项,可用 "l[k] = newitem";特别地,"l[k] = nil" 删除 "l" 的第 k
项。
o "l()" 返回遍历 "l" 的 iterator。

方法
Expand Down
4 changes: 2 additions & 2 deletions doc/if_pyth.txt
Original file line number Diff line number Diff line change
Expand Up @@ -313,8 +313,8 @@ Python 'runtimepath' 处理 *python-special-path*
fmr = find_module(fullname, path)
return load_module(fullname, *fmr)
# It uses vim module itself in place of VimPathFinder class: it does not
# matter for python which object has find_module function attached to as
# It uses vim module itself in place of VimPathFinder class: it does not
# matter for python which object has find_module function attached to as
# an attribute.
class VimPathFinder(object):
@classmethod
Expand Down
2 changes: 1 addition & 1 deletion doc/index.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1019,7 +1019,7 @@ SECTION 可能以 '}' 而不是 '{' 开始的小节
|:checktime| :checkt[ime] 检查载入缓冲区的时间标签
|:chistory| :chi[story] 列出所有的错误列表
|:clast| :cla[st] 跳转到指定的错误上,缺省为最后一个
|:clearjumps| :cle[arjumps 清除跳转列表
|:clearjumps| :cle[arjumps 清除跳转列表
|:clist| :cl[ist] 列出所有错误
|:close| :clo[se] 改变当前窗口
|:cmap| :cm[ap] 类似于 ":map",但用于命令行模式
Expand Down
2 changes: 1 addition & 1 deletion doc/map.txt
Original file line number Diff line number Diff line change
Expand Up @@ -401,7 +401,7 @@ CTRL-U (<C-U>) 用于删除命令行上 Vim 可能插入的范围。普通模式
键码在 termcap (t_ 开头的选项) 里,它会被自动转换到内码并变成映射的第二种方
法 (除非 'cpoptions' 里包括了 'k' 标志位)。
2. 第二种方法是使用功能键的内码。要输入这样的映射输入 CTRL-K 并敲要映射的功能
键,或者使用 "#1""#2".. "#9""#0""<Up>""<S-Down>""<S-F7>" 等等的
键,或者使用 "#1""#2".. "#9""#0""<Up>""<S-Down>""<S-F7>" 等等的
形式 (参考键表 |key-notation|,所有从 <Up> 开始的键都可以使用)。头十个功能
键能以两种方式被定义: 仅用数字,比如 "#2";或者使用 "<F>",如 "<F2>"。两种
都代表功能键 F2。"#0" 表示功能键 F10,由选项 't_f10' 定义,它在某些键盘上可
Expand Down
6 changes: 3 additions & 3 deletions doc/mbyte.txt
Original file line number Diff line number Diff line change
Expand Up @@ -726,10 +726,10 @@ Wnn4.2 是一个好输入系统。Wnn 4.2 包括,

在 X 的国际化输入中,第一和第二个区被分别称为 "预编辑区" 和 "状态区"。第三和
第四个区未被定义,而是留给输入法服务器 |IM-server| 来控制。在国际化输入中,
根据预编辑区与状态区的组合,划分出了四种输入风格: |OnTheSpot|
|OffTheSpot||OverTheSpot||Root|
根据预编辑区与状态区的组合,划分出了四种输入风格: |OnTheSpot|
|OffTheSpot||OverTheSpot||Root|

目前 GUI Vim 支持三种输入方式: |OverTheSpot||OffTheSpot||Root|
目前 GUI Vim 支持三种输入方式: |OverTheSpot||OffTheSpot||Root|

*. on-the-spot *OnTheSpot*
客户软件在其所用显示区内执行预编辑区和状态区。客户软件由 |IM-server| 控制
Expand Down
Loading

0 comments on commit 564e870

Please sign in to comment.