Doc patch on psql output formats - Mailing list pgsql-hackers

From Daniel Verite
Subject Doc patch on psql output formats
Date
Msg-id cb7e1caf-3ea6-450d-af28-f524903a030c@manitou-mail.org
Whole thread Raw
Responses Re: Doc patch on psql output formats
List pgsql-hackers
  Hi,

psql's documentation has this mention about output formats:
 "Unique abbreviations are allowed. (That would mean one letter is enough.)"

but "one letter is enough" is not true since 9.3 that added
"latex-longtable" sharing the same start as "latex", and then
9.5 added "asciidoc" with the same first letter as "aligned".

When a non-unique abbreviation is used, psql uses the first
match in an arbitrary order defined in do_pset() by
a cascade of pg_strncasecmp().
(the recent commit add9182e reorders them alphabetically
but it turns out that it doesn't change the relative positions
of  "aligned" / "asciidoc", or "latex" / "latex-longtables"
so \pset format a and \pset format l will continue to
select "aligned" and "latex" as before).

Anyway, "Unique abbreviations are allowed" deserves to
be changed as well.

PFA a doc patch to say simply "Abbreviations are allowed".


Best regards,
--
Daniel Vérité
PostgreSQL-powered mailer: http://www.manitou-mail.org
Twitter: @DanielVerite

Attachment

pgsql-hackers by date:

Previous
From: Andrew Gierth
Date:
Subject: Re: Optimizing nested ConvertRowtypeExpr execution
Next
From: Tom Lane
Date:
Subject: Re: plruby: rb_iterate symbol clash with libruby.so