summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichael Vogt <mvo@debian.org>2014-07-10 20:53:20 +0200
committerMichael Vogt <mvo@debian.org>2014-07-10 20:53:20 +0200
commit67c160fb95359506bca3e2899ea4851abdb157c4 (patch)
treeb9c62520e51f09389cb57b83d769ddfee4bd84ef
parent881de4cd8d432313e0ede1cc5857cae5b217e6d2 (diff)
parentc4d749b78a46e69887ec9662851f180e587f2d34 (diff)
Merge remote-tracking branch 'mvo/feature/README' into debian/sid
-rw-r--r--README.md37
1 files changed, 37 insertions, 0 deletions
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.
+