runtime(doc): Tweak documentation style
Commit:
https://github.com/vim/vim/commit/57eb1d496bd2337847da9c290b7e1e15177da144
Author: Hirohito Higashi <[email protected]>
Date: Sun Aug 10 09:12:46 2025 +0200
runtime(doc): Tweak documentation style
closes: https://github.com/vim/vim/issues/17959
Signed-off-by: Hirohito Higashi <[email protected]>
Signed-off-by: Christian Brabandt <[email protected]>
diff --git a/runtime/autoload/vimcomplete.vim b/runtime/autoload/vimcomplete.vim
index 81fdf0f7c..7536727a6 100644
--- 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 <[email protected]>
-# 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 8fc3121ab..e31e3573e 100644
--- 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 13007488d..4b2cbc84f 100644
--- 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 fa2135eb4..9b0f89dbe 100644
--- a/runtime/ftplugin/vim.vim
+++ b/runtime/ftplugin/vim.vim
@@ -1,15 +1,14 @@
" Vim filetype plugin
" Language: Vim
" Maintainer: Doug Kearns <[email protected]>
-" Last Change: 2025 Aug 07
" Former Maintainer: Bram Moolenaar <[email protected]>
" Contributors: Riley Bruins <[email protected]> ('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 3e9760e47..667dadd2b 100644
--- 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.
--
--
You received this message from the "vim_dev" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php
---
You received this message because you are subscribed to the Google Groups
"vim_dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion visit
https://groups.google.com/d/msgid/vim_dev/E1ul0Gp-005yyu-JN%40256bit.org.
