pg_dump --exclude-* options documentation

Started by Peter Eisentrautover 6 years ago4 messages
#1Peter Eisentraut
peter.eisentraut@2ndquadrant.com

We have the following options in pg_dump:

--exclude-schema=schema
--exclude-table=table
--exclude-table-data=table

and new in pg_dumpall:

--exclude-database=pattern

I was momentarily confused that the latter is documented as taking a
"pattern" but the others are not. Of course they all take the same kind
of pattern.

Should we change the documentation of the old pg_dump options to also
take a "pattern", or change the documentation of the new pg_dumpall
option to read "database"?

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

#2Fabien COELHO
coelho@cri.ensmp.fr
In reply to: Peter Eisentraut (#1)
Re: pg_dump --exclude-* options documentation

We have the following options in pg_dump:

--exclude-schema=schema
--exclude-table=table
--exclude-table-data=table

and new in pg_dumpall:

--exclude-database=pattern

I was momentarily confused that the latter is documented as taking a
"pattern" but the others are not. Of course they all take the same kind
of pattern.

Should we change the documentation of the old pg_dump options to also
take a "pattern", or change the documentation of the new pg_dumpall
option to read "database"?

My 0.02€: we should use the more general and precise, i.e. pattern.

--
Fabien.

#3Tom Lane
tgl@sss.pgh.pa.us
In reply to: Fabien COELHO (#2)
Re: pg_dump --exclude-* options documentation

Fabien COELHO <coelho@cri.ensmp.fr> writes:

Should we change the documentation of the old pg_dump options to also
take a "pattern", or change the documentation of the new pg_dumpall
option to read "database"?

My 0.02€: we should use the more general and precise, i.e. pattern.

+1 ... it doesn't seem to me that "--exclude-schema=schema" conveys
anything useful.

regards, tom lane

#4Peter Eisentraut
peter.eisentraut@2ndquadrant.com
In reply to: Tom Lane (#3)
Re: pg_dump --exclude-* options documentation

On 2019-09-02 16:55, Tom Lane wrote:

Fabien COELHO <coelho@cri.ensmp.fr> writes:

Should we change the documentation of the old pg_dump options to also
take a "pattern", or change the documentation of the new pg_dumpall
option to read "database"?

My 0.02€: we should use the more general and precise, i.e. pattern.

+1 ... it doesn't seem to me that "--exclude-schema=schema" conveys
anything useful.

done

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services