doc: brought up to date