From: Bram Moolenaar <Bram@vim.org>
Date: Sun, 31 Jan 2021 15:45:53 +0000 (+0100)
Subject: patch 8.2.2439: not easy to figure out what packages to get
X-Git-Tag: v8.2.2439
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=3d2bb8b6f152c0c5056f49bccb350683a9ba2e13;p=vim

patch 8.2.2439: not easy to figure out what packages to get

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.
---

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
diff --git a/src/version.c b/src/version.c
index fe5d21936..0ef800645 100644
--- a/src/version.c
+++ b/src/version.c
@@ -750,6 +750,8 @@ static char *(features[]) =
 
 static int included_patches[] =
 {   /* Add new patch number below this line */
+/**/
+    2439,
 /**/
     2438,
 /**/