Add a Makefile that creates API documentation and runs unit tests

.gitignore

@@ -0,0 +1,2 @@
+# Do not track documentation that LuaDoc creates.
+docs/

Makefile

@@ -0,0 +1,16 @@
+.PHONY : docs tests
+
+all: docs tests
+
+# We generate documentation via the LuaDoc tool but the directory
+# where we store the documents may not exist.  This rule creates the
+# documentation directory if it is not present.  LuaDoc will also spit
+# out a 'luadoc.css' file into the top-level directory which we do not
+# want to keep.  This rule will delete it.
+docs:
+	if test ! -d "docs/"; then mkdir "docs"; fi
+	luadoc -d "docs/" "src/Luvent.lua"
+	if test -f "luadoc.css"; then rm "luadoc.css"; fi
+
+tests:
+	busted

README.md

@@ -24,6 +24,22 @@ Luvent requires one of the following Lua implementations:
 These are the versions we use to test Luvent.  It should work with
 later versions of each, and possibly older versions as well.
 
+### Optional ###
+
+The following programs are not necessary in order to use Luvent but
+you will need them to run the unit tests, generate API documentation,
+and so on.
+
+* [LuaDoc][]
+* [busted][]
+
+
+Documentation
+-------------
+
+Running the command `make docs` will populate the `docs/` directory
+with HTML documents that describe Luvent’s API.
+
 
 Acknowledgments
 ---------------
@@ -47,3 +63,5 @@ Copyright 2013 Eric James Michael Ritz
 [EventLib]: https://github.com/mlnlover11/EventLib
 [Node.js]: http://nodejs.org/
 [LuaJIT]: http://luajit.org/
+[LuaDoc]: http://keplerproject.github.io/luadoc/
+[busted]: http://olivinelabs.com/busted/