Open and save dialogs track the Vim pwd
[MacVim.git] / runtime / doc / gui_mac.txt
blobafa7cba8fbd1818b5770310737c3d2e49c9747b7
1 *gui_mac.txt*   For Vim version 7.1.  Last change: 2008 May 25
4                   VIM REFERENCE MANUAL    by Bjorn Winckler
7 The MacVim Graphical User Interface                     *macvim* *gui-macvim*
9  0. Important!                  |macvim-important|
10  1. MacVim differences          |macvim-differences|
11  2. Starting MacVim             |macvim-start|
12  3. Preferences                 |macvim-preferences|
13  4. Special colors              |macvim-colors|
14  5. Menus                       |macvim-menus|
15  6. Toolbar                     |macvim-toolbar|
16  7. Dialogs                     |macvim-dialogs|
17  8. System services             |macvim-services|
18  9. Known bugs/missing features |macvim-todo|
19 10. Hints                       |macvim-hints|
21 Other relevant documentation:
22 |gui.txt|       For generic items of the GUI.
23 |os_mac.txt|    For Mac specific items.
25 {Vi does not have a GUI}
27 ==============================================================================
28 0. Important!                                           *macvim-important*
30 MacVim is still under development...this is not the finished product!  If you
31 have problems with MacVim then make it known either by adding an issue report
32 on the MacVim project page >
33         http://code.google.com/p/macvim
34 or by posting to the vim_mac mailing list               *vim_mac*  >
35         http://groups.google.com/group/vim_mac
37 Remember to keep checking the project page for new snapshots or use the
38 automatic updating feature which can be enabled in the preferences pane.  (If
39 you downloaded this copy from somewhere else, you might want to go there now
40 to make sure that you have got the latest version.)
42 ==============================================================================
43 1. MacVim differences                                   *macvim-differences*
45 One of the goals of MacVim is to make Vim behave like a proper Mac OS X
46 application.  For this reason MacVim behaves slightly different from other GUI
47 ports of Vim.  Most of the modifications are provided in the system gvimrc
48 file; you can quickly open this file and look at it yourself by typing: >
49         :tabe $VIM/gvimrc
50 Note that this file will be overwritten each time you update MacVim, so it is
51 better to keep your own modifications inside "~/.gvimrc".
53                                                         *macvim-windows*
54 There is some confusion regarding the term "window" in MacVim since it means
55 one thing to Vim and another to MacVim.  A "window" in Vim is what opens up
56 when you type ":sp", whereas a "window" in MacVim is the GUI window which
57 contains the text view, scrollbars, toolbar and tabline.  To avoid confusion,
58 the former is referred to as a Vim-window, whereas the latter is simply called
59 a window.
61                                                         *macvim-encoding*
62 It is not possible to modify 'termencoding' in MacVim; this option is forcibly
63 set to "utf-8".  The option 'encoding' also defaults to "utf-8" (as opposed to
64 "latin1" in the other GUI ports).
66 Note: UTF-8 can represent all characters defined in Unicode, which includes
67 all characters in all other standard encodings, so it should be perfectly safe
68 to edit files in any encoding while 'encoding' is set to "utf-8".  Of course,
69 you may need to set 'fileencodings' to auto-detect the encoding of the files
70 you edit, or force the detection with |++enc| on the command line.
72 However, if you are editing files that use multiple encodings (container
73 formats like MIME or Unix mbox files) or no standard encoding (binary data,
74 see also |edit-binary|), you may want to prevent MacVim from re-encoding the
75 file at all. In this situation, you will need to set both 'encoding' and
76 'fileencodings' to a simple single-byte encoding such as Latin1 so that when
77 the file is read into memory, the original bytes are left untouched.
79                                                         *macvim-movement*
80 Some Mac OS X standard key mappings involving Cmd or Option and an arrow key
81 are set up by default in "$VIM/gvimrc".  You can quickly disable all of these
82 by adding the following lines to your "~/.vimrc" (not .gvimrc) file: >
83         if has("gui_macvim")
84           let macvim_skip_cmd_opt_movement = 1
85         endif
86 Note: These are the only key mappings that MacVim makes (not counting menu key
87 equivalents which are not set up with :map).
89                                                         *macvim-shift-movement*
90 Text editors on Mac OS X lets the user hold down shift+movement key to extend
91 the selection.  Also, pressing a printable key whilst selecting replaces the
92 current selection with that character.  MacVim can emulate this kind of
93 behaviour (by providing key bindings and by setting 'keymodel' and
94 'selectmode' to non-default values) although it is not enabled by default.  To
95 make MacVim behave more like TextEdit and less like Vim, add the following
96 lines to your "~/.vimrc" (not .gvimrc) file: >
97         if has("gui_macvim")
98           let macvim_hig_shift_movement = 1
99         endif
101                                                         *macvim-drag-n-drop*
102 Dragging files and dropping them on a window opens those files in tabs in that
103 window, unless Vim is in command-line mode.  In command-line mode the names of
104 the files are added to the command line.  Holding down modifier keys whilst
105 dragging is not supported.
107 If a file is dropped on the Dock icon, it is always opened in a new tab
108 regardless of the mode Vim is currently in.  The same holds if you
109 double-click on a file in the Finder.
111                                                         *macvim-default-menu*
112 The default menu in MacVim has been changed to conform better with the Apple
113 Human Interface Guidelines (HIG).  At the moment this breaks the localized
114 menus, so only English menus are supported.
116 Note: The menus are a work in progress.  If you know something about the HIG
117 and want to contribute to MacVim you could do so by making the menus better.
119                                                         *macvim-window-title*
120 The default window title does not include the argument list because it looks
121 really bad once you start using tabs.  For example, dropping two files, then
122 dropping two more, and switching back to the first tab would cause weird
123 strings like "((3) of 2)" to appear in the window title.
125                                                         *macvim-options*
126 These are the non-standard options that MacVim supports:
127         'fullscreen' 'fuoptions' 'toolbariconsize' 'transparency' 'antialias'
129                                                         *macvim-find*
130 Whenever you search for something in Vim (e.g. using "/") the search query is
131 copied to the OS X "Find Pasteboard".  The idea is that if you search for
132 something and switch to another application, then you can hit <D-g> (or <D-G>)
133 to repeat the search in the new app.  The same feature works if you search in
134 some app, switch to MacVim and hit <D-g>.
136 Note that the command |n| is not the same as <D-g>.  The former will repeat
137 the last search made in Vim, whereas the latter searches for the string on the
138 OS X Find Pasteboard using the action findNext: (see |:macaction|).
140 The <D-g> key equivalent is a great way to bring a search from one window to
141 another in MacVim.  Simply search for something in one window (using "/") then
142 switch to another (e.g. with <D-`>) and hit <D-g> and the search will be
143 repeated in the new window.
145                                         *macvim-backspace* *macvim-delete*
146 The 'backspace' option is set in the system vimrc to make the delete key
147 behave in a more familiar way to new users.  If you dislike this non-default
148 behaviour, then add the line "set backspace&" to your "~/.vimrc" file.
150 ==============================================================================
151 2. Starting MacVim                                      *macvim-start*
153 The easiest way to start MacVim is by double-clicking its icon in the Finder,
154 but most users will probably prefer to use the Terminal.  First some Finder
155 related ways of starting MacVim are described, then Terminal is discussed.
156 Note that you can put MacVim anywhere on your hard drive, but in this help
157 file it is assumed that you have put it inside your /Applications folder.
159 MacVim automatically registers itself as an editor of several standard file
160 formats.  This enables you to double-click a file to open it with MacVim (if
161 it is not associated with another program), or to right-click a file to bring
162 up the "Open with" menu.  You can also drag and drop files onto the Dock icon
163 to open them in tabs in a new window, or you can drop them in an already open
164 window to open the files in tabs in that specific window.  Finally, you can
165 use Mac OS X System Services to open files in MacVim, see |macvim-services|.
167 There are essentially two ways to start MacVim from Terminal: either call the
168 Vim binary with the -g switch >
169         /Applications/MacVim.app/Contents/MacOS/Vim -g file ...
170 or use the "open" command (which is of limited use since it cannot be used to
171 pass parameters to Vim) >
172         open -a MacVim file ...
174                                                         *mvim*
175 To save yourself from having to type the entire path to the Vim binary each
176 time you start MacVim, you could create an alias such as >
177         alias gvim='/Applications/MacVim.app/Contents/MacOS/Vim -g'
178 and add that to "~/.profile".  A more flexible way to start MacVim is to use
179 the shell script "mvim" which comes bundled with MacVim.  Put this script in a
180 folder in your path and then simply type "mvim" to start MacVim.  This script
181 will try to find MacVim.app in various typical folders such as >
182         ~/Applications              ~/Applications/vim
183         /Applications               /Applications/vim
184         /Applications/Utilities     /Applications/Utilities/vim
185 If you would rather put MacVim.app in some other directory then that is also
186 possible, simply set the environment variable VIM_APP_DIR to whatever folder
187 you have placed MacVim.app in.
189 Note: Starting MacVim by creating a symlink to >
190         .../MacVim.app/Contents/MacOS/Vim
191 with 'ln -s' does not work.
193 Once in terminal Vim it is possible to start MacVim by using the following
194 command:
195         :gui [++opt] [+cmd] [-f|-b] [files...]
196 Note: Forking ("-b") currently does not work.
198                                                 *odbeditor* *external-editor*
199 MacVim can act as an 'external editor' for Mac OS X applications that support
200 the ODB Editor Protocol (or the 'external editor' protocol).  Each application
201 has different ways of configuring this option, check the application's
202 documentation.  Once configured properly MacVim can be used to open files in
203 such an application.
205 A technical note: MacVim handles file open, modified and closed events.  In
206 the open event the FTok and Burl parameters are parsed (the latter is ignored
207 at the moment though).  In the modified and closed events the Tokn parameter
208 is sent back to the server application.
210 ==============================================================================
211 3. Preferences                              *macvim-prefs* *macvim-preferences*
213 Some settings are global to the MacVim application and would not make sense as
214 Vim options.  These settings are stored in a user default database and can be
215 accessed via the "MacVim/Preferences..." menu item.
217 Not all entries in the user defaults database are exposed via the preference
218 panel, usually because they should not be changed by the user under normal
219 circumstances.  These options can still be changed with the "defaults" command
220 by opening Terminal and typing >
221         defaults write org.vim.MacVim KEY VALUE
222 Check the man page on "defaults" for more information on this command as well
223 as general information regarding Mac OS X user defaults.
225 Here is a list of relevant dictionary entries:
227 KEY                             VALUE ~
228 MMAtsuiRenderer                 enable ATSUI renderer [bool]
229 MMCellWidthMultiplier           width of a normal glyph in em units [float]
230 MMDialogsTrackPwd               open/save dialogs track the Vim pwd [bool]
231 MMLoginShellArgument            login shell parameter [string]
232 MMLoginShellCommand             which shell to use to launch Vim [string]
233 MMNoFontSubstitution            disable automatic font substitution [bool]
234 MMTabMaxWidth                   maximum width of a tab [int]
235 MMTabMinWidth                   minimum width of a tab [int]
236 MMTabOptimumWidth               default width of a tab [int]
237 MMTextInsetBottom               text area offset in pixels [int]
238 MMTextInsetLeft                 text area offset in pixels [int]
239 MMTextInsetRight                text area offset in pixels [int]
240 MMTextInsetTop                  text area offset in pixels [int]
241 MMTexturedWindow                use brushed metal window (Tiger only) [bool]
242 MMTranslateCtrlClick            interpret ctrl-click as right-click [bool]
243 MMZoomBoth                      zoom button maximizes both directions [bool]
245 As an example, if you have more than one mouse button and would wish to free
246 up Ctrl-click so you can bind it to something else, then the appropriate
247 command is: >
248         defaults write org.vim.MacVim MMTranslateCtrlClick 0
250 If you wish to restore all user defaults to their starting values, open
251 Terminal and type: >
252         defaults delete org.vim.MacVim
254                                                         *macvim-login-shell*
255 Applications opened from the Finder do not automatically source the user's
256 environment variables (which are typically set in .profile or .bashrc).  This
257 presents a problem when using |:!| to execute commands in the shell since e.g.
258 $PATH might not be set properly.  To work around this problem MacVim can start
259 new Vim processes via a login shell so that all environment variables are set.
261 By default MacVim uses the $SHELL environment variable to determine which
262 shell to use (if $SHELL is not set "/bin/bash" is used).  It is possible to
263 override this choice by setting the user default MMLoginShellCommand to the
264 shell that should be used (e.g. "/bin/tcsh").  MacVim tries to make the shell
265 a login shell by prepending argv[0] with a dash.  If you use an exotic shell
266 and need to pass it a parameter to make it a login shell then you can set the
267 user default MMLoginShellArgument (e.g. to "-l").  Finally, if the "bash"
268 shell is used, then "-l" is automatically added as an argument.  To override
269 this behaviour set MMLoginShellArgument to "--".
271 ==============================================================================
272 4. Special colors                                       *macvim-colors*
274 The colors in MacVim are defined in two dictionaries inside the "Resources"
275 folder of the application bundle (MacVim.app/Contents/Resources).  It is
276 possible to add more colors by modifying these files.  Color names are case
277 insensitive when accessed from Vim, but in the dictionary they must be
278 lowercase.
280                                                         *SystemColors.plist*
281 There are only a few system colors that can be accessed from Vim.  These
282 colors are defined in the dictionary "SystemColors.plist".  This dictionary
283 stores (key, value) pairs where the key is the name of the color and the
284 value is an NSColor selector name.
286 The most useful system colors are: >
287         MacSelectedTextBackgroundColor
288         MacSecondarySelectedColor
289 The former is the "Highlight Color" which can be changed in the "Appearance"
290 section of the System Preferences.  The latter is the selection color used by
291 a Cocoa application when it is not in focus.
293                                                         *Colors.plist*
294 Apart from the system colors, it is also possible to use the standard X11
295 color names (see http://en.wikipedia.org/wiki/X11_color_names) which usually
296 come in a file called "rgb.txt".  MacVim does not have such a file, instead it
297 keeps these colors in a dictionary called "Colors.plist". The key in this
298 dictionary is the name of the color and the value is an RGB value on the form
299 #rrggbb stored as an integer.
301                                                         *macvim-colorscheme*
302 MacVim ships with a custom color scheme that is used instead of the default
303 Vim color scheme.  The color scheme can be changed with >
304         :colorscheme macvim
305 If you prefer a dark background color, then type >
306         :set bg=dark
307 after having loaded the "macvim" color scheme.
309 The color scheme uses the the system "Highlight Color", which can be changed in
310 the "Appearance" pane of the System Preferences.  It also changes the
311 highlight color when a window becomes inactive.
313 If you have any comments regarding this colors cheme (is it better or worse
314 than the default?) then post them to |vim_mac|.
316 ==============================================================================
317 5. Menus                                                *macvim-menus*
319 Menus in Mac OS X behave slightly different from other platforms.  For that
320 reason two new commands have been added to Vim.  To understand what these
321 commands do you must first understand how menus work on OS X.
323 Each entry in a menu is called a "menu item".  With each menu item is
324 associated: a title, a key equivalent and an action message.  When a menu is
325 displayed the title is shown on the left and the key equivalent (if any) is
326 shown on the right.  Key equivalents enable you to access a menu item using
327 the keyboard instead of having to use the mouse.  When a menu item is clicked
328 it will send it's associated action message.  Actions can be used to instruct
329 MacVim to paste some text (paste:), open a new window (newWindow:), etc.
330 Certain actions are standard throughout OS X which is why MacVim must be able
331 to set these for each menu item.  (E.g. the menu item "Edit.Paste" must be
332 bound to the action "paste:" otherwise pasting won't work in dialogs since
333 that is the action that instructs them to paste something.)
335 Menus are configured using the |:macmenu| command and the |:macaction| command
336 can be used to send action messages.
338                                                 *:maca* *:macaction*
339 :maca[ction] {action:}  Send the message "action:" to the first responder.
340                         The list of allowed actions can be seen by typing
341                             :maca <C-d>
342                         An attempt to send an action not listed here will
343                         result in an error.  This list is specified in a
344                         property list file called |Actions.plist|.
346                                                 *:macm* *:macmenu*
347 :mac[menu] {menu} {key}={arg} ...
348                         Set Mac specific properties for {menu}.  The
349                         properties that can be set are:
350                             action      the action this menu sends
351                             alt         "yes" if alternate of previous menu
352                             key         the key equivalent of this menu
353                         This command must be used in a startup file, for
354                         example in "~/.gvimrc".  It has no effect otherwise.
356                         For convenience, a menu with "action=name:" which is
357                         bound to <Nop> will act as if bound to
358                         ":maca name:<CR>".  Thus, if "Menu.Item" is given by
359                             :an Menu.Item <Nop>
360                             :macm Menu.Item action=name:
361                         then ":emenu Menu.Item" is equivalent to
362                         ":maca name:".
364                         The key equivalent is specified with the <D-..>
365                         syntax.  Note that key equivalents must contain the
366                         Cmd modifier flag (<D-...>), and they take precedence
367                         over normal mappings.
368                         Use the syntax "key=<nop>" to clear the key equivalent
369                         of a menu.  This can be used to free up a key
370                         combination that is set in the system gvimrc so that
371                         it may be mapped to using ":map".
373                         Recognised values of "alt" are "0", "no", "1", and
374                         "yes".  The default is "no".  An alternate menu must
375                         have the same key equivalent as the previous menu,
376                         except the modifier flags must differ.  The alternate
377                         menu is by default hidden and only shows up when the
378                         modifier is held down.
380 Here are some examples on how to use these commands:
382 1. Create a menu item with title "New Window" under the "File" menu, with key
383 equivalent Cmd-n, which opens a new window when selected: >
384         :an 10.290 File.New\ Window <Nop>
385         :macm File.New\ Window action=newWindow: key=<D-n>
386 2. Change the key equivalent to cycle through tabs to Cmd-Left/Right: >
387         :macm Window.Previous\ Tab  key=<D-Left>
388         :macm Window.Next\ Tab      key=<D-Right>
389 3. Create a mapping in normal mode which closes the current tab/window: >
390         :map <C-w> :maca performClose:<CR>
392                                                         *Actions.plist*
393 Some action messages would not be suitable to call from within Vim, so there
394 is a dictionary called "Actions.plist" (in the Resources folder of the
395 application bundle) which contains all actions that may be called.  The key in
396 this dictionary is the name of the action message (case sensitive), the value
397 is not used.
399 Hint: The |:macaction| command supports command-line completion so you can
400 enter ":maca<Space><C-d>" to see a list of all available actions.
402 Here is a random assortment of actions from Actions.plist which might be
403 useful.  
405 Action                          Description ~
406 findNext:                       Search forward using the "Find Pasteboard"
407 findPrevious:                   Search backward using the "Find Pasteboard"
408 fontSizeDown:                   Decrease font size
409 fontSizeUp:                     Increase font size
410 newWindow:                      Open a new (empty) window
411 orderFrontCharacterPalette:     Show the the "Special Characters" dialog
412 orderFrontFontPanel:            Show the Font panel
413 orderFrontPreferencePanel:      Show the Preferences panel
414 performClose:                   Close tab/window
415 performZoom:                    Zoom window (same as clicking the green blob)
416 selectNextWindow:               Select next window (similar to <D-`>)
417 selectPreviousWindow:           Select previous window (similar to <S-D-`>)
419 ==============================================================================
420 6. Toolbar                                              *macvim-toolbar*
422 The toolbar in MacVim works just like in the other GUIs (see |gui-toolbar|),
423 with the addition of two separator items (see |menu-separator|).  You can use
424 them as follows: >
425         :an ToolBar.-space1-        <Nop>
426         :an ToolBar.-flexspace2-    <Nop>
427 The first example creates an empty space on the toolbar, the second creates an
428 empty space which will shink or expand so that the items to the right of it
429 are right-aligned.  A space (flexspace) will be created for any toolbar item
430 whose name begins with "-space" ("-flexspace") and ends with "-"
432 Toolbar icons should be tiff, png or icns, of dimension 32x32 or 24x24 pixels.
433 The larger size is used when 'tbis' is "medium" or "large", otherwise the
434 smaller size is used (which is the default).  If the icon file only contains
435 one dimension then Mac OS X will scale the icon to the appropriate dimension
436 if necessary.  To avoid this, use a file format which supports multiple
437 resolutions (such as icns) and provide both 32x32 and 24x24 versions of the
438 icon.
440 Note: Only a subset of the builtin toolbar items presently have icons.  If no
441 icon can be found a warning triangle is displayed instead.
443 ==============================================================================
444 7. Dialogs                                              *macvim-dialogs*
446 Dialogs can be controlled with the keyboard in two ways.  By default each
447 button in a dialog is bound to a key.  The button that is highlighted by blue
448 is bound to Enter, and any button with the title "Cancel" is bound to Escape.
449 Other buttons are usually bound to the first letter in the title of the
450 button.  There is no visual feedback to indicate which letter a button is
451 bound to, so sometimes some experimentation might be required in order to
452 figure out which key to press.
454 The second way of controlling dialogs with the keyboard is to enable "Full
455 keyboard access" in the "Keyboard & Mouse" pane of the System Preferences (you
456 can also toggle this on or off by pressing Ctrl-F7).  Once keyboard access is
457 enabled it is possible to move between buttons with Tab and pressing Space to
458 select the current button.  The current button is indicated with a blue
459 outline.
461 ==============================================================================
462 8. System services                                      *macvim-services*
464 MacVim supports a few system services.  These can be accessed from the MacVim
465 submenu in the Services menu.  For services to work, MacVim.app should be
466 located in the /Applications folder.  (You might have to logout and then login
467 again before Mac OS X detects the MacVim services.)
469 These are the currently supported services:
470 * New Tab Containing Selection: Opens a new tab in the topmost window and
471   pastes the currently selected text in that tab.  A new window will be
472   opened if necessary.
473 * Open Selected File in Tab: If the selected text represents a file
474   name, then the corresponding file is opened in a new tab in the topmost
475   window.
476 * Open Selected File in Window: Same as the above, but always open in a new
477   window.
479 ==============================================================================
480 9. Known bugs/missing features                          *macvim-todo*
482 Here are some of the bigger bugs in MacVim.  Of course there are others, but
483 these are ones that are know and/or which were judged major.
485 - Localized menus are not supported.  Choosing anything but "English" in the
486   "International" pane of "System Prefences" may break the menus (and
487   toolbar).
488 - Some Unicode characters are not handled well (e.g. nonspacing marks)
489 - Sometimes multibyte characters look "too wide", i.e. they overlap the
490   following character.  It might help to change 'ambiwidth', or override the
491   automatic font substitution by setting 'guifontwide' manually.
492 - Printing
493 - No find/replace dialog
495 If you find new bugs then add a new issue at http://code.google.com/p/macvim/
496 or post your findings to the |vim_mac| mailing list.  If you are missing
497 feature X in MacVim then voice your opinion on the |vim_mac| mailing list; it
498 might be simple to implement, but unless somebody asks for a particular
499 feature then there is little incentive to add it.
501 ==============================================================================
502 10. Hints                                               *macvim-hints*
504 In this section some general (not necessarily MacVim specific) hints are
505 given.
507 Scenario: ~
508 You try opening a bunch of files in tabs but not all files get
509 opened in their own tab.
510 Solution: ~
511 To get around this, set 'tabpagemax' to something big in your
512 .gvimrc file (e.g. ":set tabpagemax=100").
514 Scenario: ~
515 You want to open a file in a tab in an already opened window, but typing
516 "mvim filename" in Terminal opens it up in a separate window.
517 Solution: ~
518 Use the |--remote-tab| switch.  If you have several windows open you
519 might have to specify which window you want the file to open in by using the
520 |--servername| switch.  The title of a window usually ends in something like
521 "VIM" or "VIM3" --- this is the server name of that window.  So to open a file
522 named "foobar.txt" in a window whose title ends in "VIM3" you would type (the
523 order of the arguments matters): >
524         mvim --servername VIM3 --remote-tab foobar.txt
525 For more information, consult the |client-server| manual page.
527 Scenario: ~
528 You like to be able to select text by holding down shift and
529 pressing the arrow keys and find the Vim way of selecting text strange.
530 Solution: ~
531 See |macvim-shift-movement|.
533 Scenario: ~
534 You do not want MacVim to set up any key mappings.
535 Solution: ~
536 See |macvim-movement|.
538 Scenario: ~
539 Enabling localized menus breaks the toolbar and the menus as well.
540 Solution: ~
541 This is a know problem, see |macvim-todo|.
543 Scenario: ~
544 You dislike the default font (DejaVu Sans Mono).
545 Solution: ~
546 The standard fixed width font on other Mac OS X applications is
547 Monaco.  If you prefer this font then add the following line to your
548 "~/.gvimrc" (note that Monaco does not come in italic and bold variants): >
549         set guifont=Monaco:h10
550 The suffix ":h10" specifies the point size of the font should be "10" (see
551 'guifont' for more information on how to set the font).
553 Scenario: ~
554 When you click the (green) zoom button you want the window to maximize
555 horizontally as well as vertically.
556 Solution: ~
557 Hold down Cmd and click the zoom button.  If you prefer this to be the default
558 action, then set the user default MMZoomBoth (see |macvim-prefs|).
560 Scenario: ~
561 Typing feels sluggish when the cursor is just before a right bracket (i.e. ')',
562 '}', or ']').
563 Solution: ~
564 Disable the "matchparen" plugin (see |matchparen|) by typing :NoMatchParen.
565 If that helps, then you can permanently disable "matchparen" by adding the
566 following line to your "~/.vimrc": >
567         let loaded_matchparen=1
570 Scenario: ~
571 You can't find the information on MacVim you thought should be in
572 this manual page.
573 Solution: ~
574 Post your question on the |vim_mac| mailing list and wait for an
575 answer.
577  vim:tw=78:sw=4:ts=8:ft=help:norl: