runtime(doc): Tweak documentation style a bit

closes: #16556

Signed-off-by: Christian Brabandt <cb@256bit.org>
Signed-off-by: Hirohito Higashi <h.east.727@gmail.com>

diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index 1837661bd55b90784b3fc5886464f25fe02c8c91..6f5219cddf329fb37635158837a958aadf583a4a 100644 (file)
--- a/runtime/doc/builtin.txt
+++ b/runtime/doc/builtin.txt
@@ -1,4 +1,4 @@
-*builtin.txt*  For Vim version 9.1.  Last change: 2025 Jan 17
+*builtin.txt*  For Vim version 9.1.  Last change: 2025 Feb 01
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -610,8 +610,7 @@ split({expr} [, {pat} [, {keepempty}]])
 sqrt({expr})                   Float   square root of {expr}
 srand([{expr}])                        List    get seed for |rand()|
 state([{what}])                        String  current state of Vim
-str2blob({list} [, {options}])
-                               Blob    convert list of strings into a Blob
+str2blob({list} [, {options}]) Blob    convert list of strings into a Blob
 str2float({expr} [, {quoted}]) Float   convert String to Float
 str2list({expr} [, {utf8}])    List    convert each character of {expr} to
                                        ASCII/UTF-8 value

diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index e6decee5e8b50ef55c090c2ece52c60f75829718..22ea4219771b413165512b1df21de81595717eaa 100644 (file)
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -1,4 +1,4 @@
-*options.txt*  For Vim version 9.1.  Last change: 2025 Jan 31
+*options.txt*  For Vim version 9.1.  Last change: 2025 Feb 01
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -5096,7 +5096,7 @@ A jump table for the options with a short description can be found at |Q_op|.
           set keyprotocol=kitty:kitty,foot:kitty,ghostty:kitty,wezterm:kitty
           set keyprotocol+=xterm:mok2
 
-<      This means that when 'term' contains "kitty, "foot", "ghostty"  or
+<      This means that when 'term' contains "kitty, "foot", "ghostty" or
        "wezterm" somewhere, then the "kitty" protocol is used.  When 'term'
        contains "xterm" somewhere, then the "mok2" protocol is used.
 

diff --git a/runtime/doc/usr_02.txt b/runtime/doc/usr_02.txt
index 00d496253ebfe57e4d72e27d0790401066d1477a..e52853a820f5843972f5e3e787d3491778ed5ed2 100644 (file)
--- a/runtime/doc/usr_02.txt
+++ b/runtime/doc/usr_02.txt
@@ -1,4 +1,4 @@
-*usr_02.txt*   For Vim version 9.1.  Last change: 2025 Jan 16
+*usr_02.txt*   For Vim version 9.1.  Last change: 2025 Feb 01
 
                     VIM USER MANUAL - by Bram Moolenaar
 
@@ -698,8 +698,8 @@ Summary:                                    *help-summary*  >
      package-<name>. So >
        :help package-comment
 <
-    will bring you to the help section for the included comment plugin and how to
-    enable it.
+    will bring you to the help section for the included comment plugin and how
+    to enable it.
 
 
 ==============================================================================

diff --git a/runtime/doc/usr_25.txt b/runtime/doc/usr_25.txt
index 5b4df0d0e6c89035da7366312b15ef0de2c8927b..54fd6bc51b90e609adc2a276fdb9ff1049c2d02e 100644 (file)
--- a/runtime/doc/usr_25.txt
+++ b/runtime/doc/usr_25.txt
@@ -1,4 +1,4 @@
-*usr_25.txt*   For Vim version 9.1.  Last change: 2025 Jan 11
+*usr_25.txt*   For Vim version 9.1.  Last change: 2025 Feb 01
 
                     VIM USER MANUAL - by Bram Moolenaar
 
@@ -190,7 +190,7 @@ This results in the following:
        story. ~
 
 
-JUSTIFYING TEXT                        *justify* *:Justify* *Justify()* *package-justify*
+JUSTIFYING TEXT                *justify* *:Justify* *Justify()* *package-justify*
 
 Vim has no built-in way of justifying text.  However, there is a neat macro
 package that does the job.  To use this package, execute the following

diff --git a/runtime/doc/version9.txt b/runtime/doc/version9.txt
index 87c603960ae0da3a97a608699a8ee39cc586c342..2e16e09fccd9c229cc3ec6aaa7e46f29652bd109 100644 (file)
--- a/runtime/doc/version9.txt
+++ b/runtime/doc/version9.txt
@@ -1,4 +1,4 @@
-*version9.txt*  For Vim version 9.1.  Last change: 2025 Jan 26
+*version9.txt*  For Vim version 9.1.  Last change: 2025 Feb 01
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -41563,7 +41563,7 @@ Support for the XDG Desktop Specification |xdg-base-dir|
 Support for translating messages in Vim script plugins using the |gettext()|
 and |bindtextdomain()| functions.
 
-Support highlighting the matched text  and the completion kind for insert-mode
+Support highlighting the matched text and the completion kind for insert-mode
 completion and command-line completion in |ins-completion-menu|, see
 |complete-items|
 
@@ -41571,6 +41571,19 @@ Include the "linematch" algorithm for the 'diffopt' setting.  This aligns
 changes between buffers on similar lines improving the diff highlighting in
 Vim
 
+Adjusted default values ~
+-----------------------
+- the default 'history' option value has been increased to 200 and removed
+  from |defaults.vim|
+- the default 'backspace' option for Vim has been set to "indent,eol,start"
+  and removed from |defaults.vim|
+- the default fontsize for the GTK builds of Vim (Windows and Unix) has been
+  increased to 12pt to accomodate modern high-dpi monitors
+- the default value of the 'keyprotocol' option has been updated and support
+  for the ghostty terminal emulator (using kitty protocol) has been added
+- 'termguicolors' is automatically enabled if the terminal supports the RGB
+  terminfo capability or supports 0x1000000 colors
+
                                                        *changed-9.2*
 Changed~
 -------
@@ -41611,16 +41624,8 @@ Changed~
 - allow to pass local Vim script variables to python interpreter |py3eval()|
 - |getwininfo()| now also returns the "leftcol" property for a window
 - 'rulerformat' now supports the |stl-%!| item
-- the default 'history' option value has been increased to 200 and removed
-  from |defaults.vim|
-- the default 'backspace' option for Vim has been set to "indent,eol,start"
-  and removed from |defaults.vim|
 - the completed word and completion type are provided when handling the
   |CompleteDone| autocommand in the |v:event| dictionary
-- the default fontsize for the GTK builds of Vim (Windows and Unix) has been
-  increased to 12pt to accomodate modern high-dpi monitors
-- the default value of the 'keyprotocol' option has been updated by support
-  for the ghostty terminal emulator (using kitty protocol)
 - |complete_info()| returns the list of matches shown in the poppu menu via
   the "matches" key
 - |v:stacktrace| The stack trace of the exception most recently caught and
@@ -41630,8 +41635,6 @@ Changed~
        "preinsert"     - highlight to be inserted values
 - add |dist#vim9#Launch()| and |dist#vim9#Open()| to the |vim-script-library|
   and decouple it from |netrw|
-- 'termguicolors' is automatically enabled if the terminal supports the RGB
-  terminfo capability or supports 0x1000000 colors
 
                                                        *added-9.2*
 Added ~