summaryrefslogtreecommitdiff
path: root/src/INSTALL
diff options
context:
space:
mode:
authorBram Moolenaar <Bram@vim.org>2021-01-31 16:45:53 +0100
committerBram Moolenaar <Bram@vim.org>2021-01-31 16:45:53 +0100
commit3d2bb8b6f152c0c5056f49bccb350683a9ba2e13 (patch)
tree2c6f6deecf44d07087b0d59cd692a568faf5a93a /src/INSTALL
parent6a12e3342d84a1d754d793ed5019778bd60e7494 (diff)
downloadvim-git-3d2bb8b6f152c0c5056f49bccb350683a9ba2e13.tar.gz
patch 8.2.2439: not easy to figure out what packages to getv8.2.2439
Problem: Not easy to figure out what packages to get when installing Vim on a new Ubuntu system. Solution: Mention explicit commands that are easy to follow.
Diffstat (limited to 'src/INSTALL')
-rw-r--r--src/INSTALL42
1 files changed, 41 insertions, 1 deletions
diff --git a/src/INSTALL b/src/INSTALL
index 9dbe31a50..1ed4887c7 100644
--- a/src/INSTALL
+++ b/src/INSTALL
@@ -39,13 +39,53 @@ version of Vim that is small and starts up quickly, see the Makefile for how
to disable the GUI and X11. If you don't have GUI libraries and/or X11, these
features will be disabled automatically.
+To built Vim on Ubuntu from scratch on a clean system using git:
+ Install tools required to be able to get and build Vim:
+ % sudo apt install git
+ % sudo apt install make
+ % sudo apt install clang
+
+ Build Vim with default features:
+ % git clone https://github.com/vim/vim.git
+ % cd vim/src
+ % make
+
+ Run tests to check there are no problems:
+ % make test
+
+ Install Vim in /usr/local:
+ % sudo make install
+
+ Add X windows clipboard support (also needed for GUI):
+ % sudo apt install libxt-dev
+ % make reconfig
+
+ Add GUI support (ignore compiler warnings):
+ % sudo apt install libgtk2.0-dev
+ % make reconfig
+
+ Add Python 3 support:
+ % sudo apt install libpython3-dev
+ Uncomment this line in Makefile:
+ "CONF_OPT_PYTHON3 = --enable-python3interp"
+ % make reconfig
+
+ Debugging:
+ % sudo apt install valgrind
+ Uncomment this line in Makefile:
+ CFLAGS = -g -Wall -Wextra -Wshadow -Wmissing-prototypes -Wunreachable-code -Wno-deprecated-declarations -U_FORTIFY_SOURCE -D_FORTIFY_SOURCE=1
+ % make reconfig
+ % make test_{test-name}
+ See output in testdir/valgrind.test_{test-name}
+
+
See the start of Makefile for more detailed instructions about how to compile
Vim.
If you need extra compiler and/or linker arguments, set $CFLAGS and/or $LIBS
before starting configure. Example:
- env CFLAGS=-I/usr/local/include LIBS=-lm make
+ env CFLAGS=-I/usr/local/include LIBS=-lm make
This is only needed for things that configure doesn't offer a specific argument
for or figures out by itself. First try running configure without extra