Mercurial > vim

comparison runtime/doc/gui_x11.txt @ 11:4424b47a0797

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
updated for version 7.0003
author vimboss
date Wed, 30 Jun 2004 16:16:41 +0000
parents 3fc0f57ecb91
children bdeee1504ac1
comparison
equal deleted inserted replaced
10:4e2284e71352 11:4424b47a0797
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|
14 6. GNOME version |gui-gnome| 14 6. GNOME version |gui-gnome|
15 7. Compiling |gui-x11-compiling| 15 7. KDE version |gui-kde|
16 8. X11 selection mechanism |x11-selection| 16 8. Compiling |gui-x11-compiling|
17 9. X11 selection mechanism |x11-selection|
17 18
18 Other relevant documentation: 19 Other relevant documentation:
19 |gui.txt| For generic items of the GUI. 20 |gui.txt| For generic items of the GUI.
20 21
21 {Vi does not have any of these commands} 22 {Vi does not have any of these commands}
57 flag in 'guioptions'. |-f|. 58 flag in 'guioptions'. |-f|.
58 59
59 ============================================================================== 60 ==============================================================================
60 2. GUI Resources *gui-resources* *.Xdefaults* 61 2. GUI Resources *gui-resources* *.Xdefaults*
61 62
62 If using the Motif or Athena version of the GUI (not for the GTK+ or Win32 63 If using the Motif or Athena version of the GUI (not for the KDE, GTK+ or Win32
63 version), a number of X resources are available. You should use Vim's class 64 version), a number of X resources are available. You should use Vim's class
64 "Vim" when setting these. They are as follows: 65 "Vim" when setting these. They are as follows:
65 66
66 Resource name Meaning ~ 67 Resource name Meaning ~
67 68
432 is the window manager's job. But if compiled with GTK+ 2 support, Vim helps 433 is the window manager's job. But if compiled with GTK+ 2 support, Vim helps
433 the WM to identify the window by restoring the window role (using the |--role| 434 the WM to identify the window by restoring the window role (using the |--role|
434 command line argument). 435 command line argument).
435 436
436 ============================================================================== 437 ==============================================================================
437 7. Compiling *gui-x11-compiling* 438 7. KDE version *gui-kde* *KDE* *KVim*
439
440 The KDE version of Vim works with KDE 2.x and KDE 3.x.
441 KVim (name code for gui-kde) does not use traditional X settings for its
442 configuration.
443 Most important difference is the font handling, KVim uses QFont to display the
444 text. To set your font use the following syntax :
445 >
446 :set guifont=Fixed\ [Misc]/10/-1/5/50/0/0/0/1/0
447 <
448 the '10' value is the font size, other settings concerns more specific Qt
449 options which you should not need to care with.
450 The suggested way to choose your font is through the font selection dialog
451 available with the command :
452 :set guifont=*
453
454 Note: X Font names are not supported any more, so if you use GVim too, you'll
455 have to set something like this in your ~/.gvimrc : >
456
457 if has("gui_kde")
458 :set guifont=Fixed\ [Misc]/10/-1/5/50/0/0/0/1/0
459 else if has("gui_gtk")
460 :set guifont=-misc-fixed-medium-r-normal-*-*-100-*-*-c-*-iso10646-1
461 endif
462 <
463 *antialias*
464 KVim uses antialias for its font, so that the text looks better, to disable
465 this you have to refer to Qt's documentation (export QT_XFT=0 for QT 2.x).
466
467 KDE provides some other features, like being able to move the menubar and the
468 toolbar wherever you want around the text area.
469
470 *kde-toolbar*
471 KVim can be used with a KDE-look toolbar instead of Vim's default toolbar. To
472 enable this feature you have to run the configure script with the
473 --enable-kde-toolbar switch. It may be moved to a runtime option in the
474 future.
475
476 *DCOP*
477 Since Vim 6.0, the new ClientServer feature has been added, it works fine in
478 KVim too. KVim also provides its own communication scheme based on DCOP. This
479 is mainly used by the |vimpart| but can freely be used by other applications
480 or manually through KDE's DCOP tools. The DCOP servername is synchronized with
481 the X11 servername so that it's easier to identify the same KVim through the
482 two communication systems.
483
484 *vimpart* *vim-kpart*
485 KVim developers are also working on a component to allow embedding of Vim into
486 KDE's applications. As of this writing, the component is working and can be
487 used in different KDE applications. New KDE applications should support it
488 soon. To get more information about this component, refer to
489 http://freehackers.org/kvim or to the KDE project.
490
491 ==============================================================================
492 8. Compiling *gui-x11-compiling*
438 493
439 If using X11, Vim's Makefile will by default first try to find the necessary 494 If using X11, Vim's Makefile will by default first try to find the necessary
440 GTK+ files on your system. If the GTK+ files cannot be found, then the Motif 495 GTK+ files on your system. If the GTK+ files cannot be found, then the Motif
441 files will be searched for. Finally, if this fails, the Athena files will be 496 files will be searched for. Finally, if this fails, the Athena files will be
442 searched for. If all three fail, the GUI will be disabled. 497 searched for. If all three fail, the GUI will be disabled.
487 version, you might want to link with Xaw3d instead. This will make the 542 version, you might want to link with Xaw3d instead. This will make the
488 menus look a bit better. Edit the Makefile and look for "XAW_LIB". The 543 menus look a bit better. Edit the Makefile and look for "XAW_LIB". The
489 scrollbars will remain the same, because Vim has its own, which are already 544 scrollbars will remain the same, because Vim has its own, which are already
490 3D (in fact, they look more like Motif). 545 3D (in fact, they look more like Motif).
491 546
547 *gui-x11-kde*
548 For Vim-KDE, you need at least Qt(>=2.x) and the corresponding kdelibs.
549 To compile, you must use the --with-qt-dir configure flag because QTDIR is not
550 automatically detected yet. Giving KDE's directories to the configure script
551 may also help in some cases.
552
492 *gui-x11-neXtaw* 553 *gui-x11-neXtaw*
493 The neXtaw version is mostly like Athena, but uses different widgets. 554 The neXtaw version is mostly like Athena, but uses different widgets.
494 555
495 *gui-x11-misc* 556 *gui-x11-misc*
496 In general, do not try to mix files from different GTK+, Motif, Athena and X11 557 In general, do not try to mix files from different GTK+, Motif, Athena and X11
497 versions. This will cause problems. For example, using header files for 558 versions. This will cause problems. For example, using header files for
498 X11R5 with a library for X11R6 probably doesn't work (although the linking 559 X11R5 with a library for X11R6 probably doesn't work (although the linking
499 won't give an error message, Vim will crash later). 560 won't give an error message, Vim will crash later).
500 561
501 ============================================================================== 562 ==============================================================================
502 8. X11 selection mechanism *x11-selection* 563 9. X11 selection mechanism *x11-selection*
503 564
504 If using X11, in either the GUI or an xterm with an X11-aware Vim, then Vim 565 If using X11, in either the GUI or an xterm with an X11-aware Vim, then Vim
505 provides varied access to the X11 selection and clipboard. These are accessed 566 provides varied access to the X11 selection and clipboard. These are accessed
506 by using the two selection registers "* and "+. 567 by using the two selection registers "* and "+.
507 568