-
-
Notifications
You must be signed in to change notification settings - Fork 5.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Make references to [range] consistent #13971
base: master
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -297,8 +297,8 @@ zf{motion} or | |
*zF* | ||
zF Create a fold for [count] lines. Works like "zf". | ||
|
||
:{range}fo[ld] *:fold* *:fo* | ||
Create a fold for the lines in {range}. Works like "zf". | ||
:[range]fo[ld] *:fold* *:fo* | ||
Create a fold for the lines in [range]. Works like "zf". | ||
|
||
*zd* *E351* | ||
zd Delete one fold at the cursor. When the cursor is on a folded | ||
|
@@ -399,15 +399,15 @@ zr Reduce folding: Add |v:count1| to 'foldlevel'. | |
zR Open all folds. This sets 'foldlevel' to highest fold level. | ||
|
||
*:foldo* *:foldopen* | ||
:{range}foldo[pen][!] | ||
Open folds in {range}. When [!] is added all folds are | ||
opened. Useful to see all the text in {range}. Without [!] | ||
:[range]foldo[pen][!] | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. same here |
||
Open folds in [range]. When [!] is added all folds are | ||
opened. Useful to see all the text in [range]. Without [!] | ||
one level of folds is opened. | ||
|
||
*:foldc* *:foldclose* | ||
:{range}foldc[lose][!] | ||
Close folds in {range}. When [!] is added all folds are | ||
closed. Useful to hide all the text in {range}. Without [!] | ||
:[range]foldc[lose][!] | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. same here |
||
Close folds in [range]. When [!] is added all folds are | ||
closed. Useful to hide all the text in [range]. Without [!] | ||
one level of folds is closed. | ||
|
||
*zn* | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -1161,7 +1161,7 @@ The commands are sorted on the non-optional part of their name. | |
tag command action ~ | ||
------------------------------------------------------------------------------ | ||
|:| : nothing | ||
|:range| :{range} go to last line in {range} | ||
|:[range]| :{range} go to last line in {range} (normally denoted |[range]|) | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. same here, [range] is not really optionally There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The issue here is |
||
|:!| :! filter lines or execute an external command | ||
|:!!| :!! repeat last ":!" command | ||
|:#| :# same as ":number" | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -1972,8 +1972,8 @@ too long when appending characters a line break is automatically inserted. | |
9. Ex insert commands *inserting-ex* | ||
|
||
*:a* *:append* | ||
:{range}a[ppend][!] Insert several lines of text below the specified | ||
line. If the {range} is missing, the text will be | ||
:[range]a[ppend][!] Insert several lines of text below the specified | ||
line. If the [range] is missing, the text will be | ||
inserted after the current line. | ||
Adding [!] toggles 'autoindent' for the time this | ||
command is executed. | ||
|
@@ -1982,8 +1982,8 @@ too long when appending characters a line break is automatically inserted. | |
name. | ||
|
||
*:i* *:in* *:insert* | ||
:{range}i[nsert][!] Insert several lines of text above the specified | ||
line. If the {range} is missing, the text will be | ||
:[range]i[nsert][!] Insert several lines of text above the specified | ||
line. If the [range] is missing, the text will be | ||
inserted before the current line. | ||
Adding [!] toggles 'autoindent' for the time this | ||
command is executed. | ||
|
@@ -2043,7 +2043,7 @@ NOTE: These commands cannot be used with |:global| or |:vglobal|. | |
the cursor. | ||
See |++opt| for the possible values of [++opt]. | ||
|
||
:{range}r[ead] [++opt] [name] | ||
:[range]r[ead] [++opt] [name] | ||
Insert the file [name] (default: current file) below | ||
the specified line. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Below the specified {range} ? |
||
See |++opt| for the possible values of [++opt]. | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -1455,7 +1455,7 @@ Context-sensitive completion on the command-line: | |
set foldmethod=marker folding by 'foldmarker' | ||
|
||
|zf| zf{motion} operator: Define a fold manually | ||
|:fold| :{range}fold define a fold for {range} lines | ||
|:fold| :[range]fold define a fold for [range] lines | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. not really optionally I think. |
||
|zd| zd delete one fold under the cursor | ||
|zD| zD delete all folds under the cursor | ||
|
||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -116,7 +116,7 @@ See |:verbose-cmd| for more information. | |
When the [range] argument is added, the function is | ||
expected to take care of a range itself. The range is | ||
passed as "a:firstline" and "a:lastline". If [range] | ||
is excluded, ":{range}call" will call the function for | ||
is excluded, ":[range]call" will call the function for | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. not really optional, since the manual describes how |
||
each line in the range, with the cursor on the start | ||
of each line. See |function-range-example|. | ||
The cursor is still moved to the first line of the | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -134,9 +134,9 @@ if your text can't be properly formatted with Vim's builtin command. See the | |
|
||
To center a range of lines, use the following command: > | ||
|
||
:{range}center [width] | ||
:[range]center [width] | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. not really optional from the context above. |
||
|
||
{range} is the usual command-line range. [width] is an optional line width to | ||
[range] is the usual command-line range. [width] is an optional line width to | ||
use for centering. If [width] is not specified, it defaults to the value of | ||
'textwidth'. (If 'textwidth' is 0, the default is 80.) | ||
For example: > | ||
|
@@ -170,7 +170,7 @@ LEFT ALIGNMENT | |
|
||
Finally there is this command: > | ||
|
||
:{range}left [margin] | ||
:[range]left [margin] | ||
|
||
Unlike ":center" and ":right", however, the argument to ":left" is not the | ||
length of the line. Instead it is the left margin. If it is omitted, the | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -185,7 +185,7 @@ g8 Print the hex values of the bytes used in the | |
:= [flags] Print the last line number. | ||
See |ex-flags| for [flags]. | ||
|
||
:{range}= [flags] Prints the last line number in {range}. For example, | ||
:[range]= [flags] Prints the last line number in [range]. For example, | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. this is specifically how the |
||
this prints the current line number: > | ||
:.= | ||
< See |ex-flags| for [flags]. | ||
|
@@ -230,9 +230,9 @@ g8 Print the hex values of the bytes used in the | |
Example: > | ||
:exe "normal \<c-w>\<c-w>" | ||
|
||
:{range}norm[al][!] {commands} *:normal-range* | ||
:[range]norm[al][!] {commands} *:normal-range* | ||
Execute Normal mode commands {commands} for each line | ||
in the {range}. Before executing the {commands}, the | ||
in the [range]. Before executing the {commands}, the | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. not really optional as well. |
||
cursor is positioned in the first column of the range, | ||
for each line. Otherwise it's the same as the | ||
":normal" command without a range. | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -76,7 +76,7 @@ static int cause_abort = FALSE; | |
|
||
/* | ||
* Return TRUE when immediately aborting on error, or when an interrupt | ||
* occurred or an exception was thrown but not caught. Use for ":{range}call" | ||
* occurred or an exception was thrown but not caught. Use for ":[range]call" | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. not really optional from context. |
||
* to check whether an aborted function that does not handle a range itself | ||
* should be called again for the next line in the range. Also used for | ||
* cancelling expression evaluation after a function call caused an immediate | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -437,7 +437,7 @@ next_search_hl( | |
int called_emsg_before = called_emsg; | ||
int timed_out = FALSE; | ||
|
||
// for :{range}s/pat only highlight inside the range | ||
// for :[range]s/pat only highlight inside the range | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. not really optional as well from context. |
||
if ((lnum < search_first_line || lnum > search_last_line) && cur == NULL) | ||
{ | ||
shl->lnum = 0; | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think here
[range]
is not really optional. Please leave it as before