Omission of "(or C)" in psql's "pset title" header

Started by David G. Johnstonalmost 11 years ago10 messagesdocs
Jump to latest
#1David G. Johnston
david.g.johnston@gmail.com

http://www.postgresql.org/docs/devel/static/app-psql.html

The other pset keywords with black-slash aliases include a "(or <letter>)"
paren after the keyword. "title" does not (should be "C")

David J.

#2Monica Gamazo
gamazo_lorena@yahoo.es
In reply to: David G. Johnston (#1)
Re: Omission of "(or C)" in psql's "pset title" header

use my whatsapp 593987847535  Atte.Ing. Mónica GamazoIngeniera en Sistemas Computacionales
GAMAZO_SYS
Celular: 0987847535
skype: monicagamazo
Pagina web: http://www.computrabajo.com.ec/cvs/gamazosys

El Miércoles 24 de junio de 2015 17:12, David G. Johnston <david.g.johnston@gmail.com> escribió:

http://www.postgresql.org/docs/devel/static/app-psql.html

The other pset keywords with black-slash aliases include a "(or <letter>)" paren after the keyword.  "title" does not (should be "C")
David J.

#3Monica Gamazo
gamazo_lorena@yahoo.es
In reply to: David G. Johnston (#1)
Re: Omission of "(or C)" in psql's "pset title" header

all commands are used in operative system linux or unix  Atte.Ing. Mónica GamazoIngeniera en Sistemas Computacionales
GAMAZO_SYS
Celular: 0987847535
skype: monicagamazo
Pagina web: http://www.computrabajo.com.ec/cvs/gamazosys

El Miércoles 24 de junio de 2015 17:12, David G. Johnston <david.g.johnston@gmail.com> escribió:

http://www.postgresql.org/docs/devel/static/app-psql.html

The other pset keywords with black-slash aliases include a "(or <letter>)" paren after the keyword.  "title" does not (should be "C")
David J.

#4Bruce Momjian
bruce@momjian.us
In reply to: David G. Johnston (#1)
Re: Omission of "(or C)" in psql's "pset title" header

On Wed, Jun 24, 2015 at 06:11:20PM -0400, David G. Johnston wrote:

http://www.postgresql.org/docs/devel/static/app-psql.html

The other pset keywords with black-slash aliases include a "(or <letter>)"
paren after the keyword. �"title" does not (should be "C")

Attached is a patch to implement this, including a doc patch.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ Everyone has their own god. +

Attachments:

title.difftext/x-diff; charset=us-asciiDownload+6-6
#5David G. Johnston
david.g.johnston@gmail.com
In reply to: Bruce Momjian (#4)
Re: Omission of "(or C)" in psql's "pset title" header

On Wed, Aug 26, 2015 at 10:02 PM, Bruce Momjian <bruce@momjian.us> wrote:

On Wed, Jun 24, 2015 at 06:11:20PM -0400, David G. Johnston wrote:

http://www.postgresql.org/docs/devel/static/app-psql.html

The other pset keywords with black-slash aliases include a "(or

<letter>)"

paren after the keyword. "title" does not (should be "C")

Attached is a patch to implement this, including a doc patch.

​Wasn't expecting a code change - just the docs. The docs already said the
"\C [ title ]" is a valid meta-command...

Did you maybe end up making a command line "-C 'title'" valid instead?

David J.

#6Bruce Momjian
bruce@momjian.us
In reply to: David G. Johnston (#5)
Re: Omission of "(or C)" in psql's "pset title" header

On Wed, Aug 26, 2015 at 10:51:09PM -0400, David G. Johnston wrote:

On Wed, Aug 26, 2015 at 10:02 PM, Bruce Momjian <bruce@momjian.us> wrote:

On Wed, Jun 24, 2015 at 06:11:20PM -0400, David G. Johnston wrote:

http://www.postgresql.org/docs/devel/static/app-psql.html

The other pset keywords with black-slash aliases include a "(or <letter>)

"

paren after the keyword.  "title" does not (should be "C")

Attached is a patch to implement this, including a doc patch.

​Wasn't expecting a code change - just the docs.  The docs already said the "\C
[ title ]" is a valid meta-command...

Did you maybe end up making a command line "-C 'title'" valid instead?

Obviously I am not understanding you. I thought you were looking for
\pset C to be documented, and to work:

test=> \pset C test
Title is "test".

That does not work in the current sources, so I had to add it. This is
similar to how "\pset t" works as an alias for "\pset tuples_only":

test=> \pset t
Tuples only is on.

When our docs say:

<term><literal>tuples_only</literal> (or <literal>t</literal>)</term>

it is not talking about using \t, but rather "\pset t" --- perhaps that
is where the confusion is coming from. (Yeah, I know it is kind of
odd.)

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ Everyone has their own god. +

--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#7David G. Johnston
david.g.johnston@gmail.com
In reply to: Bruce Momjian (#6)
Re: Omission of "(or C)" in psql's "pset title" header

On Thu, Aug 27, 2015 at 11:13 AM, Bruce Momjian <bruce@momjian.us> wrote:

On Wed, Aug 26, 2015 at 10:51:09PM -0400, David G. Johnston wrote:

On Wed, Aug 26, 2015 at 10:02 PM, Bruce Momjian <bruce@momjian.us>

wrote:

On Wed, Jun 24, 2015 at 06:11:20PM -0400, David G. Johnston wrote:

http://www.postgresql.org/docs/devel/static/app-psql.html

The other pset keywords with black-slash aliases include a "(or

<letter>)

"

paren after the keyword. "title" does not (should be "C")

Attached is a patch to implement this, including a doc patch.

​Wasn't expecting a code change - just the docs. The docs already said

the "\C

[ title ]" is a valid meta-command...

Did you maybe end up making a command line "-C 'title'" valid instead?

Obviously I am not understanding you. I thought you were looking for
\pset C to be documented, and to work:

test=> \pset C test
Title is "test".

That does not work in the current sources, so I had to add it. This is
similar to how "\pset t" works as an alias for "\pset tuples_only":

test=> \pset t
Tuples only is on.

When our docs say:

<term><literal>tuples_only</literal> (or <literal>t</literal>)</term>

it is not talking about using \t, but rather "\pset t" --- perhaps that
is where the confusion is coming from. (Yeah, I know it is kind of
odd.)

​Yes, I read that as "\pset tuples_only" and "\t" are alternate forms of
the same thing
​ and thought that "\pset title" and "\C" should be documented similarly.
Making "\pset C <label>" work doesn't seem like an improvement.

David J.

#8Bruce Momjian
bruce@momjian.us
In reply to: David G. Johnston (#7)
Re: Omission of "(or C)" in psql's "pset title" header

On Thu, Aug 27, 2015 at 11:50:53AM -0400, David G. Johnston wrote:

​Yes, I read that as "\pset tuples_only" and "\t" are alternate forms of the
same thing
​ and thought that "\pset title" and "\C" should be documented similarly. 
Making "\pset C <label>" work doesn't seem like an improvement.

Well, making \pset C is at least consistent. We can't say "or C"
without it.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ Everyone has their own god. +

--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#9David G. Johnston
david.g.johnston@gmail.com
In reply to: Bruce Momjian (#8)
Re: Omission of "(or C)" in psql's "pset title" header

On Thursday, August 27, 2015, Bruce Momjian <bruce@momjian.us> wrote:

On Thu, Aug 27, 2015 at 11:50:53AM -0400, David G. Johnston wrote:

​Yes, I read that as "\pset tuples_only" and "\t" are alternate forms of

the

same thing
​ and thought that "\pset title" and "\C" should be documented

similarly.

Making "\pset C <label>" work doesn't seem like an improvement.

Well, making \pset C is at least consistent. We can't say "or C"
without it.

Agreed.

#10Bruce Momjian
bruce@momjian.us
In reply to: Bruce Momjian (#4)
Re: Omission of "(or C)" in psql's "pset title" header

On Wed, Aug 26, 2015 at 10:02:26PM -0400, Bruce Momjian wrote:

On Wed, Jun 24, 2015 at 06:11:20PM -0400, David G. Johnston wrote:

http://www.postgresql.org/docs/devel/static/app-psql.html

The other pset keywords with black-slash aliases include a "(or <letter>)"
paren after the keyword. �"title" does not (should be "C")

Attached is a patch to implement this, including a doc patch.

Patch applied.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ As you are, so once was I. As I am, so you will be. +
+ Roman grave inscription                             +

--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs