diff options
author | Bram Moolenaar <Bram@vim.org> | 2018-09-11 22:37:29 +0200 |
---|---|---|
committer | Bram Moolenaar <Bram@vim.org> | 2018-09-11 22:37:29 +0200 |
commit | 67f8ab829911c7901c534ef2bf19cc34b622936f (patch) | |
tree | 6d56b95950cb18a0261c0e72d685b612dbb246db /runtime/doc | |
parent | 25328e39d2a6e3ded82bf282a2e248ce7209f1b4 (diff) |
patch 8.1.0369: continuation lines cannot contain commentsv8.1.0369
Problem: Continuation lines cannot contain comments.
Solution: Support using "\ .
Diffstat (limited to 'runtime/doc')
-rw-r--r-- | runtime/doc/repeat.txt | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/runtime/doc/repeat.txt b/runtime/doc/repeat.txt index 55aed248b1..c4b38a32d8 100644 --- a/runtime/doc/repeat.txt +++ b/runtime/doc/repeat.txt @@ -465,6 +465,16 @@ flag when defining the function, it is not relevant when executing it. > . :endfunction :set cpo-=C +< + *line-continuation-comment* +To add a comment in between the lines start with '\" '. Notice the space +after the double quote. Example: > + let array = [ + "\ first entry comment + \ 'first', + "\ second entry comment + \ 'second', + \ ] Rationale: Most programs work with a trailing backslash to indicate line @@ -473,6 +483,14 @@ Rationale: :map xx asdf\ < Therefore the unusual leading backslash is used. + Starting a comment in a continuation line results in all following + continuation lines to be part of the comment. Since it was like this + for a long time, when making it possible to add a comment halfway a + sequence of continuation lines, it was not possible to use \", since + that was a valid continuation line. Using '"\ ' comes closest, even + though it may look a bit weird. Requiring the space after the + backslash is to make it very unlikely this is a normal comment line. + ============================================================================== 5. Using Vim packages *packages* |