I couldn't find the documentation. Attached patch adds one.
Probably this function should have been named pg_*. Too late.
-- Fabien.