adam/vim
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

runtime(doc): Tweak documentation style

Browse Source 
closes: #17824

Signed-off-by: Hirohito Higashi <h.east.727@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
Hirohito Higashi
2025-07-22 19:01:17 +02:00
committed by Christian Brabandt
parent 61cec2e761
commit 5711d76818
3 changed files with 19 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
runtime/doc/builtin.txt
View File

@ -1,4 +1,4 @@
*builtin.txt* For Vim version 9.1. Last change: 2025 Jul 21 *builtin.txt* For Vim version 9.1. Last change: 2025 Jul 22
VIM REFERENCE MANUAL by Bram Moolenaar VIM REFERENCE MANUAL by Bram Moolenaar
@ -12344,7 +12344,7 @@ wildtrigger() *wildtrigger()*
produce a beep when no matches are found and generally produce a beep when no matches are found and generally
operates more quietly. This makes it suitable for triggering operates more quietly. This makes it suitable for triggering
completion automatically, such as from an |:autocmd|. completion automatically, such as from an |:autocmd|.
*cmdline-autocompletion* *cmdline-autocompletion*
Example: To make the completion menu pop up automatically as Example: To make the completion menu pop up automatically as
you type on the command line, use: > you type on the command line, use: >
autocmd CmdlineChanged [:/?] call wildtrigger() autocmd CmdlineChanged [:/?] call wildtrigger()

31
runtime/doc/develop.txt
View File

@ -1,4 +1,4 @@
*develop.txt* For Vim version 9.1. Last change: 2025 Jul 21 *develop.txt* For Vim version 9.1. Last change: 2025 Jul 22
VIM REFERENCE MANUAL by Bram Moolenaar VIM REFERENCE MANUAL by Bram Moolenaar
@ -297,16 +297,16 @@ count.
============================================================================== ==============================================================================
3. Assumptions *design-assumptions* 3. Assumptions *design-assumptions*
The following sections define the portability and compatibility constraints that The following sections define the portability and compatibility constraints
all Vim code and build tools must adhere to. that all Vim code and build tools must adhere to.
MAKEFILES *assumptions-makefiles* MAKEFILES *assumptions-makefiles*
*POSIX.1-2001* *POSIX.1-2001*
Vim’s main Makefiles target maximum portability, relying solely on features Vim's main Makefiles target maximum portability, relying solely on features
defined in POSIX.1-2001 `make` and ignoring later POSIX standards or defined in POSIX.1-2001 `make` and ignoring later POSIX standards or GNU/BSD
GNU/BSD extensions. In practical terms, avoid: extensions. In practical terms, avoid:
– % pattern rules – % pattern rules
– modern assignment (`:=`, `::=`) outside POSIX.1-2001 – modern assignment (`:=`, `::=`) outside POSIX.1-2001
@ -314,19 +314,18 @@ GNU/BSD extensions. In practical terms, avoid:
– order-only prerequisites (`|`) or automatic directory creation – order-only prerequisites (`|`) or automatic directory creation
– GNU/BSD conditionals (`ifdef`, `ifndef`, `.for`/`.endfor`, …) – GNU/BSD conditionals (`ifdef`, `ifndef`, `.for`/`.endfor`, …)
Since POSIX.1-2001 supports only traditional suffix rules, every object Since POSIX.1-2001 supports only traditional suffix rules, every object built
built in a separate directory must have an explicit rule. For example: in a separate directory must have an explicit rule. For example:
objects/evalbuffer.o: evalbuffer.c objects/evalbuffer.o: evalbuffer.c
$(CCC) -o $@ evalbuffer.c $(CCC) -o $@ evalbuffer.c
This verbosity ensures that the same Makefile builds Vim unchanged with This verbosity ensures that the same Makefile builds Vim unchanged with the
the default `make` on Linux, *BSD, macOS, Solaris, AIX, HP-UX and virtually default `make` on Linux, *BSD, macOS, Solaris, AIX, HP-UX and virtually any
any Unix-like OS. Unix-like OS.
Some platform-specific Makefiles (e.g., for Windows, NSIS, or Cygwin) may Some platform-specific Makefiles (e.g., for Windows, NSIS, or Cygwin) may use
use more advanced features when compatibility with basic make is not more advanced features when compatibility with basic make is not required.
required.
C COMPILER *assumptions-C-compiler* C COMPILER *assumptions-C-compiler*
@ -343,8 +342,8 @@ In addition, the following two `C99` features are explicitly allowed:
– `//` comments, as required by |style-comments|; – `//` comments, as required by |style-comments|;
– the `_Bool` type. – the `_Bool` type.
Platform-specific code may use any newer compiler features supported on Platform-specific code may use any newer compiler features supported on that
that platform. platform.
SIZE OF VARIABLES *assumptions-variables* SIZE OF VARIABLES *assumptions-variables*

4
runtime/doc/eval.txt
View File

@ -1,4 +1,4 @@
*eval.txt* For Vim version 9.1. Last change: 2025 Jul 20 *eval.txt* For Vim version 9.1. Last change: 2025 Jul 22
VIM REFERENCE MANUAL by Bram Moolenaar VIM REFERENCE MANUAL by Bram Moolenaar
@ -3312,7 +3312,7 @@ text...
CODE CODE
< <
*E121* *E121*
:let {var-name} .. List the value of variable {var-name}. Multiple :let {var-name} ... List the value of variable {var-name}. Multiple
variable names may be given. Special names recognized variable names may be given. Special names recognized
here: *E738* here: *E738*
g: global variables g: global variables