Incomplete description for \t in psql documentation - should mention caption - Mailing list pgsql-hackers

<div dir="ltr"><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">​​<a
href="http://www.postgresql.org/docs/9.5/interactive/app-psql.html">http://www.postgresql.org/docs/9.5/interactive/app-psql.html</a></div><div
class="gmail_default"style="font-family:arial,helvetica,sans-serif"><br /></div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">"""</div><divclass="gmail_default"
style="font-family:arial,helvetica,sans-serif"><divclass="gmail_default">\t</div><div class="gmail_default">Toggles the
displayof output column name headings and row count footer. This command is equivalent to \pset tuples_only and is
providedfor convenience.</div></div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">"""</div><divclass="gmail_default"
style="font-family:arial,helvetica,sans-serif"><br/></div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">Experiencesays that a table caption (i.e., \C) is also suppressed when
theoption is used.</div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif"><br /></div><div
class="gmail_default"style="font-family:arial,helvetica,sans-serif">The documentation should be changed though I'd
arguethat there is some merit for still showing the caption.</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif"><br/></div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">Theexact combination I wanted to try and make work was:</div><div
class="gmail_default"style="font-family:arial,helvetica,sans-serif">\C 'Table Caption'</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">\x\t</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">SELECT* FROM tbl LIMIT 1</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif"><br/></div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">Thedesired output would have been:</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif"><br/></div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">TableCaption</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">col1  | 1</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">col2  | 2</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">col3  | 3</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif"><br/></div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">Thisis also a bit mis-leading: the \t suppresses column name headings -
unlessviewed in expanded mode...in which case it suppresses the "ROW#" block heading but leave the column name headings
(whichjust happen to be placed in rows) in place.  This is indeed the desired behavior it just isn't precisely
documented.</div><divclass="gmail_default" style="font-family:arial,helvetica,sans-serif"><br /></div><div
class="gmail_default"style="font-family:arial,helvetica,sans-serif">So:</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif"><br/></div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">\t</div><divclass="gmail_default"
style="font-family:arial,helvetica,sans-serif">Togglesdisplay of the row count footer.  In normal mode also suppresses
thecolumn name headings.  In expanded mode suppresses the Record# block header instead.  Also suppresses any caption
thatis set for the table.</div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif"><br
/></div><divclass="gmail_default" style="font-family:arial,helvetica,sans-serif">I'm not sure how willing someone is to
workthese mechanics out - or the desire to make them conditional on expanded versus table mode.  My immediate needs can
bereadily solved by adding an additional column to my output so that "type | Record Type" is the first column of the
expandedoutput.  Or just live with the redundant "-[ RECORD 1 ]---------" header.</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif"><br/></div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif">DavidJ.</div><div class="gmail_default"
style="font-family:arial,helvetica,sans-serif"><br/></div></div>