better documentation, updated auto-generated files