Merge pull request #314 from mnishz/os_mac_for_Vim_8.1

Update os_mac from Vim 8.0 to 8.1

Author: h-east

doc/os_mac.jax

@@ -1,4 +1,4 @@
-*os_mac.txt*    For Vim バージョン 8.0.  Last change: 2006 Apr 30
+*os_mac.txt*    For Vim バージョン 8.1.  Last change: 2018 Jan 21
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -13,10 +13,12 @@ NOTE: このファイルの内容は少し古いです。つぎのサイトで
 
 1. ファイル名の決まりごと	|mac-filename|
 2. .vimrc と .vim ファイル	|mac-vimfile|
-3. FAQ				|mac-faq|
-4. 知られている不足事項		|mac-lack|
-5. Mac バグレポート		|mac-bug|
-6. Vim のコンパイル		|mac-compile|
+3. 標準のマップ			|mac-standard-mappings|
+4. FAQ				|mac-faq|
+5. 知られている不足事項		|mac-lack|
+6. Mac バグレポート		|mac-bug|
+7. Vim のコンパイル		|mac-compile|
+8. Darwin 機能			|mac-darwin-feature|
 
 以前には、Vimのバージョン3.0のMac移植版がありました。ここに以前のファイルの最
 初の数行を示します:
@@ -71,7 +73,19 @@ rcファイルは、"vimrc" または "_vimrc"、"gvimrc" または "_gvimrc" 
 ん。
 
 ==============================================================================
-3. Mac FAQ						*mac-faq*
+3. 標準のマップ					*mac-standard-mappings*
+
+クリップボードからのペーストやクリップボードへのカット/コピー用に、以下のマッ
+プを使用することができます。
+
+キー	    ノーマル	ビジュアル  挿入    説明 ~
+Command-v   "*P		"-d"*P      <C-R>*  テキストのペースト		*<D-v>*
+Command-c		"*y		    ビジュアルテキストのコピー	*<D-c>*
+Command-x		"*d		    ビジュアルテキストのカット	*<D-x>*
+Backspace		"*d		    ビジュアルテキストのカット
+
+==============================================================================
+4. Mac FAQ						*mac-faq*
 
 FAQ はインターネット上でも参照できます:  http://macvim.org/OSX/index.php#FAQ
 
@@ -94,13 +108,13 @@ A: ほとんどのシェルで次のトリックがうまくいきます。vimrc
 	let $PATH = matchstr(s:path, 'VIMPATH\zs.\{-}\ze\n')
 
 ==============================================================================
-4. 知られている不足事項					*mac-lack*
+5. 知られている不足事項					*mac-lack*
 
 ターミナルでは CTRL-^ は Shift-Control-6 とタイプする必要があります。CTRL-@ は
 Shift-Control-2 です。
 
 ==============================================================================
-5. Mac バグ レポート					*mac-bug*
+6. Mac バグ レポート					*mac-bug*
 
 Mac版の特定のバグや特性の変更をレポートするときは、vim-macメーリングリストを
 使ってください|vim-mac|。メーリングリストに登録したくないなら代わりにMacVimの
@@ -109,9 +123,60 @@ Mac版の特定のバグや特性の変更をレポートするときは、vim-m
 	mac@vim.org
 
 ==============================================================================
-6. Vim のコンパイル					*mac-compile*
+7. Vim のコンパイル					*mac-compile*
 
 ソースファイルと一緒にある "src/INSTALLmac.txt" を見てください。
 
+==============================================================================
+8. Darwin 機能						*mac-darwin-feature*
+
+とても古い Mac でなければ、Darwin とも呼ばれる OS X を使用しているでしょう。
+Darwin の 1 つ前の OS は Mac OS 9 です。Darwin 機能は Vim が Darwin 特有の資産
+を使えるようにします。
+
+この機能によって実現されるものは 2 つあります:
+
+- Vim をシステムクリップボードと連携可能にします。
+- いくつかのプラットフォーム特有の文字エンコーディングと Vim が認識しているそ
+  れらの差分を橋渡しする変換モジュールを Vim に組み入れます。
+
+言うまでもなく、同じデスクトップ環境上で動く他のアプリケーションとうまく連携す
+るまともなテキストエディタにとって、この両方は必要不可欠なものです。
+
+Vim は macOS 専用のアプリケーションではないので、他のプラットフォーム上のユー
+ザーが得ているユーザー体験を macOS 上の人々にも提供するための特別な機能を追加
+する必要があります。
+
+簡単のために、この特定のプラットフォームに特化した Vim の機能は "darwin" と呼
+ばれます。
+
+この機能は configuration のオプションです。したがって有効か無効かはビルド時に
+決定され、一度有効にするよう選択されると組み込まれてしまい、それゆえ実行時に無
+効にすることはできません。
+
+この機能は標準で有効になっています。簡単に後述する特別なニーズでもない限り、ほ
+とんどのユーザーにとってこれは満足のゆくものでしょう。
+
+無効にしたい場合は、configure スクリプトに `--disable-darwin` を渡してください:
+>
+    ./configure --disable-darwin <その他のオプション>
+
+その後 Vim をビルドするために `make` を実行してください。オプションの順番は関
+係ありません。
+
+実行時に darwin 機能が組み込まれているかどうかを確かめるには
+`has('osxdarwin')` を使用することができ、機能が組み込まれている場合には 1 が返
+り、それ以外では 0 が返ります。後方互換性のため、`osxdarwin` の代わりに
+`macunix` もまだ使用することができます。
+
+`--disable-darwin` が有用だと分かった着目すべきケースは次のとおりです:
+
+- システムクリップボードの代わりに |x11-selection| を使用したいとき。
+- |x11-clientserver| を使用したいとき。
+
+どちらも適切に動作するために X11 のクライアント間通信を利用する必要があって、
+通信メカニズムがシステムクリップボードと競合する可能性があるので、実行時に Vim
+が停止するのを防ぐため darwin 機能は無効にしておくべきです。
+
 
  vim:tw=78:ts=8:noet:ft=help:norl:

en/os_mac.txt

@@ -1,4 +1,4 @@
-*os_mac.txt*    For Vim version 8.0.  Last change: 2006 Apr 30
+*os_mac.txt*    For Vim version 8.1.  Last change: 2018 Jan 21
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar et al.
@@ -12,11 +12,13 @@ NOTE: This file is a bit outdated.  You might find more useful info here:
 	http://macvim.org/
 
 1. Filename Convention		|mac-filename|
-2. .vimrc an .vim files		|mac-vimfile|
-3. FAQ				|mac-faq|
-4. Known Lack			|mac-lack|
-5. Mac Bug Report		|mac-bug|
-6. Compiling Vim		|mac-compile|
+2. .vimrc and .vim files	|mac-vimfile|
+3. Standard mappings		|mac-standard-mappings|
+4. FAQ				|mac-faq|
+5. Known Lack			|mac-lack|
+6. Mac Bug Report		|mac-bug|
+7. Compiling Vim		|mac-compile|
+8. The darwin feature		|mac-darwin-feature|
 
 There was a Mac port for version 3.0 of Vim.  Here are the first few lines
 from the old file:
@@ -72,7 +74,18 @@ the |'nocompatible'| option is set, otherwise it will only handle mac format
 files.
 
 ==============================================================================
-3. Mac FAQ						*mac-faq*
+3. Standard mappings				*mac-standard-mappings*
+
+The following mappings are available for cut/copy/paste from/to clipboard.
+
+key		Normal	Visual	  Insert	Description ~
+Command-v	"*P	"-d"*P    <C-R>*	paste text       *<D-v>*
+Command-c		"*y			copy Visual text *<D-c>*
+Command-x		"*d			cut Visual text  *<D-x>*
+Backspace		"*d			cut Visual text
+
+==============================================================================
+4. Mac FAQ						*mac-faq*
 
 On the internet:  http://macvim.org/OSX/index.php#FAQ
 
@@ -95,13 +108,13 @@ A: The following trick works with most shells.  Put it in your vimrc file.
 	let $PATH = matchstr(s:path, 'VIMPATH\zs.\{-}\ze\n')
 
 ==============================================================================
-4. Mac Lack						*mac-lack*
+5. Mac Lack						*mac-lack*
 
 In a terminal CTRL-^ needs to be entered as Shift-Control-6.  CTRL-@ as
 Shift-Control-2.
 
 ==============================================================================
-5. Mac Bug Report					*mac-bug*
+6. Mac Bug Report					*mac-bug*
 
 When reporting any Mac specific bug or feature change, please use the vim-mac
 maillist |vim-mac|.  However, you need to be subscribed.  An alternative is to
@@ -110,9 +123,60 @@ send a message to the current MacVim maintainers:
 	mac@vim.org
 
 ==============================================================================
-6. Compiling Vim					*mac-compile*
+7. Compiling Vim					*mac-compile*
 
 See the file "src/INSTALLmac.txt" that comes with the source files.
 
+==============================================================================
+8. The Darwin Feature					*mac-darwin-feature*
+
+If you have a Mac that isn't very old, you will be running OS X, also called
+Darwin.  The last pre-Darwin OS was Mac OS 9.  The darwin feature makes Vim
+use Darwin-specific properties.
+
+What is accomplished with this feature is two-fold:
+
+- Make Vim interoperable with the system clipboard.
+- Incorporate into Vim a converter module that bridges the gap between some
+  character encodings specific to the platform and those known to Vim.
+
+Needless to say, both are not to be missed for any decent text editor to work
+nicely with other applications running on the same desktop environment.
+
+As Vim is not an application dedicated only to macOS, we need an extra feature
+to add in order for it to offer the same user experience that our users on
+other platforms enjoy to people on macOS.
+
+For brevity, the feature is referred to as "darwin" to signify it one of the
+Vim features that are specific to that particular platform.
+
+The feature is a configuration option.  Accordingly, whether it is enabled or
+not is determined at build time; once it is selected to be enabled, it is
+compiled in and hence cannot be disabled at runtime.
+
+The feature is enabled by default.  For most macOS users, that should be
+sufficient unless they have specific needs mentioned briefly below.
+
+If you want to disable it, pass `--disable-darwin` to the configure script: >
+
+    ./configure --disable-darwin <other options>
+
+and then run `make` to build Vim.  The order of the options doesn't matter.
+
+To make sure at runtime whether or not the darwin feature is compiled in, you
+can use `has('osxdarwin')` which returns 1 if the feature is compiled in; 0
+otherwise.  For backward compatibility, you can still use `macunix` instead of
+`osxdarwin`.
+
+Notable use cases where `--disable-darwin` is turned out to be useful are:
+
+- When you want to use |x11-selection| instead of the system clipboard.
+- When you want to use |x11-clientserver|.
+
+Since both have to make use of X11 inter-client communication for them to work
+properly, and since the communication mechanism can come into conflict with
+the system clipboard, the darwin feature should be disabled to prevent Vim
+from hanging at runtime.
+
 
  vim:tw=78:ts=8:noet:ft=help:norl: