@@ -30,7 +30,7 @@ Other relevant documentation:
3030==============================================================================
31311. MacVim differences *macvim-differences*
3232
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
3434application. For this reason MacVim behaves slightly different from other GUI
3535ports of Vim. Most of the modifications are provided in the system gvimrc
3636file; 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
6565the file is read into memory, the original bytes are left untouched.
6666
6767 *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
7070current selection with that character. MacVim can emulate this kind of
7171behaviour (by providing key bindings and by setting 'keymodel' and
7272'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:
120120 | :macaction | | :macmenu |
121121
122122 *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.
128135
129136Note that the command | n | is not the same as <D-g> . The former will repeat
130137the 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 | ).
132139
133140The <D-g> key equivalent is a great way to bring a search from one window to
134141another 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
156163to open them in tabs in a new window, or you can drop them in an already open
157164window to open the files in tabs in that specific window (it is possible to
158165have 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
160167Services to open files in MacVim, see | macvim-services | .
161168
162169Use | 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).
206213For these reasons Quickstart is disabled by default.
207214
208215 *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
212219documentation. Once configured properly MacVim can be used to open files in
213220such an application.
214221
@@ -231,32 +238,32 @@ circumstances. These options can still be changed with the "defaults" command
231238by opening Terminal and typing >
232239 defaults write org.vim.MacVim KEY VALUE
233240 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.
235242
236243Here is a list of relevant dictionary entries:
237244
238245KEY 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]
260267
261268As an example, if you have more than one mouse button and would wish to free
262269up Ctrl-click so you can bind it to something else, then the appropriate
@@ -337,9 +344,9 @@ highlight color when a window becomes inactive.
337344==============================================================================
3383455. Menus *macvim-menus*
339346
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
341348reason 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 .
343350
344351Each entry in a menu is called a "menu item". With each menu item is
345352associated: 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
348355the keyboard instead of having to use the mouse. When a menu item is clicked
349356it will send its associated action message. Actions can be used to instruct
350357MacVim 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
352359to set these for each menu item. (E.g. the menu item "Edit.Paste" must be
353360bound to the action "paste:" otherwise pasting won't work in dialogs since
354361that is the action that instructs them to paste something.)
@@ -440,6 +447,8 @@ Action Description ~
440447fileOpen: Show "File Open" dialog
441448findNext: Search forward using the "Find Pasteboard"
442449findPrevious: Search backward using the "Find Pasteboard"
450+ useSelectionForFind: Search the selected text and share to "Find
451+ Pasteboard"
443452fontSizeDown: Decrease font size
444453fontSizeUp: Increase font size
445454hide: Hide MacVim
@@ -471,7 +480,7 @@ whose name begins with "-space" ("-flexspace") and ends with "-"
471480Toolbar icons should be tiff, png, icns, or heic, of dimension 32x32 or 24x24
472481pixels. The larger size is used when 'tbis' is "medium" or "large", otherwise
473482the 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
475484dimension if necessary. To avoid this, use a file format which supports
476485multiple resolutions (such as icns) and provide both 32x32 and 24x24 versions
477486of the icon.
@@ -532,8 +541,7 @@ outline.
532541MacVim supports two system services. These can be accessed from the MacVim
533542submenu in the Services menu or by right-clicking a selection. For services
534543to 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.)
537545
538546These are the currently supported services:
539547 * 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:
640648- Bindings to <D-..> are case sensitive: <D-d> is not the same as <D-D> . If
641649 you want to map something to Cmd+Shift+d, then you need to use <D-D> , not
642650 <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
644652 (e.g. <D-Tab> ). However, some of these shortcuts can be freed up in the
645653 System Preferences under Keyboard (e.g. Cmd+Space).
646654- 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.
685693
686694When editing non-English text it may be convenient to keep separate keyboard
687695layouts 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).
691699
692700For example: When 'noimd' is enabled (i.e. IM is enabled) the input source is
693701saved when toggling between normal and insert mode, so you can use a US layout
0 commit comments