update doc files

suggestion from martin magr