Add a README

README.md

+agetpkg
+=======
+
+Introduction
+------------
+**agetpkg** is a command line tool used to quickly list/get/install packages stored on the [Archlinux Archive](https://wiki.archlinux.org/index.php/Arch_Linux_Archive).
+
+**agetpkg** means **A**rchive **G**et **P**ackage.
+
+Usage
+-----
+
+###### Download xterm version 296
+```bash
+agetpkg ^xterm$ 296
+# or
+agetpkg -g ^xterm$ 296
+```
+
+###### List xterm version 296
+```bash
+agetpkg -l ^xterm$ 296
+```
+
+###### Install all gvfs packages in version 1.26.0 release 3
+```bash
+agetpkg -i gvfs 1.26.0 3
+```
+
+###### List only i686 packages of nftables
+```bash
+agetpkg -l -A i686 -- nftables
+```
+
+###### Force update of the index before listing packages matching i3
+```bash
+agetpkg -u -l i3-wm
+```
+
+###### Download all version of xterm
+```bash
+agetpkg -l -a ^xterm$
+```
+
+###### Use another archive url
+```bash
+agetpkg --url http://archlinux.arkena.net/archive/packages/.all/ -l bash$
+```
+or
+```bash
+export ARCHIVE_URL=http://archlinux.arkena.net/archive/packages/.all/
+agetpkg -l bash$
+```
+
+###### Run agetpkg in debug mode
+```bash
+agetpkg --debug -l coreutils
+```
+
+###### Display current version
+```bash
+agetpkg --version
+```
+
+Installation
+------------
+
+To install the current released version of **agetpkg**, run:
+```bash
+pacman -S agetpkg
+```
+
+To install the git development version, run:
+```bash
+makepkg
+pacman -U agetpkg-*-any.pkg.tar.xz
+```
+
+Dependencies
+------------
+- [Python 3.x](http://python.org/download/releases/)
+- [PyXDG](http://freedesktop.org/wiki/Software/pyxdg)
+
+Sources
+-------
+**agetpkg** sources are available on [github](https://github.com/seblu/agetpkg/).
+
+License
+-------
+**agetpkg** is licensied under the term of [GPL v2](http://www.gnu.org/licenses/gpl-2.0.html).
+
+AUTHOR
+------
+**agetpkg** was started by Sébastien Luttringer in September 2015.