From c4d749b78a46e69887ec9662851f180e587f2d34 Mon Sep 17 00:00:00 2001
From: Michael Vogt <mvo@debian.org>
Date: Thu, 10 Jul 2014 17:46:26 +0200
Subject: add REAMDE.md

---
 README.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 000000000..1a7f6f224
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+apt - Advanced Packaging Tool
+=============================
+
+apt is the main package management tool for Debian and its variants.
+It enables to search and install deb packages. The underlying libraries
+that apt is build upon are called libapt-pkg and libapt-inst.
+
+Coding
+------
+Apt is maintained in git, considering creating a branch when you
+start hacking on it.
+
+Apt uses its own autoconf based build system, see README.make for
+more details. To get started, just run:
+```
+$ make
+```
+from a fresh checkout.
+
+When you make changes and want to run them, make sure your 
+$LD_LIBRARY_PATH points to the new location, e.g. via:
+```
+$ export LD_LIBRARY_PATH=$(pwd)/build/bin
+$ ./build/bin/apt-get moo
+```
+
+Testing
+-------
+
+There is a extensive integration testsuite available via:
+```
+$ ./test/integration/run-tests
+```
+
+as well as gtest-dev based integration tests available in
+`./test/libapt` and can be run with make test.
+
-- 
cgit v1.2.3