updated README

diff --git a/README b/README
index 35f81e18f4fe03ed61ef201e58c6ca750e8516fc..7fe3576435c49833188f1134be15e01ce8ea061c 100644 (file)
--- a/README
+++ b/README
@@ -2,16 +2,41 @@ Introduction: what is pyelftools?
 ---------------------------------\r
 \r
 **pyelftools** is a pure-Python library for parsing and analyzing ELF files\r
-and DWARF debugging information.\r
+and DWARF debugging information. See the User's guide\r
+(https://bitbucket.org/eliben/pyelftools/wiki/Userguide) for more details.\r
 \r
 Pre-requisites\r
 --------------\r
 \r
-**pyelftools** needs only Python to run. It works with Python versions 2.6 and\r
-2.7 (Python 3 support is planned but not yet implemented). For hacking on \r
-**pyelftools** the requirements are a bit more strict, please see the\r
-user's guide (ZZZ: link?)\r
+As a user of **pyelftools**, one only needs Python to run. It works with\r
+Python versions 2.6 and 2.7 (Python 3 support is in the works). For hacking\r
+on **pyelftools** the requirements are a bit more strict, please see the \r
+hacking guide (https://bitbucket.org/eliben/pyelftools/wiki/Hacking).\r
 \r
+Installing\r
+----------\r
+\r
+When you unzip the source distribution, run::\r
+\r
+    > python setup.py install\r
+\r
+Alternatively, **pyelftools** can be installed from PyPI (Python package\r
+index)::\r
+\r
+    > pip install pyelftools\r
+\r
+How to use it?\r
+--------------\r
+\r
+**pyelftools** is a regular Python library: you import and invoke it from your\r
+own code. For a detailed usage guide and links to examples, please consult the\r
+user's guide (https://bitbucket.org/eliben/pyelftools/wiki/Userguide).\r
+\r
+License\r
+-------\r
+\r
+**pyelftools** is open source software. Its code is in the public domain. See\r
+the ``LICENSE`` file for more details.\r
 \r
 \r
 \r