patch 8.2.3825: various comments could be improved

Problem:    Various comments could be improved.
Solution:   Improve the comments.

diff --git a/src/getchar.c b/src/getchar.c
index 8c6b48d0cffd80f9357a7742fd79a73b36d93cf0..c3573547aa23bc7856aa9acde52a16deaa25a472 100644 (file)
--- a/src/getchar.c
+++ b/src/getchar.c
@@ -2677,7 +2677,7 @@ handle_mapping(
                if (mp == NULL)
                {
                    *keylenp = keylen;
-                   return map_result_get;    // got character, break for loop
+                   return map_result_get;    // get character from typeahead
                }
        }
 
@@ -3060,7 +3060,7 @@ vgetorpeek(int advance)
                                                      typebuf.tb_off];
                            del_typebuf(1, 0);
                        }
-                       break;
+                       break;  // got character, break the for loop
                    }
 
                    // not enough characters, get more

diff --git a/src/gui_motif.c b/src/gui_motif.c
index 67f9c632a112de0c3ff310cf4e9f5d0191bccabe..d79a414be7053d48a504884bc021c433853d598f 100644 (file)
--- a/src/gui_motif.c
+++ b/src/gui_motif.c
@@ -3995,7 +3995,7 @@ gui_mch_replace_dialog(exarg_T *eap)
 }
 
 /*
- * Synchronize all gui elements, which are dependant upon the
+ * Synchronize all gui elements, which are dependent upon the
  * main text font used. Those are in esp. the find/replace dialogs.
  * If you don't understand why this should be needed, please try to
  * search for "pi\xea\xb6\xe6" in iso8859-2.

diff --git a/src/mbyte.c b/src/mbyte.c
index 759be8bd7a9efa043672a2427b1b1932cbeec60d..0e9c926534f04253971da694aa618a49b57b3602 100644 (file)
--- a/src/mbyte.c
+++ b/src/mbyte.c
@@ -3847,6 +3847,11 @@ dbcs_screen_head_off(char_u *base, char_u *p)
     return (q == p) ? 0 : 1;
 }
 
+/*
+ * Return offset from "p" to the start of a character, including composing
+ * characters.  "base" must be the start of the string, which must be NUL
+ * terminated.
+ */
     int
 utf_head_off(char_u *base, char_u *p)
 {
@@ -4107,6 +4112,7 @@ mb_off_next(char_u *base, char_u *p)
 /*
  * Return the offset from "p" to the last byte of the character it points
  * into.  Can start anywhere in a stream of bytes.
+ * Composing characters are not included.
  */
     int
 mb_tail_off(char_u *base, char_u *p)

diff --git a/src/regexp_nfa.c b/src/regexp_nfa.c
index ffe894d4a497e0337d5bcfaa2e783ff699beacd2..9dc246d287dd2f4340c4e2d649083b9d451c6c95 100644 (file)
--- a/src/regexp_nfa.c
+++ b/src/regexp_nfa.c
@@ -18,7 +18,7 @@
  * The last three are enabled when compiled as debug mode and individually
  * disabled by commenting them out.
  * The log files can get quite big!
- * Do disable all of this when compiling Vim for debugging, undefine DEBUG in
+ * To disable all of this when compiling Vim for debugging, undefine DEBUG in
  * regexp.c
  */
 #ifdef DEBUG

diff --git a/src/testdir/test_edit.vim b/src/testdir/test_edit.vim
index 9e17636d746fd6bdd826ebb983082309906672fb..46a475221f6b8089b9e2177df36467ad7d69fcdd 100644 (file)
--- a/src/testdir/test_edit.vim
+++ b/src/testdir/test_edit.vim
@@ -1326,6 +1326,7 @@ func Test_edit_forbidden()
   call assert_fails(':Sandbox', 'E48:')
   delcom Sandbox
   call assert_equal(['a'], getline(1,'$'))
+
   " 2) edit with textlock set
   fu! DoIt()
     call feedkeys("i\<del>\<esc>", 'tnix')
@@ -1345,6 +1346,7 @@ func Test_edit_forbidden()
   catch /^Vim\%((\a\+)\)\=:E117/ " catch E117: unknown function
   endtry
   au! InsertCharPre
+
   " 3) edit when completion is shown
   fun! Complete(findstart, base)
     if a:findstart
@@ -1362,6 +1364,7 @@ func Test_edit_forbidden()
   endtry
   delfu Complete
   set completefunc=
+
   if has("rightleft") && exists("+fkmap")
     " 4) 'R' when 'fkmap' and 'revins' is set.
     set revins fkmap

diff --git a/src/version.c b/src/version.c
index 6576a55bd9a86ac675638578189ab0a68bae23a8..d1b667a5063c6d005016633c6d69bc98b36f48be 100644 (file)
--- a/src/version.c
+++ b/src/version.c
@@ -749,6 +749,8 @@ static char *(features[]) =
 
 static int included_patches[] =
 {   /* Add new patch number below this line */
+/**/
+    3825,
 /**/
     3824,
 /**/