[UPDATE] global php doc harmonisation and minor improvement