1. Clone the repository (either the git repository or the Mercurial
mirror, they should give you the same source tree).
2. I assume you aren't interested in building several versions of Vim
with different configure arguments.
3. Set up a script to be sourced by your shell in order to set the
configure settings appropriately.
http://users.skynet.be/antoine.mechelynck/vim/compunix.htm has an
example for the bash shell. Modify it as needed. At least the
"compiled-by" will need to be changed, possibly other lines. /!\ Your
shell should *source* this script, not *execute* it.
4. Run "make config" in the vim or vim/src directory of your clone.
This will prepare the configure files according to your wishes _and_
to what software is instaled on your machine. You should log the
output and chek it. If it's OK:
5. Run "make" in the same directory. This should build a Vim
executable and put it in the vim/src directory of your clone.
6. Run "make install". This will install the executable you just built
(stripping the result), normally into /usr/local/bin/. It will also
install the corresponding runtime files, normally under
/usr/local/share/vim/vim81/.
7. I expect "make install" to create (the first ime) a number of
symllinks to your new executable, but if it didn't you may create them
manually as folows (assuming your Vim is GUI-enabled):
pushd /usr/local/bin
ln -sv vim eview
ln -sv vim evim
ln -sv vim ex
ln -sv vim gview
ln -sv vim gvim
ln -sv vim gvimdiff
... (etc. for the executable names found at ":help ex")
popd
Beware that the ln utilty wants the target first and the link name
afterwards, which I find counterintuitive. Adding the -v (verbose)
switch, as above, lets you check that it created the links the way you
wanted them.
When there are source changes, you can then update your clone, make
sure your configuration arguments areset in the environment as with 3
above, and run make followed by make install as in 5 and 6 above. (No
need to reconfigure.) This will rebuild only the changed modules.
If you want to change your configuration arguments, edit the script to
set your environment differently, then run "make reconfig" instead of
"make". This will rerun configure and recompile everything from
scratch. Then run "make install" as above.
The "make install" step will not only install the executable in the
$PATH where it belongs, it will also install the _corresponding_
runtime files (from the vim/runtime/ directory of your clone) where
that executable will expect them. When you run Vim, $VIM and
$VIMRUNTIME should not be set outside of Vim, it will set them
appropriately (usually to /usr/local/share/vim and
/usr/local/share/vim/vim81 respectively; if and when Vim 8.2 gets
released it will set $VIMRUNTIME to something ending in …/vim82
instead).
Best regards,
Tony.