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
@@ -2684,8 +2684,8 @@ A jump table for the options with a short description can be found at |Q_op|.
26842684 This option cannot be set from a | modeline | . It would most likely
26852685 corrupt the text.
26862686
2687- NOTE: For GTK+ 2 it is highly recommended to set 'encoding' to
2688- "utf-8". Although care has been taken to allow different values of
2687+ NOTE: For GTK+ 2 or later, it is highly recommended to set 'encoding'
2688+ to "utf-8". Although care has been taken to allow different values of
26892689 'encoding' , "utf-8" is the natural choice for the environment and
26902690 avoids unnecessary conversion overhead. "utf-8" has not been made
26912691 the default to prevent different behavior of the GUI and terminal
@@ -3596,6 +3596,14 @@ A jump table for the options with a short description can be found at |Q_op|.
35963596 On systems where 'guifontset' is supported (X11) and 'guifontset' is
35973597 not empty, then 'guifont' is not used.
35983598
3599+ Note: As to the GTK GUIs, no error is given against any invalid names,
3600+ and the first element of the list is always picked up and made use of.
3601+ This is because, instead of identifying a given name with a font, the
3602+ GTK GUIs use it to construct a pattern and try to look up a font which
3603+ best matches the pattern among available fonts, and this way, the
3604+ matching never fails. An invalid name doesn't matter because a number
3605+ of font properties other than name will do to get the matching done.
3606+
35993607 Spaces after a comma are ignored. To include a comma in a font name
36003608 precede it with a backslash. Setting an option requires an extra
36013609 backslash before a space and a backslash. See also
@@ -3618,7 +3626,7 @@ A jump table for the options with a short description can be found at |Q_op|.
36183626 The font name depends on the GUI used. See | setting-guifont | for a
36193627 way to set 'guifont' for various systems.
36203628
3621- For the GTK+ 2 GUI the font name looks like this: >
3629+ For the GTK+ 2 and 3 GUIs, the font name looks like this: >
36223630 :set guifont=Andale\ Mono\ 11
36233631< That's all. XLFDs are not used. For Chinese this is reported to work
36243632 well: >
@@ -3627,13 +3635,15 @@ A jump table for the options with a short description can be found at |Q_op|.
36273635 set guifontwide=Microsoft\ Yahei\ 12,WenQuanYi\ Zen\ Hei\ 12
36283636 endif
36293637<
3638+ (Replace gui_gtk2 with gui_gtk3 for the GTK+ 3 GUI)
3639+
36303640 For Mac OSX you can use something like this: >
36313641 :set guifont=Monaco:h10
36323642< Also see 'macatsui' , it can help fix display problems.
36333643 *E236*
36343644 Note that the fonts must be mono-spaced (all characters have the same
3635- width). An exception is GTK 2 : all fonts are accepted, but
3636- mono-spaced fonts look best.
3645+ width). An exception is GTK: all fonts are accepted, but mono-spaced
3646+ fonts look best.
36373647
36383648 To preview a font on X11, you might be able to use the "xfontsel"
36393649 program. The "xlsfonts" program gives a list of all available fonts.
@@ -3671,7 +3681,7 @@ A jump table for the options with a short description can be found at |Q_op|.
36713681 {not in Vi}
36723682 {only available when compiled with GUI enabled and
36733683 with the | +xfontset | feature}
3674- {not available in the GTK+ 2 GUI}
3684+ {not available in the GTK+ GUI}
36753685 When not empty, specifies two (or more) fonts to be used. The first
36763686 one for normal English, the second one for your special language. See
36773687 | xfontset | .
@@ -3700,15 +3710,15 @@ A jump table for the options with a short description can be found at |Q_op|.
37003710 Note: The size of these fonts must be exactly twice as wide as the one
37013711 specified with 'guifont' and the same height.
37023712
3703- All GUI versions but GTK+ 2 :
3713+ All GUI versions but GTK+:
37043714
37053715 'guifontwide' is only used when 'encoding' is set to "utf-8" and
37063716 'guifontset' is empty or invalid.
37073717 When 'guifont' is set and a valid font is found in it and
37083718 'guifontwide' is empty Vim will attempt to find a matching
37093719 double-width font and set 'guifontwide' to it.
37103720
3711- GTK+ 2 GUI only: *guifontwide_gtk2 *
3721+ GTK+ GUI only: *guifontwide_gtk *
37123722
37133723 If set and valid, 'guifontwide' is always used for double width
37143724 characters, even if 'encoding' is not set to "utf-8".
@@ -7606,7 +7616,7 @@ A jump table for the options with a short description can be found at |Q_op|.
76067616 For further details see | arabic.txt | .
76077617
76087618 *'termencoding'* *'tenc'*
7609- 'termencoding' 'tenc' string (default ""; with GTK+ 2 GUI: "utf-8"; with
7619+ 'termencoding' 'tenc' string (default ""; with GTK+ GUI: "utf-8"; with
76107620 Macintosh GUI: "macroman")
76117621 global
76127622 {only available when compiled with the | +multi_byte |
@@ -7618,7 +7628,7 @@ A jump table for the options with a short description can be found at |Q_op|.
76187628 display). Except for the Mac when 'macatsui' is off, then
76197629 'termencoding' should be "macroman".
76207630 *E617*
7621- Note: This does not apply to the GTK+ 2 GUI. After the GUI has been
7631+ Note: This does not apply to the GTK+ GUI. After the GUI has been
76227632 successfully initialized, 'termencoding' is forcibly set to "utf-8".
76237633 Any attempts to set a different value will be rejected, and an error
76247634 message is shown.
@@ -7901,7 +7911,7 @@ A jump table for the options with a short description can be found at |Q_op|.
79017911'toolbariconsize' 'tbis' string (default "small")
79027912 global
79037913 {not in Vi}
7904- {only in the GTK+ 2 GUI}
7914+ {only in the GTK+ GUI}
79057915 Controls the size of toolbar icons. The possible values are:
79067916 tiny Use tiny icons.
79077917 small Use small icons (default).
0 commit comments