Skip to content

Commit 69e7c44

Browse files
peterepetere
committed
psql: Review of new help output strings
1 parent 6542181 commit 69e7c44

File tree

2 files changed

+38
-38
lines changed

2 files changed

+38
-38
lines changed

‎src/bin/psql/describe.c

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2063,16 +2063,16 @@ describeOneTableDetails(const char *schemaname,
20632063
printTableAddFooter(&cont, _("Policies:"));
20642064

20652065
if (tableinfo.rowsecurity && tableinfo.forcerowsecurity && tuples > 0)
2066-
printTableAddFooter(&cont, _("Policies (Forced Row Security Enabled):"));
2066+
printTableAddFooter(&cont, _("Policies (forced row security enabled):"));
20672067

20682068
if (tableinfo.rowsecurity && !tableinfo.forcerowsecurity && tuples == 0)
2069-
printTableAddFooter(&cont, _("Policies (Row Security Enabled): (None)"));
2069+
printTableAddFooter(&cont, _("Policies (row security enabled): (none)"));
20702070

20712071
if (tableinfo.rowsecurity && tableinfo.forcerowsecurity && tuples == 0)
2072-
printTableAddFooter(&cont, _("Policies (Forced Row Security Enabled): (None)"));
2072+
printTableAddFooter(&cont, _("Policies (forced row security enabled): (none)"));
20732073

20742074
if (!tableinfo.rowsecurity && tuples > 0)
2075-
printTableAddFooter(&cont, _("Policies (Row Security Disabled):"));
2075+
printTableAddFooter(&cont, _("Policies (row security disabled):"));
20762076

20772077
/* Might be an empty set - that's ok */
20782078
for (i = 0; i < tuples; i++)

‎src/bin/psql/help.c

Lines changed: 34 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -180,9 +180,9 @@ slashUsage(unsigned short int pager)
180180

181181
fprintf(output, _("Help\n"));
182182

183-
fprintf(output, _(" \\? [commands] description of all psql backslash commands\n"));
184-
fprintf(output, _(" \\? options description of all psql commandline options\n"));
185-
fprintf(output, _(" \\? variables description of all psql configuration variables\n"));
183+
fprintf(output, _(" \\? [commands] show help on backslash commands\n"));
184+
fprintf(output, _(" \\? options show help on psql command-line options\n"));
185+
fprintf(output, _(" \\? variables show help on special variables\n"));
186186
fprintf(output, _(" \\h [NAME] help on syntax of SQL commands, * for all commands\n"));
187187
fprintf(output, "\n");
188188

@@ -323,76 +323,76 @@ helpVariables(unsigned short int pager)
323323
*/
324324
output = PageOutput(87, pager ? &(pset.popt.topt) : NULL);
325325

326-
fprintf(output, _("List of specially treated variables.\n"));
326+
fprintf(output, _("List of specially treated variables\n\n"));
327327

328328
fprintf(output, _("psql variables:\n"));
329329
fprintf(output, _("Usage:\n"));
330-
fprintf(output, _(" psql --set=NAME=VALUE\n or \\set NAME VALUE in interactive mode\n\n"));
330+
fprintf(output, _(" psql --set=NAME=VALUE\n or \\set NAME VALUE inside psql\n\n"));
331331

332332
fprintf(output, _(" AUTOCOMMIT if set, successful SQL commands are automatically committed\n"));
333-
fprintf(output, _(" COMP_KEYWORD_CASE determine the case used to complete SQL keywords\n"
333+
fprintf(output, _(" COMP_KEYWORD_CASE determines the case used to complete SQL key words\n"
334334
" [lower, upper, preserve-lower, preserve-upper]\n"));
335335
fprintf(output, _(" DBNAME the currently connected database name\n"));
336-
fprintf(output, _(" ECHO control what input is written to standard output\n"
336+
fprintf(output, _(" ECHO controls what input is written to standard output\n"
337337
" [all, errors, none, queries]\n"));
338-
fprintf(output, _(" ECHO_HIDDEN display internal queries executed by backslash commands when it is set\n"
339-
" or with [noexec] just show without execution\n"));
338+
fprintf(output, _(" ECHO_HIDDEN if set, display internal queries executed by backslash commands;\n"
339+
" if set to \"noexec\", just show without execution\n"));
340340
fprintf(output, _(" ENCODING current client character set encoding\n"));
341341
fprintf(output, _(" FETCH_COUNT the number of result rows to fetch and display at a time\n"
342342
" (default: 0=unlimited)\n"));
343-
fprintf(output, _(" HISTCONTROL control history list [ignorespace, ignoredups, ignoreboth]\n"));
344-
fprintf(output, _(" HISTFILE file name used to store the history list\n"));
343+
fprintf(output, _(" HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]\n"));
344+
fprintf(output, _(" HISTFILE file name used to store the command history\n"));
345345
fprintf(output, _(" HISTSIZE the number of commands to store in the command history\n"));
346-
fprintf(output, _(" HOST the currently connected database server\n"));
346+
fprintf(output, _(" HOST the currently connected database server host\n"));
347347
fprintf(output, _(" IGNOREEOF if unset, sending an EOF to interactive session terminates application\n"));
348-
fprintf(output, _(" LASTOID the value of last affected OID\n"));
349-
fprintf(output, _(" ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit SAVEPOINTs)\n"));
348+
fprintf(output, _(" LASTOID value of the last affected OID\n"));
349+
fprintf(output, _(" ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)\n"));
350350
fprintf(output, _(" ON_ERROR_STOP stop batch execution after error\n"));
351351
fprintf(output, _(" PORT server port of the current connection\n"));
352-
fprintf(output, _(" PROMPT1 specify the standard psql prompt\n"));
353-
fprintf(output, _(" PROMPT2 specify the prompt used when a statement continues from a previous line\n"));
354-
fprintf(output, _(" PROMPT3 specify the prompt used during COPY ... FROM STDIN\n"));
352+
fprintf(output, _(" PROMPT1 specifies the standard psql prompt\n"));
353+
fprintf(output, _(" PROMPT2 specifies the prompt used when a statement continues from a previous line\n"));
354+
fprintf(output, _(" PROMPT3 specifies the prompt used during COPY ... FROM STDIN\n"));
355355
fprintf(output, _(" QUIET run quietly (same as -q option)\n"));
356-
fprintf(output, _(" SHOW_CONTEXT control display of message context fields [never, errors, always]\n"));
356+
fprintf(output, _(" SHOW_CONTEXT controls display of message context fields [never, errors, always]\n"));
357357
fprintf(output, _(" SINGLELINE end of line terminates SQL command mode (same as -S option)\n"));
358358
fprintf(output, _(" SINGLESTEP single-step mode (same as -s option)\n"));
359359
fprintf(output, _(" USER the currently connected database user\n"));
360-
fprintf(output, _(" VERBOSITY control verbosity of error reports [default, verbose, terse]\n"));
360+
fprintf(output, _(" VERBOSITY controls verbosity of error reports [default, verbose, terse]\n"));
361361

362-
fprintf(output, _("\nDisplay influencing variables:\n"));
362+
fprintf(output, _("\nDisplay settings:\n"));
363363
fprintf(output, _("Usage:\n"));
364-
fprintf(output, _(" psql --pset=NAME[=VALUE]\n or \\pset NAME [VALUE] in interactive mode\n\n"));
364+
fprintf(output, _(" psql --pset=NAME[=VALUE]\n or \\pset NAME [VALUE] inside psql\n\n"));
365365

366366
fprintf(output, _(" border border style (number)\n"));
367-
fprintf(output, _(" columns set the target width for the wrapped format\n"));
368-
fprintf(output, _(" expanded (or x) toggle expanded output\n"));
369-
fprintf(output, _(" fieldsep field separator for unaligned output (default '|')\n"));
370-
fprintf(output, _(" fieldsep_zero set field separator in unaligned mode to zero\n"));
367+
fprintf(output, _(" columns target width for the wrapped format\n"));
368+
fprintf(output, _(" expanded (or x) expanded output [on, off, auto]\n"));
369+
fprintf(output, _(" fieldsep field separator for unaligned output (default \"%s\")\n"), DEFAULT_FIELD_SEP);
370+
fprintf(output, _(" fieldsep_zero set field separator for unaligned output to zero byte\n"));
371371
fprintf(output, _(" format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]\n"));
372372
fprintf(output, _(" footer enable or disable display of the table footer [on, off]\n"));
373373
fprintf(output, _(" linestyle set the border line drawing style [ascii, old-ascii, unicode]\n"));
374374
fprintf(output, _(" null set the string to be printed in place of a null value\n"));
375375
fprintf(output, _(" numericlocale enable or disable display of a locale-specific character to separate\n"
376376
" groups of digits [on, off]\n"));
377377
fprintf(output, _(" pager control when an external pager is used [yes, no, always]\n"));
378-
fprintf(output, _(" recordsep specify the record (line) separator to use in unaligned output format\n"));
379-
fprintf(output, _(" recordsep_zero set the record separator to use in unaligned output format to a zero byte.\n"));
378+
fprintf(output, _(" recordsep record (line) separator for unaligned output\n"));
379+
fprintf(output, _(" recordsep_zero set record separator for unaligned output to zero byte\n"));
380380
fprintf(output, _(" tableattr (or T) specify attributes for table tag in html format or proportional\n"
381-
" column width of left aligned data type in latex format\n"));
381+
" column widths for left-aligned data types in latex-longtable format\n"));
382382
fprintf(output, _(" title set the table title for any subsequently printed tables\n"));
383383
fprintf(output, _(" tuples_only if set, only actual table data is shown\n"));
384-
fprintf(output, _(" unicode_border_linestyle\n"));
385-
fprintf(output, _(" unicode_column_linestyle\n"));
386-
fprintf(output, _(" unicode_header_linestyle\n"
387-
" set the style of unicode line drawing [single, double]\n"));
384+
fprintf(output, _(" unicode_border_linestyle\n"
385+
" unicode_column_linestyle\n"
386+
" unicode_header_linestyle\n"
387+
" set the style of Unicode line drawing [single, double]\n"));
388388

389389
fprintf(output, _("\nEnvironment variables:\n"));
390390
fprintf(output, _("Usage:\n"));
391391

392392
#ifndef WIN32
393-
fprintf(output, _(" NAME=VALUE [NAME=VALUE] psql ...\n or \\setenv NAME [VALUE] in interactive mode\n\n"));
393+
fprintf(output, _(" NAME=VALUE [NAME=VALUE] psql ...\n or \\setenv NAME [VALUE] inside psql\n\n"));
394394
#else
395-
fprintf(output, _(" set NAME=VALUE\n psql ...\n or \\setenv NAME VALUE in interactive mode\n\n"));
395+
fprintf(output, _(" set NAME=VALUE\n psql ...\n or \\setenv NAME [VALUE] inside psql\n\n"));
396396
#endif
397397

398398
fprintf(output, _(" COLUMNS number of columns for wrapped format\n"));

0 commit comments

Comments
 (0)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy