more documentation with an example
various fixes from testing with bugzilla
bumping version