Merge pull request #274 from mnishz/develop_for_Vim_8.1

Update develop from Vim 8.0 to 8.1

Author: k-takata

doc/develop.jax

@@ -1,4 +1,4 @@
-*develop.txt*   For Vim バージョン 8.0.  Last change: 2017 Jul 31
+*develop.txt*   For Vim バージョン 8.1.  Last change: 2018 May 02
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -16,7 +16,8 @@ Vimの開発						*development*
 ソースコードの概要については "src" ディレクトリのREADME.txtを見てください。
 
 Vimはオープンソースソフトウェアです。誰でもVimの開発に協力できます。パッチを送
-る時はなるべく "context diff" 形式 ("diff -c" で作る) でお願いします。
+る時はなるべく "unified diff" 形式 ("diff -u" で作る) でお願いします。
+GitHub上でプルリクエストを作ることも可能ですが、必須ではありません。
 http://vim.wikia.com/wiki/How_to_make_and_submit_a_patch も見てください。
 
 ==============================================================================
@@ -185,14 +186,44 @@ MAKING CHANGES						*style-changes*
    るか GitHub でプルリクエストを作成する。
 
 
-C COMPILER						*style-compiler*
+C COMPILER				*style-compiler* *ANSI-C* *C89* *C99*
 
 サポートされている最小の C コンパイラのバージョンは C89 (ANSI C とも呼ばれてい
-る) である。C89 以降の標準規格にはあまり多くの機能追加が無く C89 はもっとも普及
-している。
+る) である。C99 のような後継の標準規格はあまり普及していない、もしくは少なくと
+も 100% サポートされているわけではない。したがって C99 のいくつかの機能だけを
+使用し、その他の使用は (少なくとも現時点では) 禁止する。
 
-この項目が暗に示している制限の1つとして、 // コメントではなく /* コメント */ を
-使わなければならない。
+現存するパッチに対してマージの問題を引き起こすため、C99の機能を使う変更を至る
+所に入れてはいけない。新しくコードを書く場合、もしくは既存のコードを書き直す場
+合に限り使用してもよい。
+
+コメント ~
+
+慣習的に Vim では /* コメント */ を使用する。特にファイルと関数のヘッダに関し
+てはこれを維持するつもりである。新しいコードもしくは変更される行については、
+// コメント を使用してもよい。特にコードの後ろに続くコメントなど:
+	int some_var;  // single line comment useful here
+
+列挙型 (Enums) ~
+
+列挙型の末尾の要素にコンマ (trailing comma) が付いていてもよい。C89 では認めら
+れていなかった。
+
+型 (Types) ~
+
+"long long" は使用してもよく、64 bit を想定している。printf では %lld を使用す
+ること。同じように "long long unsigned" では %llu を使用する。
+
+使用してはいけないもの ~
+
+これらの C99 の機能は、コンパイラのサポートが不十分なため使用してはいけない。
+- ステートメントの後の宣言 (MSVC 2012 はこれをサポートしていない)。すべての宣
+  言はブロックの先頭になければならない。
+- 可変長配列 (C11 でもこれはオプショナルな機能である)。
+- _Bool 型と _Complex 型。
+- "inline" (ほとんど必要ない、コンパイラに最適化させよう。)
+- フレキシブル配列メンバ: HP-UX C コンパイラはサポートしていない。(John
+  Marriott)
 
 
 USE OF COMMON FUNCTIONS					*style-functions*

en/develop.txt

@@ -1,4 +1,4 @@
-*develop.txt*   For Vim version 8.0.  Last change: 2017 Jul 31
+*develop.txt*   For Vim version 8.1.  Last change: 2018 May 02
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -18,7 +18,8 @@ See the file README.txt in the "src" directory for an overview of the source
 code.
 
 Vim is open source software.  Everybody is encouraged to contribute to help
-improving Vim.  For sending patches a context diff "diff -c" is preferred.
+improving Vim.  For sending patches a unified diff "diff -u" is preferred.
+You can create a pull request on github, but it's not required.
 Also see http://vim.wikia.com/wiki/How_to_make_and_submit_a_patch.
 
 ==============================================================================
@@ -182,12 +183,43 @@ The basic steps to make changes to the code:
    include the diff. Or create a pull request on github.
 
 
-C COMPILER						*style-compiler*
+C COMPILER				*style-compiler* *ANSI-C* *C89* *C99*
 
 The minimal C compiler version supported is C89, also known as ANSI C.
-Later standards don't add much and C89 is the widest supported.
+Later standards, such as C99, are not widely supported, or at least not 100%
+supported.  Therefore we use only some of the C99 features and disallow some
+(at least for now).
 
-One restriction that this implies: no // comments, only /* comments */.
+Please don't make changes everywhere to use the C99 features, it causes merge
+problems for existing patches.  Only use them for new and changed code.
+
+Comments ~
+
+Traditionally Vim uses /* comments */.  We intend to keep it that way,
+especially for file and function headers.  For new code or lines of code that
+change, it is allowed to use // comments.  Especially when it comes after
+code:
+	int some_var;  // single line comment useful here
+
+Enums ~
+
+The last item in an enum may have a trailing comma.  C89 didn't allow this.
+
+Types ~
+
+"long long" is allowed and can be expected to be 64 bits.  Use %lld in printf
+formats.  Also "long long unsigned" with %llu.
+
+Not to be used ~
+
+These C99 features are not to be used, because not enough compilers support
+them:
+- Declaration after Statements (MSVC 2012 does not support it).  All
+  declarations need to be at the start of the block.
+- Variable length arrays (even in C11 this is an optional feature).
+- _Bool and _Complex types.
+- "inline" (it's hardly ever needed, let the optimizer do its work)
+- flexible array members: Not supported by HP-UX C compiler (John Marriott)
 
 
 USE OF COMMON FUNCTIONS					*style-functions*