Updating row with pg => success or failure

I don’t see any problem in the doc. Maybe you misread the sentence?:
"If the SQL command that generated the PGresult was NOT ONE OF …
".