New tests. Code cleanup.

git-svn-id: http://llvm-py.googlecode.com/svn/trunk@11 8d1e9007-1d4e-0410-b67e-1979fd6579aa

www/src/contribute.txt

@@ -11,7 +11,6 @@ Browse SVN, http://code.google.com/p/llvm-py/source/browse/[http://code.google.c
 Issues tracker, http://code.google.com/p/llvm-py/issues/list[http://code.google.com/p/llvm-py/issues/list]
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-
 SVN HEAD can be checked out like so:
 
 ----
@@ -21,3 +20,12 @@ $ svn checkout http://llvm-py.googlecode.com/svn/trunk/ llvm-py
 Mahadevan R (mdevan.foobar@gmail.com) is available to answer your
 queries.
 
+Current Next Steps
+------------------
+
+- Wrap GenericValue, function call args for execution engine.
+- Add APIs to read/write `.bc` and `.ll` files.
+- Wrap `lto`.
+- Add examples.
+- Update documentation.
+- Improve tests.

www/src/index.txt

@@ -6,9 +6,11 @@ http://llvm.org/[LLVM]. It's goal is to expose enough of LLVM APIs to
 implement a compiler or VM in pure Python. Currently, llvm-py is
 available for LLVM 2.3 and Python 2.5, on Linux/x86. It is expected to
 be usable on various unices, as well as with Python 2.4, with minimal
-changes, if any. It should be stable enough for you to play with.
+changes, if any.
 
-llvm-py is just hatching, and your contributions would be most welcome.
+llvm-py is just hatching. It should be stable enough to start hacking
+away, though. Be sure to send in a patch (or shout at the author) if you
+miss any specific LLVM API.
 
 News
 ----

www/src/userguide.txt

@@ -1,6 +1,8 @@
 llvm-py User Guide
 ===================
 
+NOTE: This document is updated constantly. Check back often.
+
 llvm-py provides Python bindings for LLVM. This document explains how
 you can setup and use it. A working knowledge of Python and a basic idea
 of LLVM is assumed.
@@ -46,7 +48,7 @@ llvm-py is distributed as a source tarball. You'll need to build and
 install it before it can be used. At least the following will be
 required for this:
 
-- compilers, both gcc and g++
+- C and C\+\+ compilers (gcc/g\+\+)
 - Python itself
 - Python development files (headers and libraries)
 - LLVM, either installed or built
@@ -56,7 +58,11 @@ command `sudo apt-get install gcc g++ python python-dev'. Note that
 ubuntu repository has an old version of llvm (1.8) which will not work
 with llvm-py.
 
-Tip: If LLVM 2.3 does not install cleanly, try installing 'ocamldoc'
+It does not matter which compiler LLVM itself was built with (g\+\+,
+llvm-g\+\+ or any other); llvm-py can be built with any compiler. It has
+been tried only with gcc/g\+\+ though.
+
+Tip: If LLVM 2.3 does not install cleanly, try installing ``ocamldoc''
 first.
 
 
@@ -108,11 +114,16 @@ libraries of LLVM, use this:
 $ tar jxvf llvm-py-0.2.tar.bz2
 $ cd llvm-py-0.2
 $ python setup.py build -g --llvm-config=/home/mdevan/llvm/Debug/bin/llvm-config
-$ sudo python setup.py install -g --llvm-config=/home/mdevan/llvm/Debug/bin/llvm-config
+$ sudo python setup.py install --llvm-config=/home/mdevan/llvm/Debug/bin/llvm-config
 -----------------------------------------------------------------------
 
 Be warned that debug binaries will be huge (65MB+) !
 
+`setup.py` is a standard Python distutils script. See the Python
+documentation regarding http://docs.python.org/inst/inst.html[Installing
+Python Modules] and http://docs.python.org/dist/dist.html[Distributing
+Python Modules] for more information on such scripts.
+
 
 [[uninstall]]
 Uninstall
@@ -891,6 +902,12 @@ r3 = Constant.undef()                   # an `undefined' value
 source~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
+TypeHandle (llvm.core)
+~~~~~~~~~~~~~~~~~~~~~~
+
+TODO
+
+
 Instructions (llvm.core)
 ~~~~~~~~~~~~~~~~~~~~~~~~