Merge pull request #1763 from h-east/update-pi_netrw

Update pi_netrw.{txt,jax}

Author: h-east

doc/pi_netrw.jax

@@ -1,4 +1,4 @@
-*pi_netrw.txt*  For Vim バージョン 9.1.  Last change: 2024 Jul 13
+*pi_netrw.txt*  For Vim バージョン 9.1.  Last change: 2024 Oct 21
 
 	    ------------------------------------------------
 	    NETRW REFERENCE MANUAL    by Charles E. Campbell
@@ -1436,7 +1436,6 @@ NETRW CLEAN					*netrw-clean* *:NetrwClean* {{{2
 
 						*netrw-gx*
 ☆特殊ハンドラでブラウジングをカスタマイズ	*netrw-x* *netrw-handler* {{{2
-						(|netrw_filehandler|も参照)
 
 html, gif, jpeg, (word/office) doc などのファイルは専用ハンドラ (コンピュータ
 にあらかじめ備わっているようなツール) で処理するのが一番です。Netrw ではそのよ
@@ -1455,20 +1454,12 @@ Netrw は次の方法で専用ハンドラを決定します:
 <   or >
 	:let g:netrw_browsex_viewer= "xdg-open"
 <
-    g:netrw_browsex_viewer が '-' のときは netrwFileHandler#Invoke() が最初に
-    呼ばれます (|netrw_filehandler|参照)。
-
     もし、使いたいビューアがリモートURLディレクトリの処理をサポートしていない場合は、
     |g:netrw_browsex_support_remote| を 0 に設定してください。
   * Windows 32 or 64 では、URL と FileProtocolHandler dll が使われます。
   * Gnome (with gnome-open): gnome-open が使われます。
   * KDE (with kfmclient)   : kfmclient が使われます。
   * Mac OS X               : open が使われます。
-  * その他では netrwFileHandler プラグインが使われます。
-
-これらの方法ではファイルを処理するためのアプリケーションは拡張子によって決めら
-れます。例えば OpenOffice (*.sfx)、画像表示 (*.jpg, *.gif, etc)、PostScript
-(*.ps, *.eps) などに対応可能です。
 
 gx マッピングはすべてのバッファに適用できます。カーソル位置の単語に "gx" を適
 用すると、それに対し netrw は特別な処置を行います (ちょうど "x" が netrw バッ
@@ -1486,44 +1477,6 @@ gx マッピングはすべてのバッファに適用できます。カーソ
 	|g:netrw_nogx|	編集中 gx マップを無効にする
 	|g:netrw_suppress_gx_mesg| gx がブラウザーの出力を抑制するか制御する
 
-							*netrw_filehandler*
-
-|g:netrw_browsex_viewer| が存在し "-" である場合、netrw は特殊なファイルを vim
-の関数で処理しようと試みます。"x" マップはファイルの拡張子に応じて関数を呼び出
-します。ただし、あらかじめハンドラ関数を定義しておく必要があります。
->
- 例: mypgm.html   x -> NFH_html("scp://user@host/some/path/mypgm.html")
- 例: mypgm.html   x ->
-                  NFH_html("scp://user@host/some/path/mypgm.html")
-<
-	拡張子ごとのハンドラ関数を自分で定義できます。関数のサンプルは
-	<autoload/netrwFileHandlers.vim> を参照してください。例: >
-
-	" NFH_suffix(filename)
-	" NFH_拡張子(ファイル名)
-	fun! NFH_suffix(filename)
-	..ファイル名に応じた処理...
-	endfun
-<
-このような関数は .vim/plugin (vimfiles\plugin) ディレクトリ内のファイルで定義
-します。Vim では関数名に記号を含めることができません (アンダースコアは可)。記
-号を含む拡張子をサポートするため、拡張子は次のルールで変換されます: >
-
-    @ -> AT       ! -> EXCLAMATION    % -> PERCENT
-    : -> COLON    = -> EQUAL          ? -> QUESTION
-    , -> COMMA    - -> MINUS          ; -> SEMICOLON
-    $ -> DOLLAR   + -> PLUS           ~ -> TILDE
-<
-例: >
-
-	file.rcs,v  ->  NFH_rcsCOMMAv()
-<
-他にも変換が必要な文字があるようなら、メールでお知らせください: >
-		[email protected]
-(まず埋め込まれた NOSPAM を削除してください)
-
-関連設定: |g:netrw_browsex_viewer|
-
 							*netrw-curdir*
 ☆ブックマークを削除する				*netrw-mB* {{{2
 
@@ -2525,12 +2478,7 @@ netrw ブラウザーの各種設定は変数で管理されていて、それ
   *g:netrw_browsex_viewer*	ユーザー指定のビューア: >
 					"kfmclient exec"
 					"gnome-open"
-<				値が >
-					"-"
-<				なら、netrwFileHandler() によってファイルを処
-				理するスクリプト/関数が呼ばれます。
-				(|netrw_filehandler| 参照)
-
+<
   *g:netrw_browsex_support_remote*
 				指定しているビューアがリモートURLをサポートす
 				るかどうかを設定します(|netrw-handler| 参照)。

en/pi_netrw.txt

@@ -1,4 +1,4 @@
-*pi_netrw.txt*  For Vim version 9.1.  Last change: 2024 Jul 13
+*pi_netrw.txt*  For Vim version 9.1.  Last change: 2024 Oct 21
 
 	    ------------------------------------------------
 	    NETRW REFERENCE MANUAL    by Charles E. Campbell
@@ -1471,7 +1471,6 @@ permission to remove a file, it will issue an error message.
 
 						*netrw-gx*
 CUSTOMIZING BROWSING WITH A SPECIAL HANDLER	*netrw-x* *netrw-handler* {{{2
-						(also see |netrw_filehandler|)
 
 Certain files, such as html, gif, jpeg, (word/office) doc, etc, files, are
 best seen with a special handler (ie. a tool provided with your computer's
@@ -1490,21 +1489,12 @@ Netrw determines which special handler by the following method:
 <   or >
 	:let g:netrw_browsex_viewer= "xdg-open"
 <
-    If g:netrw_browsex_viewer == '-', then netrwFileHandlers#Invoke() will be
-    used instead (see |netrw_filehandler|).
-
     If the viewer you wish to use does not support handling of a remote URL
     directory, set |g:netrw_browsex_support_remote| to 0.
   * for Windows 32 or 64, the URL and FileProtocolHandler dlls are used.
   * for Gnome (with gnome-open): gnome-open is used.
   * for KDE (with kfmclient)   : kfmclient is used
   * for Mac OS X               : open is used.
-  * otherwise the netrwFileHandler plugin is used.
-
-The file's suffix is used by these various approaches to determine an
-appropriate application to use to "handle" these files.  Such things as
-OpenOffice (*.sfx), visualization (*.jpg, *.gif, etc), and PostScript (*.ps,
-*.eps) can be handled.
 
 The gx mapping extends to all buffers; apply "gx" while atop a word and netrw
 will apply a special handler to it (like "x" works when in a netrw buffer).
@@ -1521,46 +1511,6 @@ Associated setting variables:
 	|g:netrw_nogx|	prevent gx map while editing
 	|g:netrw_suppress_gx_mesg| controls gx's suppression of browser messages
 
-							*netrw_filehandler*
-
-When |g:netrw_browsex_viewer| exists and is "-", then netrw will attempt to
-handle the special file with a vim function.  The "x" map applies a function
-to a file, based on its extension.  Of course, the handler function must exist
-for it to be called!
->
- Ex. mypgm.html   x -> NFH_html("scp://user@host/some/path/mypgm.html")
-
-<	Users may write their own netrw File Handler functions to
-	support more suffixes with special handling.  See
-	<autoload/netrwFileHandlers.vim> for examples on how to make
-	file handler functions.   As an example: >
-
-	" NFH_suffix(filename)
-	fun! NFH_suffix(filename)
-	..do something special with filename..
-	endfun
-<
-These functions need to be defined in some file in your .vim/plugin
-(vimfiles\plugin) directory.  Vim's function names may not have punctuation
-characters (except for the underscore) in them.  To support suffices that
-contain such characters, netrw will first convert the suffix using the
-following table: >
-
-    @ -> AT       ! -> EXCLAMATION    % -> PERCENT
-    : -> COLON    = -> EQUAL          ? -> QUESTION
-    , -> COMMA    - -> MINUS          ; -> SEMICOLON
-    $ -> DOLLAR   + -> PLUS           ~ -> TILDE
-<
-So, for example: >
-
-	file.rcs,v  ->  NFH_rcsCOMMAv()
-<
-If more such translations are necessary, please send me email: >
-		[email protected]
-with a request.  (remove the embedded NOSPAM first)
-
-Associated setting variable: |g:netrw_browsex_viewer|
-
 							*netrw-curdir*
 DELETING BOOKMARKS					*netrw-mB* {{{2
 
@@ -2583,12 +2533,7 @@ your browsing preferences.  (see also: |netrw-settings|)
   *g:netrw_browsex_viewer*	specify user's preference for a viewer: >
 					"kfmclient exec"
 					"gnome-open"
-<				If >
-					"-"
-<				is used, then netrwFileHandler() will look for
-				a script/function to handle the given
-				extension.  (see |netrw_filehandler|).
-
+<
   *g:netrw_browsex_support_remote*
 				specify if the specified viewer supports a
 				remote URL.  (see |netrw-handler|).