@@ -30,7 +30,7 @@ Other relevant documentation:
30
30
==============================================================================
31
31
1. MacVim differences *macvim-differences*
32
32
33
- One of the goals of MacVim is to make Vim behave like a proper Mac OS X
33
+ One of the goals of MacVim is to make Vim behave like a proper macOS
34
34
application. For this reason MacVim behaves slightly different from other GUI
35
35
ports of Vim. Most of the modifications are provided in the system gvimrc
36
36
file; you can quickly open this file and look at it yourself by typing: >
@@ -65,8 +65,8 @@ file at all. In this situation, you will need to set both 'encoding' and
65
65
the file is read into memory, the original bytes are left untouched.
66
66
67
67
*macvim-shift-movement*
68
- Text editors on Mac OS X lets the user hold down shift+movement key to extend
69
- the selection. Also, pressing a printable key whilst selecting replaces the
68
+ Text editors on macOS lets the user hold down shift+movement key to extend the
69
+ selection. Also, pressing a printable key whilst selecting replaces the
70
70
current selection with that character. MacVim can emulate this kind of
71
71
behaviour (by providing key bindings and by setting 'keymodel' and
72
72
'selectmode' to non-default values) although it is not enabled by default. To
@@ -120,15 +120,22 @@ These are the non-standard commands that MacVim supports:
120
120
| :macaction | | :macmenu |
121
121
122
122
*macvim-find*
123
- Whenever you search for something in Vim (e.g. using "/") the search query is
124
- copied to the OS X "Find Pasteboard". The idea is that if you search for
125
- something and switch to another application, then you can hit <D-g> (or <D-G> )
126
- to repeat the search in the new app. The same feature works if you search in
127
- some app, switch to MacVim and hit <D-g> .
123
+ Whenever you search for something in Vim (e.g. using "/"), or hit <D-e> when
124
+ you have text selected, the search query is copied to the macOS "Find
125
+ Pasteboard". The idea is that if you search for something and switch to
126
+ another application, then you can hit <D-g> (or <D-G> ) to repeat the search in
127
+ the new app. The same feature works if you search in some app, switch to
128
+ MacVim and hit <D-g> .
129
+
130
+ If you would like to turn off sharing Vim's search query to the macOS Find
131
+ Pasteboard, you can set | MMShareFindPboard | to "NO". Even when that's set,
132
+ <D-g> will still use the OS Find Pasteboard for searching (use | n | instead if
133
+ that's not what you want), and <D-e> ("Edit -> Use Selection for Find") will
134
+ still share the search pattern to Find Pasteboard.
128
135
129
136
Note that the command | n | is not the same as <D-g> . The former will repeat
130
137
the last search made in Vim, whereas the latter searches for the string on the
131
- OS X Find Pasteboard using the action findNext: (see | :macaction | ).
138
+ macOS Find Pasteboard using the action findNext: (see | :macaction | ).
132
139
133
140
The <D-g> key equivalent is a great way to bring a search from one window to
134
141
another in MacVim. Simply search for something in one window (using "/") then
@@ -156,7 +163,7 @@ up the "Open with" menu. You can also drag and drop files onto the Dock icon
156
163
to open them in tabs in a new window, or you can drop them in an already open
157
164
window to open the files in tabs in that specific window (it is possible to
158
165
have files open in e.g. splits by changing the "Open files from applications"
159
- option in the General preference pane). Finally, you can use Mac OS X System
166
+ option in the General preference pane). Finally, you can use macOS System
160
167
Services to open files in MacVim, see | macvim-services | .
161
168
162
169
Use | mvim | script to start MacVim from Terminal.
@@ -206,9 +213,9 @@ history as the window you just closed (however the next window you open will).
206
213
For these reasons Quickstart is disabled by default.
207
214
208
215
*odbeditor* *external-editor*
209
- MacVim can act as an 'external editor' for Mac OS X applications that support
210
- the ODB Editor Protocol (or the 'external editor' protocol). Each application
211
- has different ways of configuring this option, check the application's
216
+ MacVim can act as an 'external editor' for macOS applications that support the
217
+ ODB Editor Protocol (or the 'external editor' protocol). Each application has
218
+ different ways of configuring this option, check the application's
212
219
documentation. Once configured properly MacVim can be used to open files in
213
220
such an application.
214
221
@@ -231,32 +238,32 @@ circumstances. These options can still be changed with the "defaults" command
231
238
by opening Terminal and typing >
232
239
defaults write org.vim.MacVim KEY VALUE
233
240
Check the man page on "defaults" for more information on this command as well
234
- as general information regarding Mac OS X user defaults.
241
+ as general information regarding macOS user defaults.
235
242
236
243
Here is a list of relevant dictionary entries:
237
244
238
245
KEY VALUE ~
239
- MMCellWidthMultiplier width of a normal glyph in em units [float]
240
- MMDialogsTrackPwd open/save dialogs track the Vim pwd [bool]
241
- MMFullScreenFadeTime fade delay for non-native fullscreen [float]
242
- MMLoginShellArgument login shell parameter [string]
243
- MMLoginShellCommand which shell to use to launch Vim [string]
244
- MMNoFontSubstitution disable automatic font substitution [bool]
245
- MMNoTitleBarWindow hide title bar [bool]
246
- MMShareFindPboard share search text to Find Pasteboard [bool]
247
- MMShowAddTabButton enable "add tab" button on tabline [bool]
248
- MMTabMaxWidth maximum width of a tab [int]
249
- MMTabMinWidth minimum width of a tab [int]
250
- MMTabOptimumWidth default width of a tab [int]
251
- MMTextInsetBottom text area offset in pixels [int]
252
- MMTextInsetLeft text area offset in pixels [int]
253
- MMTextInsetRight text area offset in pixels [int]
254
- MMTextInsetTop text area offset in pixels [int]
255
- MMTexturedWindow use brushed metal window (Tiger only) [bool]
256
- MMTranslateCtrlClick interpret ctrl-click as right-click [bool]
257
- MMUseMouseTime use mousetime to detect multiple clicks [bool]
258
- MMVerticalSplit files open in vertical splits [bool]
259
- MMZoomBoth zoom button maximizes both directions [bool]
246
+ * MMCellWidthMultiplier* width of a normal glyph in em units [float]
247
+ * MMDialogsTrackPwd* open/save dialogs track the Vim pwd [bool]
248
+ * MMFullScreenFadeTime* fade delay for non-native fullscreen [float]
249
+ * MMLoginShellArgument* login shell parameter [string]
250
+ * MMLoginShellCommand* which shell to use to launch Vim [string]
251
+ * MMNoFontSubstitution* disable automatic font substitution [bool]
252
+ * MMNoTitleBarWindow* hide title bar [bool]
253
+ * MMShareFindPboard* share search text to Find Pasteboard [bool]
254
+ * MMShowAddTabButton* enable "add tab" button on tabline [bool]
255
+ * MMTabMaxWidth* maximum width of a tab [int]
256
+ * MMTabMinWidth* minimum width of a tab [int]
257
+ * MMTabOptimumWidth* default width of a tab [int]
258
+ * MMTextInsetBottom* text area offset in pixels [int]
259
+ * MMTextInsetLeft* text area offset in pixels [int]
260
+ * MMTextInsetRight* text area offset in pixels [int]
261
+ * MMTextInsetTop* text area offset in pixels [int]
262
+ * MMTexturedWindow* use brushed metal window (Tiger only) [bool]
263
+ * MMTranslateCtrlClick* interpret ctrl-click as right-click [bool]
264
+ * MMUseMouseTime* use mousetime to detect multiple clicks [bool]
265
+ * MMVerticalSplit* files open in vertical splits [bool]
266
+ * MMZoomBoth* zoom button maximizes both directions [bool]
260
267
261
268
As an example, if you have more than one mouse button and would wish to free
262
269
up Ctrl-click so you can bind it to something else, then the appropriate
@@ -337,9 +344,9 @@ highlight color when a window becomes inactive.
337
344
==============================================================================
338
345
5. Menus *macvim-menus*
339
346
340
- Menus in Mac OS X behave slightly different from other platforms. For that
347
+ Menus in macOS behave slightly different from other platforms. For that
341
348
reason two new commands have been added to Vim. To understand what these
342
- commands do you must first understand how menus work on OS X .
349
+ commands do you must first understand how menus work on macOS .
343
350
344
351
Each entry in a menu is called a "menu item". With each menu item is
345
352
associated: a title, a key equivalent and an action message. When a menu is
@@ -348,7 +355,7 @@ shown on the right. Key equivalents enable you to access a menu item using
348
355
the keyboard instead of having to use the mouse. When a menu item is clicked
349
356
it will send its associated action message. Actions can be used to instruct
350
357
MacVim to paste some text (paste:), open a new window (newWindow:), etc.
351
- Certain actions are standard throughout OS X which is why MacVim must be able
358
+ Certain actions are standard throughout macOS which is why MacVim must be able
352
359
to set these for each menu item. (E.g. the menu item "Edit.Paste" must be
353
360
bound to the action "paste:" otherwise pasting won't work in dialogs since
354
361
that is the action that instructs them to paste something.)
@@ -440,6 +447,8 @@ Action Description ~
440
447
fileOpen: Show "File Open" dialog
441
448
findNext: Search forward using the "Find Pasteboard"
442
449
findPrevious: Search backward using the "Find Pasteboard"
450
+ useSelectionForFind: Search the selected text and share to "Find
451
+ Pasteboard"
443
452
fontSizeDown: Decrease font size
444
453
fontSizeUp: Increase font size
445
454
hide: Hide MacVim
@@ -471,7 +480,7 @@ whose name begins with "-space" ("-flexspace") and ends with "-"
471
480
Toolbar icons should be tiff, png, icns, or heic, of dimension 32x32 or 24x24
472
481
pixels. The larger size is used when 'tbis' is "medium" or "large", otherwise
473
482
the smaller size is used (which is the default). If the icon file only
474
- contains one dimension then Mac OS X will scale the icon to the appropriate
483
+ contains one dimension then macOS will scale the icon to the appropriate
475
484
dimension if necessary. To avoid this, use a file format which supports
476
485
multiple resolutions (such as icns) and provide both 32x32 and 24x24 versions
477
486
of the icon.
@@ -532,8 +541,7 @@ outline.
532
541
MacVim supports two system services. These can be accessed from the MacVim
533
542
submenu in the Services menu or by right-clicking a selection. For services
534
543
to work, MacVim.app should be located in the /Applications folder. (You might
535
- have to logout and then login again before Mac OS X detects the MacVim
536
- services.)
544
+ have to logout and then login again before macOS detects the MacVim services.)
537
545
538
546
These are the currently supported services:
539
547
* New MacVim Buffer With Selection: Create a new buffer and paste the
@@ -640,7 +648,7 @@ sometimes be slightly involved. Here are all the things you need to consider:
640
648
- Bindings to <D-..> are case sensitive: <D-d> is not the same as <D-D> . If
641
649
you want to map something to Cmd+Shift+d, then you need to use <D-D> , not
642
650
<D-S-d> or <D-S-D> .
643
- - Some command key shortcuts are reserved by Mac OS X and cannot be mapped to
651
+ - Some command key shortcuts are reserved by macOS and cannot be mapped to
644
652
(e.g. <D-Tab> ). However, some of these shortcuts can be freed up in the
645
653
System Preferences under Keyboard (e.g. Cmd+Space).
646
654
- A few command key mappings are set up by MacVim, see | cmd-movement | .
@@ -685,9 +693,9 @@ See the section on |key-mapping| for more help on how to map keys.
685
693
686
694
When editing non-English text it may be convenient to keep separate keyboard
687
695
layouts for normal and insert mode. This is supported via the 'imd' option on
688
- Mac OS X 10.5 or later (on 10.4 the 'imd' option support is not as useful as
689
- it only switches between Roman and non-Roman input sources and it has been
690
- known not to work very reliably).
696
+ macOS 10.5 or later (on 10.4 the 'imd' option support is not as useful as it
697
+ only switches between Roman and non-Roman input sources and it has been known
698
+ not to work very reliably).
691
699
692
700
For example: When 'noimd' is enabled (i.e. IM is enabled) the input source is
693
701
saved when toggling between normal and insert mode, so you can use a US layout
0 commit comments