From 6fa3e93d16b021695d5e27ea94e6f4aad2abf529 Mon Sep 17 00:00:00 2001 From: Bjorn Winckler Date: Tue, 5 Feb 2008 20:03:55 +0100 Subject: [PATCH] Added help on preferences --- runtime/doc/gui_mac.txt | 76 +++++++++++++++++++++++++++++++++++++------------ runtime/doc/tags | 9 +++++- 2 files changed, 66 insertions(+), 19 deletions(-) diff --git a/runtime/doc/gui_mac.txt b/runtime/doc/gui_mac.txt index 9adc7bdb..e30bbe35 100644 --- a/runtime/doc/gui_mac.txt +++ b/runtime/doc/gui_mac.txt @@ -1,4 +1,4 @@ -*gui_mac.txt* For Vim version 7.1. Last change: 2007 Nov 27 +*gui_mac.txt* For Vim version 7.1. Last change: 2008 Feb 05 VIM REFERENCE MANUAL by Bjorn Winckler @@ -6,16 +6,17 @@ The MacVim Graphical User Interface *macvim* *gui-macvim* -0. Important! |macvim-important| -1. MacVim differences |macvim-differences| -2. Starting MacVim |macvim-start| -3. Special colors |macvim-colors| -4. Menus |macvim-menus| -5. Toolbar |macvim-toolbar| -6. Dialogs |macvim-dialogs| -7. System services |macvim-services| -8. Known bugs/missing features |macvim-todo| -9. Hints |macvim-hints| + 0. Important! |macvim-important| + 1. MacVim differences |macvim-differences| + 2. Starting MacVim |macvim-start| + 3. Preferences |macvim-preferences| + 4. Special colors |macvim-colors| + 5. Menus |macvim-menus| + 6. Toolbar |macvim-toolbar| + 7. Dialogs |macvim-dialogs| + 8. System services |macvim-services| + 9. Known bugs/missing features |macvim-todo| +10. Hints |macvim-hints| Other relevant documentation: |gui.txt| For generic items of the GUI. @@ -185,7 +186,46 @@ at the moment though). In the modified and closed events the Tokn parameter is sent back to the server application. ============================================================================== -3. Special colors *macvim-colors* +3. Preferences *macvim-prefs* *macvim-preferences* + +Some settings are global to the MacVim application and would not make sense as +Vim options. These settings are stored in a user default database and can be +accessed via the "MacVim/Preferences..." menu item. + +Not all entries in the user defaults database are exposed via the preference +panel, usually because they should not be changed by the user under normal +circumstances. These options can still be changed with the "defaults" command +by opening Terminal and typing > + defaults write org.vim.MacVim KEY VALUE +Check the man page on "defaults" for more information on this command as well +as general information regarding Mac OS X user defaults. + +Here is a list of relevant dictionary entries: + +KEY VALUE ~ +MMCellWidthMultiplier width of a normal glyph in em units [float] +MMNoFontSubstitution disable automatic font substitution [bool] +MMTabMaxWidth maximum width of a tab [int] +MMTabMinWidth minimum width of a tab [int] +MMTabOptimumWidth default width of a tab [int] +MMTextInsetBottom text area offset in pixels [int] +MMTextInsetLeft text area offset in pixels [int] +MMTextInsetRight text area offset in pixels [int] +MMTextInsetTop text area offset in pixels [int] +MMTexturedWindow use brushed metal window (Tiger only) [bool] +MMTranslateCtrlClick interpret ctrl-click as right-click [bool] + +As an example, if you have more than one mouse button and would wish to free +up Ctrl-click so you can bind it to something else, then the appropriate +command is: > + defaults write org.vim.MacVim MMTranslateCtrlClick 0 + +If you wish to restore all user defaults to their starting values, open +Terminal and type: > + defaults delete org.vim.MacVim + +============================================================================== +4. Special colors *macvim-colors* The colors in MacVim are defined in two dictionaries inside the "Resources" folder of the application bundle (MacVim.app/Contents/Resources). It is @@ -230,7 +270,7 @@ If you have any comments regarding this colors cheme (is it better or worse than the default?) then post them to |vim_mac|. ============================================================================== -4. Menus *macvim-menus* +5. Menus *macvim-menus* *:macm* *:macmenukey* MacVim has a special way of binding keys to menu items that differs from other @@ -305,7 +345,7 @@ following line to "~/.gvimrc": > (Note that key equivalents must contain the 'D' flag.) ============================================================================== -5. Toolbar *macvim-toolbar* +6. Toolbar *macvim-toolbar* The toolbar in MacVim works just like in the other GUIs (see |gui-toolbar|), with the addition of two separator items (see |menu-separator|). You can use @@ -329,7 +369,7 @@ Note: Only a subset of the builtin toolbar items presently have icons. If no icon can be found a warning triangle is displayed instead. ============================================================================== -6. Dialogs *macvim-dialogs* +7. Dialogs *macvim-dialogs* Dialogs can be controlled with the keyboard in two ways. By default each button in a dialog is bound to a key. The button that is highlighted by blue @@ -347,7 +387,7 @@ select the current button. The current button is indicated with a blue outline. ============================================================================== -7. System services *macvim-services* +8. System services *macvim-services* MacVim supports a few system services. These can be accessed from the MacVim submenu in the Services menu. For services to work, MacVim.app should be @@ -365,7 +405,7 @@ These are the currently supported services: window. ============================================================================== -8. Known bugs/missing features *macvim-todo* +9. Known bugs/missing features *macvim-todo* Here are some of the bigger bugs in MacVim. Of course there are others, but these are ones that are know and/or which were judged major. @@ -387,7 +427,7 @@ might be simple to implement, but unless somebody asks for a particular feature then there is little incentive to add it. ============================================================================== -9. Hints *macvim-hints* +10. Hints *macvim-hints* In this section some general (not necessarily MacVim specific) hints are given. diff --git a/runtime/doc/tags b/runtime/doc/tags index 965b2b9a..84ae0d46 100644 --- a/runtime/doc/tags +++ b/runtime/doc/tags @@ -708,8 +708,10 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME* 'qe' options.txt /*'qe'* 'quote motion.txt /*'quote* 'quoteescape' options.txt /*'quoteescape'* +'rdt' options.txt /*'rdt'* 'readonly' options.txt /*'readonly'* 'redraw' vi_diff.txt /*'redraw'* +'redrawtime' options.txt /*'redrawtime'* 'remap' options.txt /*'remap'* 'report' options.txt /*'report'* 'restorescreen' options.txt /*'restorescreen'* @@ -2165,6 +2167,7 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME* :highlight-link syntax.txt /*:highlight-link* :highlight-normal syntax.txt /*:highlight-normal* :highlight-verbose syntax.txt /*:highlight-verbose* +:his cmdline.txt /*:his* :history cmdline.txt /*:history* :history-indexing cmdline.txt /*:history-indexing* :i insert.txt /*:i* @@ -5858,7 +5861,6 @@ highlight-stop syntax.txt /*highlight-stop* highlight-term syntax.txt /*highlight-term* highlightID() eval.txt /*highlightID()* highlight_exists() eval.txt /*highlight_exists()* -his cmdline.txt /*his* hist-names eval.txt /*hist-names* histadd() eval.txt /*histadd()* histdel() eval.txt /*histdel()* @@ -6258,6 +6260,8 @@ macvim-important gui_mac.txt /*macvim-important* macvim-menus gui_mac.txt /*macvim-menus* macvim-movement gui_mac.txt /*macvim-movement* macvim-options gui_mac.txt /*macvim-options* +macvim-preferences gui_mac.txt /*macvim-preferences* +macvim-prefs gui_mac.txt /*macvim-prefs* macvim-services gui_mac.txt /*macvim-services* macvim-shift-movement gui_mac.txt /*macvim-shift-movement* macvim-start gui_mac.txt /*macvim-start* @@ -6681,6 +6685,7 @@ omni-sql-completion sql.txt /*omni-sql-completion* online-help various.txt /*online-help* opening-window windows.txt /*opening-window* operator motion.txt /*operator* +operator-variable eval.txt /*operator-variable* option-backslash options.txt /*option-backslash* option-list quickref.txt /*option-list* option-summary options.txt /*option-summary* @@ -7300,6 +7305,7 @@ synload-3 syntax.txt /*synload-3* synload-4 syntax.txt /*synload-4* synload-5 syntax.txt /*synload-5* synload-6 syntax.txt /*synload-6* +synstack() eval.txt /*synstack()* syntax syntax.txt /*syntax* syntax-highlighting syntax.txt /*syntax-highlighting* syntax-loading syntax.txt /*syntax-loading* @@ -7724,6 +7730,7 @@ v:lnum eval.txt /*v:lnum* v:mouse_col eval.txt /*v:mouse_col* v:mouse_lnum eval.txt /*v:mouse_lnum* v:mouse_win eval.txt /*v:mouse_win* +v:operator eval.txt /*v:operator* v:prevcount eval.txt /*v:prevcount* v:profiling eval.txt /*v:profiling* v:progname eval.txt /*v:progname* -- 2.11.4.GIT