diff options
| author | Stephen Frost <sfrost@snowman.net> | 2016-11-29 10:35:07 -0500 |
|---|---|---|
| committer | Stephen Frost <sfrost@snowman.net> | 2016-11-29 10:35:07 -0500 |
| commit | d722927e1f0ce13a289c3dd8106265d27ca25c3b (patch) | |
| tree | 1350171882455257406a5d11b2f47dcb09a54548 | |
| parent | 40eb468a1b2678475b648617bf5fc428739eb807 (diff) | |
| download | postgresql-d722927e1f0ce13a289c3dd8106265d27ca25c3b.tar.gz postgresql-d722927e1f0ce13a289c3dd8106265d27ca25c3b.zip | |
Clarify pg_dump -b documentation
The documentation around the -b/--blobs option to pg_dump seemed to
imply that it might be possible to add blobs to a "schema-only" dump or
similar. Clarify that blobs are data and therefore will only be
included in dumps where data is being included, even when -b is used to
request blobs be included.
The -b option has been around since before 9.2, so back-patch to all
supported branches.
Discussion: https://postgr.es/m/20161119173316.GA13284@tamriel.snowman.net
| -rw-r--r-- | doc/src/sgml/ref/pg_dump.sgml | 7 |
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index be1b684082d..f1e60bb51b1 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -138,8 +138,11 @@ PostgreSQL documentation <para> Include large objects in the dump. This is the default behavior except when <option>--schema</>, <option>--table</>, or - <option>--schema-only</> is specified, so the <option>-b</> - switch is only useful to add large objects to selective dumps. + <option>--schema-only</> is specified. The <option>-b</> + switch is therefore only useful to add large objects to dumps + where a specific schema or table has been requested. Note that + blobs are considered data and therefore will be included when + --data-only is used, but not when --schema-only is. </para> </listitem> </varlistentry> |