diff src/GvimExt/README.txt @ 10:4e2284e71352

updated for version 7.0002
author vimboss
date Thu, 24 Jun 2004 15:53:16 +0000
parents
children 30c4c1463b1a
line wrap: on
line diff
new file mode 100644
--- /dev/null
+++ b/src/GvimExt/README.txt
@@ -0,0 +1,94 @@
+README.txt for the gvimext DLL.
+
+Written by Tianmiao Hu.  Edited by Bram Moolenaar.
+
+
+INSTALLATION
+
+To install the "Edit with Vim" popup menu entry, it is recommended to use the
+"install.exe" program.  It will ask you a few questions and install the needed
+registry entries.
+
+In special situations you might want to make changes by hand.  Check these
+items:
+- The gvimext.dll, gvim.exe and uninstal.exe either need to be in the search
+  path, or you have to set the full path in the registry entries.  You could
+  move the gvimext.dll to the "windows\system" or "windows\system32"
+  directory, where the other DLL files are.
+- You can find the names of the used registry entries in the file
+  "GvimExt.reg".  You can edit this file to add the paths.  To install the
+  registry entries, right-click the gvimext.reg file and choose the "merge"
+  menu option.
+- The registry key [HKEY_LOCAL_MACHINE\Software\Vim\Gvim] is used by the
+  gvimext.dll.  The value "path" specifies the location of "gvim.exe".  If
+  gvim.exe is in the search path, the path can be omitted.  The value "lang"
+  can be used to set the language, for example "de" for German.  If "lang" is
+  omitted, the language set for Windows will be used.
+
+It is the preferred method to keep gvim.exe with the runtime files, so that
+Vim will find them (also the translated menu items are there).
+
+
+UNINSTALLATION
+
+To uninstall the "Edit with Vim" popup menu entry, it is recommended to use
+the "uninstal.exe" program.
+
+In special situations you might want to uninstall by hand:
+- Open the registry by running regedit.exe.
+- Delete all the keys listed in GvimExt.reg, except this one:
+  [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Shell Extensions\Approved]
+  For this key, only delete one value:
+  "{51EEE242-AD87-11d3-9C1E-0090278BBD99}"="Vim Shell Extension"
+- Delete the gvimext.dll, if you want.  You might need to reboot the machine
+  in order to remove this file.  A quick way is to log off and re-login.
+
+Another method is by using the uninst.bat script:
+    uninst gvimext.inf
+This batch file will remove all the registry keys from the system.  Then you
+can remove the gvimext.dll file.
+Note: In order for this batch file to work, you must have two system files:
+rundll32.exe and setupapi.dll.  I believe you will have rundll32.exe in your
+system.  I know windows nt 4.0 with the service pack 4 has setupapi.dll.  My
+windows 95 has setupapi.dll.  I find that the internet explorer 4.0 comes with
+the setupapi.dll in file Ie4_5.cab.
+
+If you do encounter problems running this script, then probably you need to
+modify the uninst.bat to suit to your system.  Basically, you must find out
+where are the locations for your rundll32.exe and setupapi.dll files.  In
+windows nt, both files are under c:\winnt\system32 directory. In my windows 95
+system, I got setupapi.dll at c:\windows\system and rundll32.exe at
+c:\windows.  So you might want to try something like:
+    rundll32.exe c:\windows\system\setupapi.dll,InstallHinfSection DefaultUninstall 128 %1
+where %1 can be substitued by gvimext.inf
+
+
+THE SOURCE CODE
+
+I have provided the source code here in hope that gvim users around world can
+further enhance this little dll.  I believe the only thing you need to change
+is gvimext.cpp file.  The important two functions you need to look at are
+QueryContextMenu and InvokeCommand.  You can modify right-click menus in the
+QueryContextMenu function and invoke gvim in the InvokeCommand function.  Note
+the selected files can be accessed from the DragQueryFile function.  I am not
+familiar with the invoking options for gvim.  I believe there are some
+improvements that can be made on that side.
+
+I use MS Visual C++ 6.0's nmake to make the gvimext.dll.  I don't have a
+chance to try earlier versions of MSVC.  The files that are required for build
+are:
+	gvimext.cpp
+	gvimext.h
+	gvimext.def
+	gvimext.rc
+	resource.h
+	Makefile
+
+To compile the DLL from the command line:
+	vcvars32
+	nmake -f Makefile
+
+If you did something interesting to this dll, please let me know
+@ tianmiao@acm.org.
+
+Happy vimming!!!