more documentation about this library
further improvements, and a note on efficiency
minor heading fix
fix typos