Mercurial > vim

comparison runtime/doc/gui_x11.txt @ 28303:9849df834f1d v8.2.4677

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
patch 8.2.4677: the Athena GUI support is outdated Commit: https://github.com/vim/vim/commit/0b962e5685edd41b55d5427b894797e725707639 Author: Bram Moolenaar <Bram@vim.org> Date: Sun Apr 3 18:02:37 2022 +0100 patch 8.2.4677: the Athena GUI support is outdated Problem: The Athena GUI support is outdated. Solution: Remove the Athena GUI code.
author Bram Moolenaar <Bram@vim.org>
date Sun, 03 Apr 2022 19:15:04 +0200
parents 661eb972cb22
children f8116058ca76
comparison
equal deleted inserted replaced
28302:d81a8f2db704 28303:9849df834f1d
1 *gui_x11.txt* For Vim version 8.2. Last change: 2020 Jun 05 1 *gui_x11.txt* For Vim version 8.2. Last change: 2022 Apr 03
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
7 Vim's Graphical User Interface *gui-x11* *GUI-X11* 7 Vim's Graphical User Interface *gui-x11* *GUI-X11*
8 *Athena* *Motif* 8 *Motif*
9 1. Starting the X11 GUI |gui-x11-start| 9 1. Starting the X11 GUI |gui-x11-start|
10 2. GUI Resources |gui-resources| 10 2. GUI Resources |gui-resources|
11 3. Shell Commands |gui-pty| 11 3. Shell Commands |gui-pty|
12 4. Various |gui-x11-various| 12 4. Various |gui-x11-various|
13 5. GTK version |gui-gtk| 13 5. GTK version |gui-gtk|
62 flag in 'guioptions'. |-f|. 62 flag in 'guioptions'. |-f|.
63 63
64 ============================================================================== 64 ==============================================================================
65 2. GUI Resources *gui-resources* *.Xdefaults* 65 2. GUI Resources *gui-resources* *.Xdefaults*
66 66
67 If using the Motif or Athena version of the GUI (not for the KDE, GTK+ or Win32 67 If using the Motif version of the GUI (not for the KDE, GTK+ or Win32
68 version), a number of X resources are available. You should use Vim's class 68 version), a number of X resources are available. You should use Vim's class
69 "Vim" when setting these. They are as follows: 69 "Vim" when setting these. They are as follows:
70 70
71 Resource name Meaning ~ 71 Resource name Meaning ~
72 72
94 94
95 geometry Initial geometry to use for gvim's window (default 95 geometry Initial geometry to use for gvim's window (default
96 is same size as terminal that started it). 96 is same size as terminal that started it).
97 scrollbarWidth Thickness of scrollbars. 97 scrollbarWidth Thickness of scrollbars.
98 borderWidth Thickness of border around text area. 98 borderWidth Thickness of border around text area.
99 menuHeight Height of the menu bar (only for Athena).
100 99
101 A special font for italic, bold, and italic-bold text will only be used if 100 A special font for italic, bold, and italic-bold text will only be used if
102 the user has specified one via a resource. No attempt is made to guess what 101 the user has specified one via a resource. No attempt is made to guess what
103 fonts should be used for these based on the normal text font. 102 fonts should be used for these based on the normal text font.
104 103
133 The first three of these are standard resources on Silicon Graphics machines 132 The first three of these are standard resources on Silicon Graphics machines
134 which make Motif applications look even better, highly recommended! 133 which make Motif applications look even better, highly recommended!
135 134
136 The "Vim*fontList" is to set the menu font for Motif. Example: > 135 The "Vim*fontList" is to set the menu font for Motif. Example: >
137 Vim*menuBar*fontList: -*-courier-medium-r-*-*-10-*-*-*-*-*-*-* 136 Vim*menuBar*fontList: -*-courier-medium-r-*-*-10-*-*-*-*-*-*-*
138 With Athena: >
139 Vim*menuBar*SmeBSB*font: -*-courier-medium-r-*-*-10-*-*-*-*-*-*-*
140 Vim*menuBar*MenuButton*font: -*-courier-medium-r-*-*-10-*-*-*-*-*-*-*
141 137
142 NOTE: A more portable, and indeed more correct, way to specify the menu font 138 NOTE: A more portable, and indeed more correct, way to specify the menu font
143 in either Motif or Athena is through the resource: > 139 in Motif is through the resource: >
144 Vim.menuFont: -*-courier-medium-r-*-*-10-*-*-*-*-*-*-* 140 Vim.menuFont: -*-courier-medium-r-*-*-10-*-*-*-*-*-*-*
145 Or, when compiled with the |+xfontset| feature: > 141 Or, when compiled with the |+xfontset| feature: >
146 Vim.menuFontSet: -*-courier-medium-r-*-*-10-*-*-*-*-*-*-* 142 Vim.menuFontSet: -*-courier-medium-r-*-*-10-*-*-*-*-*-*-*
147 143
148 Don't use "Vim*geometry" in the defaults. This will break the menus. Use 144 Don't use "Vim*geometry" in the defaults. This will break the menus. Use
253 249
254 :10amenu File.Print :w !lpr -Php3 250 :10amenu File.Print :w !lpr -Php3
255 :10vmenu File.Print :w !lpr -Php3 251 :10vmenu File.Print :w !lpr -Php3
256 < 252 <
257 *X11-icon* 253 *X11-icon*
258 Vim uses a black&white icon by default when compiled with Motif or Athena. A 254 Vim uses a black&white icon by default when compiled with Motif. A
259 colored Vim icon is included as $VIMRUNTIME/vim32x32.xpm. For GTK+, this is 255 colored Vim icon is included as $VIMRUNTIME/vim32x32.xpm. For GTK+, this is
260 the builtin icon used. Unfortunately, how you should install it depends on 256 the builtin icon used. Unfortunately, how you should install it depends on
261 your window manager. When you use this, remove the 'i' flag from 257 your window manager. When you use this, remove the 'i' flag from
262 'guioptions', to remove the black&white icon: > 258 'guioptions', to remove the black&white icon: >
263 :set guioptions-=i 259 :set guioptions-=i
592 If using X11, Vim's configure will by default first try to find the necessary 588 If using X11, Vim's configure will by default first try to find the necessary
593 GTK+ files on your system. When both GTK+ 2 and GTK+ 3 are available, GTK+ 2 589 GTK+ files on your system. When both GTK+ 2 and GTK+ 3 are available, GTK+ 2
594 will be chosen unless --enable-gui=gtk3 is passed explicitly to configure. 590 will be chosen unless --enable-gui=gtk3 is passed explicitly to configure.
595 591
596 If the GTK+ files cannot be found, then the Motif files will be searched for. 592 If the GTK+ files cannot be found, then the Motif files will be searched for.
597 Finally, if this fails, the Athena files will be searched for. If all three 593 If both fail, the GUI will be disabled.
598 fail, the GUI will be disabled.
599 594
600 For GTK+, Vim's configuration process uses pkg-config(1) to check if the 595 For GTK+, Vim's configuration process uses pkg-config(1) to check if the
601 GTK+ required for a specified build is properly installed and usable. 596 GTK+ required for a specified build is properly installed and usable.
602 Accordingly, it is a good idea to make sure before running configure that 597 Accordingly, it is a good idea to make sure before running configure that
603 your system has a working pkg-config together with the .pc file of the 598 your system has a working pkg-config together with the .pc file of the
619 If you want to build the GTK+ 3 GUI, you have to pass --enable-gui=gtk3 614 If you want to build the GTK+ 3 GUI, you have to pass --enable-gui=gtk3
620 explicitly to configure, and avoid passing --enable-gnome-check to that, as 615 explicitly to configure, and avoid passing --enable-gnome-check to that, as
621 the functionality of the GNOME 2 support has already been consolidated in 616 the functionality of the GNOME 2 support has already been consolidated in
622 GTK+ 3. 617 GTK+ 3.
623 618
624 Otherwise, if you are using Motif or Athena, when you have the Motif or Athena 619 Otherwise, if you are using Motif, when you have the Motif files in a
625 files in a directory where configure doesn't look, edit the Makefile to enter 620 directory where configure doesn't look, edit the Makefile to enter the names
626 the names of the directories. Search for "GUI_INC_LOC" for an example to set 621 of the directories. Search for "GUI_INC_LOC" for an example to set
627 the Motif directories, "CONF_OPT_X" for Athena. 622 the Motif directories.
628 623
629 *gui-x11-gtk* 624 *gui-x11-gtk*
630 Currently, Vim supports both GTK+ 2 and GTK+ 3. 625 Currently, Vim supports both GTK+ 2 and GTK+ 3.
631 626
632 The GTK+ 2 GUI requires GTK+ 2.2 or later. 627 The GTK+ 2 GUI requires GTK+ 2.2 or later.
641 X11R6 are OK. Motif 1.1 and X11R4 might work, no guarantee (there may be a 636 X11R6 are OK. Motif 1.1 and X11R4 might work, no guarantee (there may be a
642 few problems, but you might make it compile and run with a bit of work, please 637 few problems, but you might make it compile and run with a bit of work, please
643 send me the patches if you do). The newest releases of LessTif have been 638 send me the patches if you do). The newest releases of LessTif have been
644 reported to work fine too. 639 reported to work fine too.
645 640
646 *gui-x11-athena* 641 *gui-x11-athena* *gui-x11-neXtaw*
647 The Athena version uses the Xaw widget set by default. If you have the 3D 642 Support for the Athena GUI and neXtaw was removed in patch 8.2.4677.
648 version, you might want to link with Xaw3d instead. This will make the
649 menus look a bit better. Edit the Makefile and look for "XAW_LIB". The
650 scrollbars will remain the same, because Vim has its own, which are already
651 3D (in fact, they look more like Motif).
652
653 *gui-x11-neXtaw*
654 The neXtaw version is mostly like Athena, but uses different widgets.
655 643
656 *gui-x11-misc* 644 *gui-x11-misc*
657 In general, do not try to mix files from different GTK+, Motif, Athena and X11 645 In general, do not try to mix files from different GTK+, Motif and X11
658 versions. This will cause problems. For example, using header files for 646 versions. This will cause problems. For example, using header files for
659 X11R5 with a library for X11R6 probably doesn't work (although the linking 647 X11R5 with a library for X11R6 probably doesn't work (although the linking
660 won't give an error message, Vim will crash later). 648 won't give an error message, Vim will crash later).
661 649
662 ============================================================================== 650 ==============================================================================