README.txt for the gmnvext DLL.

Written by Tianmiao Hu.  Edited by Bram Moolenaar.


INSTALLATION

To install the "Edit with MNV" 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 gmnvext.dll, gmnv.exe and uninstall.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 gmnvext.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
  "GmnvExt.reg".  You can edit this file to add the paths.  To install the
  registry entries, right-click the gmnvext.reg file and choose the "merge"
  menu option.
- The registry key [HKEY_LOCAL_MACHINE\Software\MNV\Gmnv] is used by the
  gmnvext.dll.  The value "path" specifies the location of "gmnv.exe".  If
  gmnv.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 gmnv.exe with the runtime files, so that
MNV will find them (also the translated menu items are there).


UNINSTALLATION

To uninstall the "Edit with MNV" 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 GmnvExt.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}"="MNV Shell Extension"
- Delete the gmnvext.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 gmnvext.inf
This batch file will remove all the registry keys from the system.  Then you
can remove the gmnvext.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 substituted by gmnvext.inf


THE SOURCE CODE

I have provided the source code here in hope that gmnv users around world can
further enhance this little dll.  I believe the only thing you need to change
is gmnvext.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 gmnv in the InvokeCommand function.  Note
the selected files can be accessed from the DragQueryFile function.  I am not
familiar with the invoking options for gmnv.  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 gmnvext.dll.  I don't have a
chance to try earlier versions of MSVC.  The files that are required for build
are:
	gmnvext.cpp
	gmnvext.h
	gmnvext.def
	gmnvext.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 mnvming!!!
