update doc, some quirks