1- *options.txt* For Vim version 8.0. Last change: 2017 Jan 28
1+ *options.txt* For Vim version 8.0. Last change: 2017 Feb 09
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -2697,7 +2697,7 @@ A jump table for the options with a short description can be found at |Q_op|.
26972697 This option cannot be set from a | modeline | . It would most likely
26982698 corrupt the text.
26992699
2700- NOTE: For MacVim and GTK+ 2 it is highly recommended to set 'encoding'
2700+ NOTE: For MacVim and GTK+, it is highly recommended to set 'encoding'
27012701 to "utf-8". Although care has been taken to allow different values of
27022702 'encoding' , "utf-8" is the natural choice for the environment and
27032703 avoids unnecessary conversion overhead. "utf-8" has not been made
@@ -3695,6 +3695,14 @@ A jump table for the options with a short description can be found at |Q_op|.
36953695 On systems where 'guifontset' is supported (X11) and 'guifontset' is
36963696 not empty, then 'guifont' is not used.
36973697
3698+ Note: As to the GTK GUIs, no error is given against any invalid names,
3699+ and the first element of the list is always picked up and made use of.
3700+ This is because, instead of identifying a given name with a font, the
3701+ GTK GUIs use it to construct a pattern and try to look up a font which
3702+ best matches the pattern among available fonts, and this way, the
3703+ matching never fails. An invalid name doesn't matter because a number
3704+ of font properties other than name will do to get the matching done.
3705+
36983706 Spaces after a comma are ignored. To include a comma in a font name
36993707 precede it with a backslash. Setting an option requires an extra
37003708 backslash before a space and a backslash. See also
@@ -3720,7 +3728,7 @@ A jump table for the options with a short description can be found at |Q_op|.
37203728 The font name depends on the GUI used. See | setting-guifont | for a
37213729 way to set 'guifont' for various systems.
37223730
3723- For the GTK+ 2 GUI the font name looks like this: >
3731+ For the GTK+ 2 and 3 GUIs, the font name looks like this: >
37243732 :set guifont=Andale\ Mono\ 11
37253733< That's all. XLFDs are not used. For Chinese this is reported to work
37263734 well: >
@@ -3729,15 +3737,17 @@ A jump table for the options with a short description can be found at |Q_op|.
37293737 set guifontwide=Microsoft\ Yahei\ 12,WenQuanYi\ Zen\ Hei\ 12
37303738 endif
37313739<
3732- For Mac OS X you can use something like this: >
3740+ (Replace gui_gtk2 with gui_gtk3 for the GTK+ 3 GUI)
3741+
3742+ For Mac OSX you can use something like this: >
37333743 :set guifont=Monaco:h10
37343744< Also see 'macatsui' , it can help fix display problems {not in MacVim}.
37353745 In MacVim, fonts with spaces are set like this: >
37363746 :set guifont=DejaVu\ Sans\ Mono:h13
37373747<
37383748 *E236*
37393749 Note that the fonts must be mono-spaced (all characters have the same
3740- width). An exception is MacVim and GTK 2 : all fonts are accepted, but
3750+ width). An exception is MacVim and GTK: all fonts are accepted, but
37413751 mono-spaced fonts look best.
37423752
37433753 To preview a font on X11, you might be able to use the "xfontsel"
@@ -3776,7 +3786,7 @@ A jump table for the options with a short description can be found at |Q_op|.
37763786 {not in Vi}
37773787 {only available when compiled with GUI enabled and
37783788 with the | +xfontset | feature}
3779- {not available in the GTK+ 2 GUI}
3789+ {not available in the GTK+ GUI}
37803790 When not empty, specifies two (or more) fonts to be used. The first
37813791 one for normal English, the second one for your special language. See
37823792 | xfontset | .
@@ -3805,7 +3815,7 @@ A jump table for the options with a short description can be found at |Q_op|.
38053815 Note: The size of these fonts must be exactly twice as wide as the one
38063816 specified with 'guifont' and the same height.
38073817
3808- All GUI versions but MacVim and GTK+ 2 :
3818+ All GUI versions but MacVim and GTK+:
38093819
38103820 'guifontwide' is only used when 'encoding' is set to "utf-8" and
38113821 'guifontset' is empty or invalid.
@@ -3819,7 +3829,7 @@ A jump table for the options with a short description can be found at |Q_op|.
38193829 that font will be used for all wide fonts. However, if a glyph is
38203830 not available in the wide font, then font substitution is still used.
38213831
3822- GTK+ 2 GUI only: *guifontwide_gtk2*
3832+ GTK+ GUI only: *guifontwide_gtk2*
38233833
38243834 If set and valid, 'guifontwide' is always used for double width
38253835 characters, even if 'encoding' is not set to "utf-8".
@@ -7790,7 +7800,7 @@ A jump table for the options with a short description can be found at |Q_op|.
77907800
77917801 *'termencoding'* *'tenc'*
77927802'termencoding' 'tenc' string (default ""
7793- with GTK+ 2 and MacVim GUIs: "utf-8"
7803+ with GTK+ and MacVim GUIs: "utf-8"
77947804 with Macintosh (Carbon) GUI: "macroman")
77957805 global
77967806 {only available when compiled with the | +multi_byte |
@@ -7804,7 +7814,7 @@ A jump table for the options with a short description can be found at |Q_op|.
78047814 In the Win32 console version the default value is the console codepage
78057815 when it differs from the ANSI codepage.
78067816 *E617*
7807- Note: This does not apply to the GTK+ 2 and MacVim GUIs. After the
7817+ Note: This does not apply to the GTK+ and MacVim GUIs. After the
78087818 GUI has been successfully initialized, 'termencoding' is forcibly set
78097819 to "utf-8". Any attempts to set a different value will be rejected,
78107820 and an error message is shown.
@@ -8088,7 +8098,7 @@ A jump table for the options with a short description can be found at |Q_op|.
80888098'toolbariconsize' 'tbis' string (default "small")
80898099 global
80908100 {not in Vi}
8091- {only in the GTK+ 2 and MacVim GUIs}
8101+ {only in the GTK+ and MacVim GUIs}
80928102 Controls the size of toolbar icons. The possible values are:
80938103 tiny Use tiny icons.
80948104 small Use small icons (default).
0 commit comments