xref: /vim-8.2.3635/uninstall.txt (revision 30e8e735)
1*30e8e735SBram MoolenaarUninstalling Vim on MS-Windows.
2*30e8e735SBram Moolenaar
3*30e8e735SBram MoolenaarThere are three ways to remove Vim:
4*30e8e735SBram Moolenaar
5*30e8e735SBram Moolenaar1. With the GUI uninstaller.
6*30e8e735SBram Moolenaar   This is only available when Vim was installed with the self-installing
7*30e8e735SBram Moolenaar   executable.  This has a minimal number of questions.  It can delete
8*30e8e735SBram Moolenaar   everything that was installed.  This also unregisters the VisVim.dll.
9*30e8e735SBram Moolenaar
10*30e8e735SBram Moolenaar2. With uninstall.exe.
11*30e8e735SBram Moolenaar   This removes most installed items, but does not delete the files you
12*30e8e735SBram Moolenaar   unpacked.
13*30e8e735SBram Moolenaar
14*30e8e735SBram Moolenaar3. By hand.
15*30e8e735SBram Moolenaar   This is a bit more work, but you can decide exactly what you want to
16*30e8e735SBram Moolenaar   remove.  For uninstalling the "Edit with Vim" popup menu entry you still
17*30e8e735SBram Moolenaar   have to use uninstall.exe.
18*30e8e735SBram Moolenaar
19*30e8e735SBram MoolenaarIt's recommended to use the method that matches with how you installed Vim.
20*30e8e735SBram MoolenaarThus if you installed Vim by hand, delete it by hand.
21*30e8e735SBram Moolenaar
22*30e8e735SBram MoolenaarThe first two methods should be available from the Add/Remove software window
23*30e8e735SBram Moolenaarand the Vim entry in the Start menu.  If these have been removed already, find
24*30e8e735SBram Moolenaar"uninstall-gui.exe" or "uninstall.exe" in the Vim directory.
25*30e8e735SBram Moolenaar   Running these programs should be self-explanatory.  Carefully read the
26*30e8e735SBram Moolenaarmessages to avoid deleting something you want to keep.
27*30e8e735SBram Moolenaar
28*30e8e735SBram MoolenaarHere are guidelines for removing Vim by hand:
29*30e8e735SBram Moolenaar
30*30e8e735SBram Moolenaar1. Remove the "Edit with Vim" popup menu entry, if it exists.  This is done by
31*30e8e735SBram Moolenaar   running the uninstall.exe program.  It removes the registry entries for the
32*30e8e735SBram Moolenaar   "Edit with Vim" popup menu entry.  You only need to run uninstall.exe when
33*30e8e735SBram Moolenaar   you have installed the menu entry.  You can also run uninstall.exe from the
34*30e8e735SBram Moolenaar   Control panel with the Add/Remove programs application.
35*30e8e735SBram Moolenaar   Note that uninstall.exe offers you the option to uninstall other items.  You
36*30e8e735SBram Moolenaar   can skip this.
37*30e8e735SBram Moolenaar
38*30e8e735SBram Moolenaar2. Only if you have used the OLE version of gvim: Remove the registration of
39*30e8e735SBram Moolenaar   this program by running "gvim -unregister" in a console window.
40*30e8e735SBram Moolenaar
41*30e8e735SBram Moolenaar3. Delete the executables.  If you copied the executables to another location,
42*30e8e735SBram Moolenaar   you will have to delete them from where you copied them to.  If you don't
43*30e8e735SBram Moolenaar   remember where they are, look in the directories from the $PATH environment
44*30e8e735SBram Moolenaar   variable.
45*30e8e735SBram Moolenaar   If you created .bat files when installing Vim, also search for vim.bat,
46*30e8e735SBram Moolenaar   gvim.bat, etc.
47*30e8e735SBram Moolenaar
48*30e8e735SBram Moolenaar4. If you want to completely delete vim, and are not going to install another
49*30e8e735SBram Moolenaar   version, you can delete the vimrc files that you created.  These are
50*30e8e735SBram Moolenaar   normally located in a directory like "C:\vim".  If the $VIM environment
51*30e8e735SBram Moolenaar   variable is set, it will tell the name of the directory.  Normally you can
52*30e8e735SBram Moolenaar   delete everything in this directory.  Warning: You might have put some
53*30e8e735SBram Moolenaar   files there that you would like to save.  If you did remove it all, you can
54*30e8e735SBram Moolenaar   skip the next step.
55*30e8e735SBram Moolenaar
56*30e8e735SBram Moolenaar5. Delete the distributed files.  If you followed the directions, these will
57*30e8e735SBram Moolenaar   be located in a directory like "C:\vim\vim81".  If the $VIM environment
58*30e8e735SBram Moolenaar   variable is set, the directory will be $VIM\vim81.  Delete the "vim81"
59*30e8e735SBram Moolenaar   directory and all that is in it.  Warning: If you changed any of the
60*30e8e735SBram Moolenaar   distributed files, or added some of your own files, you might want to save
61*30e8e735SBram Moolenaar   these first.  But normally you would not have changed or added files here.
62*30e8e735SBram Moolenaar
63*30e8e735SBram Moolenaar6. Remove setting the $VIM and $VIMRUNTIME environment variable and adjust
64*30e8e735SBram Moolenaar   $PATH.  $VIM only needs to be removed if you are not going to install
65*30e8e735SBram Moolenaar   another version of Vim.  $VIMRUNTIME is mostly not set.  Check if $PATH
66*30e8e735SBram Moolenaar   contains the path of the vim directory.  Note that $PATH may be set in
67*30e8e735SBram Moolenaar   several places, you will have to find the right one, and only delete the
68*30e8e735SBram Moolenaar   Vim path from it.  You might need to use the "System Properties" editor to
69*30e8e735SBram Moolenaar   change the environment variables.  You can start it by selecting
70*30e8e735SBram Moolenaar   Start/Settings/Control Panel and then "System".
71*30e8e735SBram Moolenaar
72*30e8e735SBram Moolenaar7. If you added a Vim entry in the start menu, delete it.
73*30e8e735SBram Moolenaar
74*30e8e735SBram Moolenaar8. If you created icons for Vim on the desktop, delete them.
75*30e8e735SBram Moolenaar
76*30e8e735SBram MoolenaarVim does not use .ini files.  The above should remove all Vim files, except
77*30e8e735SBram Moolenaarthe ones that you moved elsewhere yourself.
78