updated documentation, checked links, removed mlab.show from example for html generation