|
1 | | -*gui_x11.txt* For Vim version 7.4. Last change: 2016 Apr 08 |
| 1 | +*gui_x11.txt* For Vim version 7.4. Last change: 2016 Aug 21 |
2 | 2 |
|
3 | 3 |
|
4 | 4 | VIM REFERENCE MANUAL by Bram Moolenaar |
@@ -421,6 +421,9 @@ These are the different looks: |
421 | 421 | GNOME is compiled with if it was found by configure and the |
422 | 422 | --enable-gnome-check argument was used. |
423 | 423 |
|
| 424 | +Note: Avoid use of --enable-gnome-check with GTK+ 3 GUI build. The |
| 425 | +functionality mentioned above is consolidated in GTK+ 3. |
| 426 | + |
424 | 427 |
|
425 | 428 | GNOME session support *gui-gnome-session* *gnome-session* |
426 | 429 |
|
@@ -457,39 +460,52 @@ continues on Yzis: https://github.com/chrizel/Yzis. |
457 | 460 | ============================================================================== |
458 | 461 | 8. Compiling *gui-x11-compiling* |
459 | 462 |
|
460 | | -If using X11, Vim's Makefile will by default first try to find the necessary |
461 | | -GTK+ files on your system. If the GTK+ files cannot be found, then the Motif |
462 | | -files will be searched for. Finally, if this fails, the Athena files will be |
463 | | -searched for. If all three fail, the GUI will be disabled. |
| 463 | +If using X11, Vim's configure will by default first try to find the necessary |
| 464 | +GTK+ files on your system. When both GTK+ 2 and GTK+ 3 are available, GTK+ 2 |
| 465 | +will be chosen unless --enable-gui=gtk3 is passed explicitly to configure. |
| 466 | + |
| 467 | +If the GTK+ files cannot be found, then the Motif files will be searched for. |
| 468 | +Finally, if this fails, the Athena files will be searched for. If all three |
| 469 | +fail, the GUI will be disabled. |
| 470 | + |
| 471 | +For GTK+, Vim's configuration process uses pkg-config(1) to check if the |
| 472 | +GTK+ required for a specified build is properly installed and usable. |
| 473 | +Accordingly, it is a good idea to make sure before running configure that |
| 474 | +your system has a working pkg-config together with the .pc file of the |
| 475 | +required GTK+. For that, say, run the following on the command line to see if |
| 476 | +your pkg-config works with your GTK+ 2: > |
| 477 | +
|
| 478 | + $ pkgconfig --modversion gtk+-2.0 |
464 | 479 |
|
465 | | -For GTK+, Vim's configuration process requires that GTK+ be properly |
466 | | -installed. That is, the shell script 'gtk-config' must be in your PATH, and |
467 | | -you can already successful compile, build, and execute a GTK+ program. The |
468 | | -reason for this is that the compiler flags (CFLAGS) and link flags (LDFLAGS) |
469 | | -are obtained through the 'gtk-config' shell script. |
| 480 | +Replace gtk+-2.0 with gtk+-3.0 for GTK+ 3. If you get the correct version |
| 481 | +number of your GTK+, you can proceed; if not, you probably need to do some |
| 482 | +system administration chores to set up pkg-config and GTK+ correctly. |
470 | 483 |
|
471 | | -If you want to build with GTK+ 2 support pass the --enable-gtk2-check argument |
472 | | -to ./configure. Optionally, support for GNOME 2 will be compiled if the |
473 | | ---enable-gnome-check option is also given. |
| 484 | +The GTK+ 2 GUI is built by default. Therefore, you usually don't need to pass |
| 485 | +any options such as --enable-gui=gtk2 to configure and build that. |
| 486 | + |
| 487 | +Optionally, the GTK+ 2 GUI can consolidate the GNOME 2 support. This support |
| 488 | +is enabled by passing --enable-gnome-check to configure. |
| 489 | + |
| 490 | +If you want to build the GTK+ 3 GUI, you have to pass --enable-gui=gtk3 |
| 491 | +explicitly to configure, and avoid passing --enable-gnome-check to that, as |
| 492 | +the functionality of the GNOME 2 support has already been consolidated in |
| 493 | +GTK+ 3. |
474 | 494 |
|
475 | 495 | Otherwise, if you are using Motif or Athena, when you have the Motif or Athena |
476 | 496 | files in a directory where configure doesn't look, edit the Makefile to enter |
477 | 497 | the names of the directories. Search for "GUI_INC_LOC" for an example to set |
478 | 498 | the Motif directories, "CONF_OPT_X" for Athena. |
479 | 499 |
|
480 | 500 | *gui-x11-gtk* |
481 | | -At the time of this writing, GTK+ version 1.0.6 and 1.2 are outdated. It |
482 | | -is suggested that you use GTK 2. The GTK 1 support will most likely be |
483 | | -dropped soon. |
484 | | - |
485 | | -For the GTK+ 2 GUI, using the latest release of the GTK+ 2.0 or GTK+ 2.2 |
486 | | -series is recommended. |
487 | | - |
488 | | -Lastly, although GTK+ has supposedly been ported to the Win32 platform, this |
489 | | -has not been tested with Vim and is also unsupported. Also, it's unlikely to |
490 | | -even compile since GTK+ GUI uses parts of the generic X11 code. This might |
491 | | -change in distant future; particularly because getting rid of the X11 centric |
492 | | -code parts is also required for GTK+ framebuffer support. |
| 501 | +Currently, Vim supports both GTK+ 2 and GTK+ 3. |
| 502 | + |
| 503 | +The GTK+ 2 GUI requires GTK+ 2.2 or later. |
| 504 | + |
| 505 | +Although the GTK+ 3 GUI is written in such a way that the source code can be |
| 506 | +compiled against all versions of the 3.x series, we recommend GTK+ 3.10 or |
| 507 | +later because of its substantial implementation changes in redraw done at |
| 508 | +that version. |
493 | 509 |
|
494 | 510 | *gui-x11-motif* |
495 | 511 | For Motif, you need at least Motif version 1.2 and/or X11R5. Motif 2.0 and |
|
0 commit comments