pgsql: Improve documentation around TS_execute().

Improve documentation around TS_execute().

I got frustrated by the lack of commentary in this area, so here is some
reverse-engineered documentation, along with minor stylistic cleanup.
No code changes more significant than removal of unused variables.

Back-patch to 9.6, not because that's useful in itself, but because
we have some bugs to fix in phrase search and this would cause merge
failures if it's only in HEAD.

Branch
------
REL9_6_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/6f734554c38811316a9d6951b4500a6d1b0b84aa

Modified Files
--------------
src/backend/tsearch/wparser_def.c | 2 +-
src/backend/utils/adt/tsginidx.c | 12 ++---
src/backend/utils/adt/tsvector_op.c | 92 ++++++++++++++++++++-----------------
src/include/tsearch/ts_utils.h | 61 ++++++++++++++++++------
4 files changed, 103 insertions(+), 64 deletions(-)