I would suggest that while rewording might be useful a more beneficial improvement would be separating the commands into "Sync/ASync" and link back into the corresponding libpq documentation sections which dblink provides direct SQL layer access to (and which the docs seem to have been written under the assumption the reader was knowledgeable of that API).  It does abstract away some of the material in the libpq docs but I think it would be a reasonable halfway measure in lieu of spending time enhancing the mostly obsolete dblink extension documentation.

David J.