added several php doc comments and FIXME reminder