variable cleanup
Merge pull request #1 from fuzzy/master

fixed up README.md wrt shlib.main()
Add string.sub() to sub namespace
Merge remote-tracking branch 'upstream/master'
Add optarg() interface to compliment getarg()

 * In this context, optarg() is for optional arguments, and getarg()
   requires an argument, else it throws an error.
Handle multiple instances of '-c' on the cmdline
Added a FIXME note regarding lib names at import
Added primitive support for interface documetnation as MarkDown
Enforce 'shlib' namespacing for shlib core routines
shlib.doc should not return at current

 * This may change in the future, but for now shlib.doc is only used by
   'shlib --help <iface>'.
Minor non-functional changes

 * Stop redircting the debug NOP's, they don't output anything regardless

 * Change comment regarding '-c'
Remove '/' from interface names during import

 * From now on you are allowed to import 'lib' or 'lib.iface', though
   the old method of 'lib/iface' should still work.
Improved the behavior of shlib.doc().

 * Understands finding documentation for a lib vs an procedure.

 * A list of subroutines is automatically produced (might not be
   terribly useful for final MarkDown on GitHub)

 * Whole thing may need to be revisited once we have some real level of
   documentation accessible.
Updated shlib.doc interface

 * Interface now automatically reports sub-routines for library document
   footers and properly distinguishes between a valid interface w/out
   documentation vs a lack of an interface.
Remove placeholder, no longer necessary for new doc interface
Attempt to unify Github Markdown pages along side builtin documentation

 * Rewrote and reorganized most of the documentation.

 * Started documenting the shlib core interfaces
examples/index.md is invalid
Cleanup some of the formatting
Attempt to fix formatting regarding back-quote
More documentation formatting changes