Warning, /sdk/kompare/tests/subversion/unifiedm.diff is written in an unsupported language. File is not indexed.

0001 Index: NEWS
0002 ===================================================================
0003 --- NEWS
0004 +++ NEWS        2002-09-22 14:34:37.000000000 +0200
0005 @@ -1 +1 @@
0006 -
0007 +just a fake modif for kompare tests
0008 Index: README
0009 ===================================================================
0010 --- README
0011 +++ README      2002-09-13 23:05:48.000000000 +0200
0012 @@ -1,117 +1,47 @@
0013 -                                               Vim KPart
0014 -
0015 -
0016 -                                                                       by Philippe Fremy <pfremy@kde.com>
0017 -
0018 -
0019 -Okay, I made it : a Vim KPart!
0020 -
0021 -This means that you can have Vim embedded inside Konqueror, and everywhere a
0022 -text ReadWrite or ReadOnly KPart is requested. Actually, there is almost no
0023 -place right now where this is the case in KDE. KMail uses its own editor,
0024 -KDEvelop uses its own editor, Kate uses some more powerful Kate component.
0025 -
0026 -But this only the beginning. Enabling a part in those programs shouldn't be
0027 -much hassle and you can probably help me do it. My hope is really to get
0028 -KDevelop use Vim.
0029 -
0030 -
0031 -======= OBSOLETE ===========
0032 -Requirements:
0033 --------------
0034 -To make this KPart work, you need a graphicial Vim version 6 with the client-server stuff feature activated and with the vim60-vimpart-patch.diff applied. The patch is in this dir. I hope to get it into the main Vim tree.  KVim has already the patch but is slightly less stable that the original GVim.  A big advantage of KVim is that you get the native KDE dialogs when vim asks a question.
0035 -
0036 -
0037 -======= OBSOLETE ===========
0038 -Installation:
0039 --------------
0040 -To make your vimpart work, you'll have to go into the vimpart directory and run "testVim your_patched_vim". If the test does work, a file goodVim will be created. You will be able to install and use the component. Else, the test will report why it fails (features missing in vim).
0041 -
0042 -
0043 -
0044 -======= OBSOLETE ===========
0045 -Testing:
0046 ---------
0047 -If you want to see your component without installing it, you can do the
0048 -following:
0049 -
0050 -1. configure, build. Then go into the Vimpart subdirectory.
0051 -
0052 -2. Include the current Vimpart directory in your KDEDIRS:
0053 -export KDEDIRS=`pwd`:$KDEDIR
0054 -
0055 -3. Symlink .libs to lib
0056 -ln -s .libs lib
0057 -
0058 -4. Create pseudo share/services dir:
0059 -mkdir share; mkdir share/services;
0060 -
0061 -5. Symlink to Vimpart.desktop:
0062 -ln -s Vimpart.desktop share/services/Vimpart.desktop
0063 -
0064 -6. Create a pseudo share/config dir
0065 -mkdir share/config;
0066 -
0067 -7. Symlink to vimwidgetrc
0068 -ln -s vimwidgetrc share/config/vimwidgetrc
0069 -
0070 -8. Update the desktop mimetype database:
0071 -kbuildsycoca
0072 -
0073 -To test it, run VimPartShell. Or run konqueror from this dir and click on a
0074 -text file.
0075 -
0076 -
0077 -======= OBSOLETE ===========
0078 -Remarks:
0079 ---------
0080 -The initial preference of the Vim KPart is 10. Kate uses 8, so if you install the part, it will override Kate for all the mimetypes. You can always change that by manually editing the initial preference in the desktop file or by simply selecting which editor you prefer for which mimetype in the control center.
0081 -
0082 -If you find some mimetype not handled by the Vim KPart although they should be, send me a patch!
0083 -
0084 -
0085 -
0086 -How it works:
0087 --------------
0088 -At the beginning, we started to write KVim, a port of GVim to KDE to make
0089 -it possible to embed Vim inside KDE. But with the latest version of Vim, it
0090 -turns out that it is not necessary to have a native Vim.
0091 -
0092 -
0093 -I use QXembed, a widget which can embed any X application if it knows its X Window Id, using some X feature.  The patch I provide will make vim displays its window id on stdout when the window is mapped. GVim 6.0 then provides a way to send commands to a Vim window from another process. If you look at the VimWidget source, you will see that 70% of the code is there to handle the communication process. The rest uses the communication channel to send the vim commands needed by kpart and ktexteditor.
0094 -
0095 -As far as I can tell, the part is race-condition free. If you issue many sendNormalCmd and many evalExpr, they are guaranted to be executed sequentially. This has caused me enough problems when it wasn't the case!
0096 -
0097 -
0098 -Qt, KDE2 and KDE3:
0099 -------------------
0100 -The VimWidget itself depends very litle on KDE. It is quite easy to port remove the KDE specific stuff, to use it in a Qt only program. In fact, at the beginning, it was only Qt-based.
0101 -
0102 -
0103 -
0104 -======= OBSOLETE ===========
0105 -Features & TODO:
0106 -----------------
0107 -I think most basic features required by an editor widget or part are supported. There are some possible improvement but I would like more feedback to know what really needs to be done. So don't hesitate to write me about your feelings using this.
0108 -
0109 -My TODO list is:
0110 -- restore the editing mode after sendCmd
0111 -- implement KTextEditor interface
0112 -- add some useful actions to the part (like search, ...)
0113 -
0114 -
0115 -
0116 -Feedback:
0117 ----------
0118 -For the Vim KPart : pfremy@kde.com
0119 -For KVim: pfremy@kde.org, mikmak@freenux.org, orzel@kde.org
0120 -
0121 -
0122 -
0123 -
0124 -
0125 -
0126 -
0127 +Yes, that's really a Vim Komponent :)
0128 +Yes, you can have Vim inside KDE apps, you guessed it :)
0129  
0130 +So, it's designed for KDE 3.x (if someone wants to port it to KDE 2 that
0131 +should be easy), it uses GVim or KVim (even Motif Vim works) 6.x.
0132 +It can be used in different apps : 
0133 +       - KDevelop (version 3)
0134 +       - Konqueror (as a file viewer)
0135 +       - KWrite
0136 +       - KMail (coming in KDE 3.2)
0137 +       - Kompare, KBabel ........ ;)
0138 +
0139 +CONFIGURATION
0140 +=============
0141 +once you compiled and installed it as any other app, 
0142 +start your KDE Control Center, go to the file manager section
0143 +and open the Vim Component configuration module.
0144 +Here, you have to select a Vim executable which may be found on 
0145 +your computer (generally /usr/bin/vim) will do it fine for most
0146 +linux distributions. All you need is that it's a GUI-enabled Vim 6.0 or
0147 +better.
0148 +Push the test button, if that's okay then that's should be enough to start
0149 +using it :)
0150 +
0151 +FUNCTIONMENT
0152 +============
0153 +Philippe Fremy (pfremy@kde.com) wrote the initial version of this kpart.
0154 +The concept is to start a normal GUI Vim (like gvim), then "embeds" the Vim
0155 +window into a KDE Widget.
0156 +It used to be based on the ClientServer feature of Vim (type :help
0157 +clientserver in Vim for more info) using external processus to control the
0158 +embedded Vim. That was running quite fine, but was slow :/
0159 +We changed that :)
0160 +Now we communicate directly from the kpart to the embedded Vim thanks to X11
0161 +without using externals processus. That's much faster and reliable ;)
0162 +KVim has also another remote control system using KDE's DCOP communication
0163 +backend.
0164 +Currently I would advice people to use DCOP when running KVim and using X11
0165 +communication with GVim (DCOP won't work with GVim anyway).
0166 +There may be some differences in speed, though I have not noticed it here.
0167 +The most important difference is that DCOP provides a signal system and that can
0168 +make a difference to improve the interaction between KVim and the hosting
0169 +application (KDevelop for example). But it's not yet used.
0170  
0171 +Hope you'll enjoy Vim inside KDE :)
0172 +Mickael "Mikmak" Marchand (marchand@kde.org)
0173