Merge pull request #2543 from h-east/update-channel

Update channel.{txt,jax}

Author: h-east

doc/channel.jax

@@ -1,4 +1,4 @@
-*channel.txt*	For Vim バージョン 9.2.  Last change: 2026 Feb 25
+*channel.txt*	For Vim バージョン 9.2.  Last change: 2026 Mar 13
 
 
 		  VIM リファレンスマニュアル	by Bram Moolenaar
@@ -113,6 +113,32 @@ send を呼ぶたびに毎回コールバックを指定する代わりに、チ
 	call ch_logfile('channellog', 'w')
 |ch_logfile()| 参照.
 
+|ch_listen()| を使用すれば、Vim をサーバーとして動作させることもできる。この場
+合、外部のサーバープログラムは必要ない。
+
+							*channel-listen-demo*
+Vimを起動し、リスニングチャネルを作成する: >
+	func OnAccept(channel, clientaddr)
+	  " 接続をログする
+	  echomsg "Accepted connection from " .. a:clientaddr
+
+	  " 現在時刻を取得してクライアントに送信する
+	  let current_time = strftime("%Y-%m-%d %H:%M:%S")
+	  call ch_sendraw(a:channel, "Vim Server Time: " .. current_time .. "\n")
+
+	  " オプション: 時間だけを表示したい場合は、すぐに閉じる
+	  call ch_close(a:channel)
+	endfunc
+
+	" ポート 8765 でリッスンを開始する
+	let server = ch_listen('localhost:8765', {"callback": "OnAccept"})
+
+別の Vim インスタンス (または任意のプログラム) から接続できる: >
+	let channel = ch_open('localhost:8765')
+
+完了したら、サーバーチャネルを閉じる: >
+	call ch_close(server)
+
 ==============================================================================
 3. チャネルを開く					*channel-open*
 
@@ -637,6 +663,37 @@ ch_info({handle})						*ch_info()*
 <
 		戻り値の型: dict<any>
 
+ch_listen({address} [, {options}])		*E1573* *E1574* *ch_listen()*
+		着信チャネル接続を {address} で待機する。
+		これは、既存のサーバーに接続する |ch_open()| とは異なり、サー
+		バー側のチャネルを作成する。
+
+		チャネルを返す。|ch_status()| を使用して、失敗したかどうかを確
+		認すること。
+
+		{address} は文字列である。使用可能な形式については、
+		|channel-address|を参照。Note: IPv6 はまだサポートされていな
+		い。
+
+		{options} が指定されている場合は、|Dictionary| である必要があ
+		る。
+		|channel-open-options| を参照
+		{options} の "callback" は、新しい接続が受け入れられたときに呼
+		び出される。このコールバックは、新しいチャネルとクライアントア
+		ドレス (文字列形式、例: "127.0.0.1:12345") の 2 つの引数を受け
+		取る。
+
+		既存のサーバーに接続するには、代わりに |ch_open()| を使用する。
+
+		例については、|channel-listen-demo| を参照。
+
+		|method| としても使用できる: >
+			GetAddress()->ch_listen()
+<
+		{Vim が |+channel| 機能付きでコンパイルされたときのみ有効}
+
+		戻り値の型: channel
+
 ch_log({msg} [, {handle}])					*ch_log()*
 		|ch_logfile()| によってログファイルが開かれている場合はチャネ
 		ルのログファイルに文字列 {msg} を書き込む。
@@ -693,6 +750,9 @@ ch_open({address} [, {options}])				*ch_open()*
 		{options} が与えられる場合は辞書でなければならない。
 		|channel-open-options| を参照。
 
+		代わりに、入ってくる接続を待ち受けるには |ch_listen()| を使用
+		する。
+
 		|method| としても使用できる: >
 			GetAddress()->ch_open()
 <

en/channel.txt

@@ -1,4 +1,4 @@
-*channel.txt*	For Vim version 9.2.  Last change: 2026 Feb 25
+*channel.txt*	For Vim version 9.2.  Last change: 2026 Mar 13
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -114,6 +114,32 @@ Vim to write lines in log file: >
 	call ch_logfile('channellog', 'w')
 See |ch_logfile()|.
 
+You can also make Vim act as a server using |ch_listen()|.  This does not
+require an external server program.
+
+							*channel-listen-demo*
+Start Vim and create a listening channel: >
+	func OnAccept(channel, clientaddr)
+	  " Log the connection
+	  echomsg "Accepted connection from " .. a:clientaddr
+
+	  " Get current time and send it to the client
+	  let current_time = strftime("%Y-%m-%d %H:%M:%S")
+	  call ch_sendraw(a:channel, "Vim Server Time: " .. current_time .. "\n")
+
+	  " Optional: close immediately if you only want to provide the time
+	  call ch_close(a:channel)
+	endfunc
+
+	" Start listening on port 8765
+	let server = ch_listen('localhost:8765', {"callback": "OnAccept"})
+
+From another Vim instance (or any program) you can connect to it: >
+	let channel = ch_open('localhost:8765')
+
+When done, close the server channel: >
+	call ch_close(server)
+
 ==============================================================================
 3. Opening a channel					*channel-open*
 
@@ -641,6 +667,33 @@ ch_info({handle})						*ch_info()*
 <
 		Return type: dict<any>
 
+ch_listen({address} [, {options}])		*E1573* *E1574* *ch_listen()*
+		Listen on {address} for incoming channel connections.
+		This creates a server-side channel, unlike |ch_open()|
+		which connects to an existing server.
+		Returns a Channel.  Use |ch_status()| to check for failure.
+
+		{address} is a String, see |channel-address| for the possible
+		accepted forms.  Note: IPv6 is not yet supported.
+
+		If {options} is given it must be a |Dictionary|.
+		See |channel-open-options|.
+		The "callback" in {options} is invoked when a new
+		connection is accepted.  It receives two arguments: the
+		new Channel and the client address as a String (e.g.
+		"127.0.0.1:12345").
+
+		Use |ch_open()| to connect to an existing server instead.
+
+		See |channel-listen-demo| for an example.
+
+		Can also be used as a |method|: >
+			GetAddress()->ch_listen()
+<
+		{only available when compiled with the |+channel| feature}
+
+		Return type: channel
+
 ch_log({msg} [, {handle}])					*ch_log()*
 		Write String {msg} in the channel log file, if it was opened
 		with |ch_logfile()|.
@@ -695,6 +748,9 @@ ch_open({address} [, {options}])				*ch_open()*
 		If {options} is given it must be a |Dictionary|.
 		See |channel-open-options|.
 
+		Use |ch_listen()| to listen for incoming connections
+		instead.
+
 		Can also be used as a |method|: >
 			GetAddress()->ch_open()
 <