runtime(doc): Tweak documentation style

closes: #17959

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

diff --git a/runtime/autoload/vimcomplete.vim b/runtime/autoload/vimcomplete.vim
index 81fdf0f7c14baa4becbecad8f0fe9debe7a69fc1..7536727a68b1252cdfcff6f7d8636fc2cb99268f 100644 (file)
--- a/runtime/autoload/vimcomplete.vim
+++ b/runtime/autoload/vimcomplete.vim
@@ -1,14 +1,14 @@
 vim9script
 
 # Vim completion script
-# Language:    Vimscript
+# Language:    Vim script
 # Maintainer:  Maxim Kim <habamax@gmail.com>
-# Last Change: 2025-07-28
+# Last Change: 2025-08-10
 #
 # Usage:
 # setlocal omnifunc=vimcomplete#Complete
 #
-# Simple complete function for the Vimscript
+# Simple complete function for Vim script
 
 var trigger: string = ""
 var prefix: string = ""

diff --git a/runtime/doc/develop.txt b/runtime/doc/develop.txt
index 8fc3121abe4b3196e6fb9a369ce30621eec45e2d..e31e3573ee3875a0433c162433144217644e71ac 100644 (file)
--- a/runtime/doc/develop.txt
+++ b/runtime/doc/develop.txt
@@ -1,4 +1,4 @@
-*develop.txt*   For Vim version 9.1.  Last change: 2025 Aug 08
+*develop.txt*   For Vim version 9.1.  Last change: 2025 Aug 10
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -308,11 +308,11 @@ Vim's main Makefiles target maximum portability, relying solely on features
 defined in POSIX.1-2001 `make` and ignoring later POSIX standards or GNU/BSD
 extensions.  In practical terms, avoid:
 
-       – % pattern rules
-       – modern assignment (`:=`, `::=`) outside POSIX.1-2001
-       – special targets (`.ONESHELL`, `.NOTPARALLEL`, `.SILENT`, …)
-       – order-only prerequisites (`|`) or automatic directory creation
-       – GNU/BSD conditionals (`ifdef`, `ifndef`, `.for`/`.endfor`, …)
+       - % pattern rules
+       - modern assignment (`:=`, `::=`) outside POSIX.1-2001
+       - special targets (`.ONESHELL`, `.NOTPARALLEL`, `.SILENT`, ...)
+       - order-only prerequisites (`|`) or automatic directory creation
+       - GNU/BSD conditionals (`ifdef`, `ifndef`, `.for`/`.endfor`, ...)
 
 Since POSIX.1-2001 supports only traditional suffix rules, every object built
 in a separate directory must have an explicit rule.  For example:
@@ -339,9 +339,9 @@ Therefore, the latest ISO C standard we follow is:
        `C95` (ISO/IEC 9899:1990/AMD1:1995)
 
 In addition, the following `C99` features are explicitly allowed:
-       – logical lines may contain up to 4095 characters;
-       – `//` comments, as required by |style-comments|;
-       – the `_Bool` type.
+       - `//` comments, as required by |style-comments|;
+       - the `_Bool` type.
+       - logical lines may contain up to 4095 characters;
 
 Platform-specific code may use any newer compiler features supported on that
 platform.
@@ -349,11 +349,11 @@ platform.
 
 SIZE OF VARIABLES                              *assumptions-variables*
 
-We follow POSIX.1‑2001 (SUSv3) for type sizes, which in practice means:
+We follow POSIX.1-2001 (SUSv3) for type sizes, which in practice means:
 
-       char_u      8-bit unsigned
-       int         ≥ 32-bit signed
-       unsigned    ≥ 32-bit unsigned
+       char_u      8-bit unsigned
+       int         32-bit or larger signed
+       unsigned    32-bit or larger unsigned
 
 
 ==============================================================================

diff --git a/runtime/doc/filetype.txt b/runtime/doc/filetype.txt
index 13007488d8954aa4188b1fa84ecc6a632f3c016c..4b2cbc84f9402955d2e8ffad62a0d4b9d0512158 100644 (file)
--- a/runtime/doc/filetype.txt
+++ b/runtime/doc/filetype.txt
@@ -1,4 +1,4 @@
-*filetype.txt* For Vim version 9.1.  Last change: 2025 Aug 06
+*filetype.txt* For Vim version 9.1.  Last change: 2025 Aug 10
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -1072,7 +1072,7 @@ The Vim filetype plugin defines the following mappings:
     ]"         move to the next (legacy) comment
     ["         move to the previous (legacy) comment
     gf         edit the file under the cursor
-    CTRL-W gf  edit the file under the cursor in a new tab
+    CTRL-W gf  edit the file under the cursor in a new tab page
     CTRL-W f   edit the file under the cursor in a new window
 
 

diff --git a/runtime/ftplugin/vim.vim b/runtime/ftplugin/vim.vim
index fa2135eb4cb0015dabaeeba1b94ff0c5c0e01bee..9b0f89dbef0ab0d8af62189ce054d35f155a6bd5 100644 (file)
--- a/runtime/ftplugin/vim.vim
+++ b/runtime/ftplugin/vim.vim
@@ -1,15 +1,14 @@
 " Vim filetype plugin
 " Language:          Vim
 " Maintainer:        Doug Kearns <dougkearns@gmail.com>
-" Last Change:       2025 Aug 07
 " Former Maintainer: Bram Moolenaar <Bram@vim.org>
 " Contributors:      Riley Bruins <ribru17@gmail.com> ('commentstring')
 "                    @Konfekt
 "                    @tpope (s:Help())
 "                    @lacygoill
-" Last Change:       2025 Mar 05
+" Last Change:       2025 Aug 07
 " 2025 Aug 06 by Vim Project (add gf maps #17881)
-" 2025 Aug 08 by Vim Project (add vimscript complete function #17871)
+" 2025 Aug 08 by Vim Project (add Vim script complete function #17871)
 
 " Only do this when not done yet for this buffer
 if exists("b:did_ftplugin")

diff --git a/runtime/pack/dist/opt/helptoc/doc/helptoc.txt b/runtime/pack/dist/opt/helptoc/doc/helptoc.txt
index 3e9760e4741ff37c180ae7aa82574bf18b387d26..667dadd2b12fe9ec778039a6aa088f9dff45f497 100644 (file)
--- a/runtime/pack/dist/opt/helptoc/doc/helptoc.txt
+++ b/runtime/pack/dist/opt/helptoc/doc/helptoc.txt
@@ -1,4 +1,4 @@
-*helptoc.txt*   For Vim version 9.1.  Last change:  2025 Aug 06
+*helptoc.txt*   For Vim version 9.1.  Last change:  2025 Aug 10
 
 
                          VIM REFERENCE MANUAL
@@ -178,7 +178,7 @@ brackets preceding and following each heading's text.
 
 3.7 vim                                                *HelpToc-vim-filetype*
 
-Vimscript and Vim9 script do not have headings or levels inherently like
+Vim script and Vim9 script do not have headings or levels inherently like
 markup languages.  However, Vim provides for |folds| defined by markers (|{{{|),
 which themselves may be succeeded by a number explicitly indicating the fold
 level.  This is the structure recognized and supported by helptoc.vim.