mostly updated some documentation, also some predications and overrides