0
0
mirror of https://github.com/vim/vim.git synced 2025-11-13 22:54:27 -05:00

runtime(doc): Wrap some overlength lines in the user manual

closes: #18696

Signed-off-by: Doug Kearns <dougkearns@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
Doug Kearns
2025-11-08 17:18:16 +00:00
committed by Christian Brabandt
parent c28b73d349
commit a3063f2f90
9 changed files with 43 additions and 39 deletions

View File

@@ -1,4 +1,4 @@
*usr_02.txt* For Vim version 9.1. Last change: 2025 Oct 26 *usr_02.txt* For Vim version 9.1. Last change: 2025 Nov 07
VIM USER MANUAL by Bram Moolenaar VIM USER MANUAL by Bram Moolenaar
@@ -522,8 +522,8 @@ Summary: *help-summary* >
< You can see the user guide topics |03.9| and |usr_27.txt| in the < You can see the user guide topics |03.9| and |usr_27.txt| in the
introduction. introduction.
3) Options are enclosed in single apostrophes. To go to the help topic for the 3) Options are enclosed in single apostrophes. To go to the help topic for
list option: > the list option: >
:help 'list' :help 'list'
< If you only know you are looking for a certain option, you can also do: > < If you only know you are looking for a certain option, you can also do: >
:help options.txt :help options.txt

View File

@@ -1,4 +1,4 @@
*usr_09.txt* For Vim version 9.1. Last change: 2025 Oct 26 *usr_09.txt* For Vim version 9.1. Last change: 2025 Nov 07
VIM USER MANUAL by Bram Moolenaar VIM USER MANUAL by Bram Moolenaar
@@ -132,8 +132,8 @@ select text in a standard manner. The X Window system also has a standard
system for using the mouse. Unfortunately, these two standards are not the system for using the mouse. Unfortunately, these two standards are not the
same. same.
Fortunately, you can customize Vim. You can make the behavior of the mouse Fortunately, you can customize Vim. You can make the behavior of the mouse
work like an X Window system mouse or a Microsoft Windows mouse. The following work like an X Window system mouse or a Microsoft Windows mouse. The
command makes the mouse behave like an X Window mouse: > following command makes the mouse behave like an X Window mouse: >
:behave xterm :behave xterm

View File

@@ -1,4 +1,4 @@
*usr_10.txt* For Vim version 9.1. Last change: 2025 Oct 26 *usr_10.txt* For Vim version 9.1. Last change: 2025 Nov 07
VIM USER MANUAL by Bram Moolenaar VIM USER MANUAL by Bram Moolenaar
@@ -296,8 +296,8 @@ five lines before the last line in the file.
USING MARKS USING MARKS
Instead of figuring out the line numbers of certain positions, remembering them Instead of figuring out the line numbers of certain positions, remembering
and typing them in a range, you can use marks. them and typing them in a range, you can use marks.
Place the marks as mentioned in chapter 3. For example, use "mt" to mark Place the marks as mentioned in chapter 3. For example, use "mt" to mark
the top of an area and "mb" to mark the bottom. Then you can use this range the top of an area and "mb" to mark the bottom. Then you can use this range
to specify the lines between the marks (including the lines with the marks): > to specify the lines between the marks (including the lines with the marks): >
@@ -736,9 +736,10 @@ of the program replaces these lines.
line 44 line 55 line 44 line 55
last line last line last line last line
The "!!" command filters the current line through a filter. In Unix the "date" The "!!" command filters the current line through a filter. In Unix the
command prints the current time and date. "!!date<Enter>" replaces the current "date" command prints the current time and date. "!!date<Enter>" replaces the
line with the output of "date". This is useful to add a timestamp to a file. current line with the output of "date". This is useful to add a timestamp to
a file.
Note: There is a difference between "!cmd" (e.g. using it without any file Note: There is a difference between "!cmd" (e.g. using it without any file
range) and "{range}!cmd". While the former will simply execute the external range) and "{range}!cmd". While the former will simply execute the external

View File

@@ -1,4 +1,4 @@
*usr_22.txt* For Vim version 9.1. Last change: 2025 Oct 26 *usr_22.txt* For Vim version 9.1. Last change: 2025 Nov 07
VIM USER MANUAL by Bram Moolenaar VIM USER MANUAL by Bram Moolenaar
@@ -30,15 +30,15 @@ Vim has a plugin that makes it possible to edit a directory. Try this: >
Through the magic of autocommands and Vim scripts, the window will be filled Through the magic of autocommands and Vim scripts, the window will be filled
with the contents of the directory. It looks like this (slightly cleaned up with the contents of the directory. It looks like this (slightly cleaned up
so that it fits within 80 chars): > so that it fits within 78 chars): >
" =========================================================================== " ==========================================================================
" Netrw Directory Listing (netrw v180) " Netrw Directory Listing (netrw v180)
" /path/to/vim/runtime/doc " /path/to/vim/runtime/doc
" Sorted by name " Sorted by name
" Sort sequence: [\/]$,*,\(\.bak\|\~\|\.o\|\.h\|\.info\|\.swp\)[*@]\=$ " Sort sequence: [\/]$,*,\(\.bak\|\~\|\.o\|\.h\|\.info\|\.swp\)[*@]\=$
" Quick Help: <F1>:help -:go up dir D:delete R:rename s:sort-by x:special " Quick Help: <F1>:help -:go up dir D:delete R:rename s:sort-by x:special
" =========================================================================== " ==========================================================================
../ ../
./ ./
check/ check/

View File

@@ -1,4 +1,4 @@
*usr_24.txt* For Vim version 9.1. Last change: 2025 Oct 26 *usr_24.txt* For Vim version 9.1. Last change: 2025 Nov 07
VIM USER MANUAL by Bram Moolenaar VIM USER MANUAL by Bram Moolenaar
@@ -567,8 +567,8 @@ that combination. Thus CTRL-K dP also works. Since there is no digraph for
Note: Note:
The digraphs depend on the character set that Vim assumes you are The digraphs depend on the character set that Vim assumes you are
using. Always use ":digraphs" to find out which digraphs are currently using. Always use ":digraphs" to find out which digraphs are
available. currently available.
You can define your own digraphs by specifying the target character with a You can define your own digraphs by specifying the target character with a
decimal number. Example: > decimal number. Example: >

View File

@@ -1,4 +1,4 @@
*usr_30.txt* For Vim version 9.1. Last change: 2025 Oct 26 *usr_30.txt* For Vim version 9.1. Last change: 2025 Nov 07
VIM USER MANUAL by Bram Moolenaar VIM USER MANUAL by Bram Moolenaar
@@ -37,9 +37,9 @@ you give) and captures the results: >
If errors were generated, they are captured and the editor positions you where If errors were generated, they are captured and the editor positions you where
the first error occurred. the first error occurred.
Take a look at an example ":make" session. (Typical :make sessions generate Take a look at an example ":make" session. (Typical :make sessions
far more errors and fewer stupid ones.) After typing ":make" the screen looks generate far more errors and fewer stupid ones.) After typing ":make" the
like this: screen looks like this:
:!make | &tee /tmp/vim215953.err ~ :!make | &tee /tmp/vim215953.err ~
gcc -g -Wall -o prog main.c sub.c ~ gcc -g -Wall -o prog main.c sub.c ~

View File

@@ -1,4 +1,4 @@
*usr_40.txt* For Vim version 9.1. Last change: 2025 Oct 26 *usr_40.txt* For Vim version 9.1. Last change: 2025 Nov 07
VIM USER MANUAL by Bram Moolenaar VIM USER MANUAL by Bram Moolenaar
@@ -385,8 +385,8 @@ Some of the other options and keywords are as follows:
-count={number} The command can take a count whose default is -count={number} The command can take a count whose default is
{number}. The resulting count can be used {number}. The resulting count can be used
through the <count> keyword. through the <count> keyword.
-bang You can use a !. If present, using <bang> will -bang You can use a !. If present, using <bang>
result in a !. will result in a !.
-register You can specify a register. (The default is -register You can specify a register. (The default is
the unnamed register.) the unnamed register.)
The register specification is available as The register specification is available as
@@ -563,9 +563,9 @@ for the cprograms group: >
GROUPS GROUPS
The {group} item, used when defining an autocommand, groups related autocommands The {group} item, used when defining an autocommand, groups related
together. This can be used to delete all the autocommands in a certain group, autocommands together. This can be used to delete all the autocommands in a
for example. certain group, for example.
When defining several autocommands for a certain group, use the ":augroup" When defining several autocommands for a certain group, use the ":augroup"
command. For example, let's define autocommands for C programs: > command. For example, let's define autocommands for C programs: >

View File

@@ -1,4 +1,4 @@
*usr_41.txt* For Vim version 9.1. Last change: 2025 Oct 26 *usr_41.txt* For Vim version 9.1. Last change: 2025 Nov 07
VIM USER MANUAL by Bram Moolenaar VIM USER MANUAL by Bram Moolenaar
@@ -764,7 +764,8 @@ String manipulation: *string-functions*
charclass() class of a character charclass() class of a character
match() position where a pattern matches in a string match() position where a pattern matches in a string
matchbufline() all the matches of a pattern in a buffer matchbufline() all the matches of a pattern in a buffer
matchend() position where a pattern match ends in a string matchend() position where a pattern match ends in a
string
matchfuzzy() fuzzy matches a string in a list of strings matchfuzzy() fuzzy matches a string in a list of strings
matchfuzzypos() fuzzy matches a string in a list of strings matchfuzzypos() fuzzy matches a string in a list of strings
matchstr() match of a pattern in a string matchstr() match of a pattern in a string
@@ -841,7 +842,8 @@ List manipulation: *list-functions*
indexof() index in a List where an expression is true indexof() index in a List where an expression is true
max() maximum value in a List max() maximum value in a List
min() minimum value in a List min() minimum value in a List
count() count number of times a value appears in a List count() count number of times a value appears in a
List
repeat() repeat a List multiple times repeat() repeat a List multiple times
flatten() flatten a List flatten() flatten a List
flattennew() flatten a copy of a List flattennew() flatten a copy of a List
@@ -1246,7 +1248,8 @@ Mappings and Menus: *mapping-functions*
Testing: *test-functions* Testing: *test-functions*
assert_equal() assert that two expressions values are equal assert_equal() assert that two expressions values are equal
assert_equalfile() assert that two file contents are equal assert_equalfile() assert that two file contents are equal
assert_notequal() assert that two expressions values are not equal assert_notequal() assert that two expressions values are not
equal
assert_inrange() assert that an expression is inside a range assert_inrange() assert that an expression is inside a range
assert_match() assert that a pattern matches the value assert_match() assert that a pattern matches the value
assert_notmatch() assert that a pattern does not match the value assert_notmatch() assert that a pattern does not match the value

View File

@@ -1,4 +1,4 @@
*usr_44.txt* For Vim version 9.1. Last change: 2025 Oct 26 *usr_44.txt* For Vim version 9.1. Last change: 2025 Nov 07
VIM USER MANUAL by Bram Moolenaar VIM USER MANUAL by Bram Moolenaar
@@ -629,10 +629,10 @@ be included in the next Vim version!
ADDING TO AN EXISTING SYNTAX FILE ADDING TO AN EXISTING SYNTAX FILE
We were assuming you were adding a completely new syntax file. When an existing We were assuming you were adding a completely new syntax file. When an
syntax file works, but is missing some items, you can add items in a separate existing syntax file works, but is missing some items, you can add items in a
file. That avoids changing the distributed syntax file, which will be lost separate file. That avoids changing the distributed syntax file, which will
when installing a new version of Vim. be lost when installing a new version of Vim.
Write syntax commands in your file, possibly using group names from the Write syntax commands in your file, possibly using group names from the
existing syntax. For example, to add new variable types to the C syntax file: existing syntax. For example, to add new variable types to the C syntax file:
> >