update syntax with some more metadata