psql: Improve descriptions of \\flush[request] in --help
authorMichael Paquier <michael@paquier.xyz>
Sat, 19 Apr 2025 23:16:57 +0000 (08:16 +0900)
committerMichael Paquier <michael@paquier.xyz>
Sat, 19 Apr 2025 23:16:57 +0000 (08:16 +0900)
Noah has reported that the current wording was confusing compared to the
description of the underlying libpq routine.  The new wording is from
me.

Reported-by: Noah Misch <noah@leadboat.com>
Discussion: https://postgr.es/m/20250415213450.1f.nmisch@google.com

src/bin/psql/help.c

index daa725246c984c0234a4f641bedfc771799e4220..8c917e61f49058bcd862d405b3a0de16c8f84951 100644 (file)
@@ -169,8 +169,8 @@ slashUsage(unsigned short int pager)
    HELP0("  \\crosstabview [COLUMNS] execute query and display result in crosstab\n");
    HELP0("  \\endpipeline           exit pipeline mode\n");
    HELP0("  \\errverbose            show most recent error message at maximum verbosity\n");
-   HELP0("  \\flush                 push unsent data to the server\n");
-   HELP0("  \\flushrequest          send a flushrequest command\n");
+   HELP0("  \\flush                 flush output data to the server\n");
+   HELP0("  \\flushrequest          send request to the server to flush its output buffer\n");
    HELP0("  \\g [(OPTIONS)] [FILE]  execute query (and send result to file or |pipe);\n"
          "                         \\g with no arguments is equivalent to a semicolon\n");
    HELP0("  \\gdesc                 describe result of query, without executing it\n");