From 0c0734d527a132edfb4089be48486586424b3f41 Mon Sep 17 00:00:00 2001 From: Bram Moolenaar Date: Tue, 26 Nov 2019 21:44:46 +0100 Subject: Update runtime files --- runtime/doc/develop.txt | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) (limited to 'runtime/doc/develop.txt') diff --git a/runtime/doc/develop.txt b/runtime/doc/develop.txt index 59e44dcaab..6ced5156cb 100644 --- a/runtime/doc/develop.txt +++ b/runtime/doc/develop.txt @@ -1,4 +1,4 @@ -*develop.txt* For Vim version 8.1. Last change: 2019 Aug 05 +*develop.txt* For Vim version 8.1. Last change: 2019 Nov 22 VIM REFERENCE MANUAL by Bram Moolenaar @@ -195,10 +195,14 @@ 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: +Traditionally Vim uses /* comments */. We intend to keep it that way +for file and function headers and larger blocks of code, E.g.: + /* + * The "foo" argument does something useful. + * Return OK or FAIL. + */ +For new code or lines of code that change, it is preferred to use // comments. +Especially when it comes after code: int some_var; // single line comment useful here Enums ~ -- cgit v1.2.3