summaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorStephen Frost <sfrost@snowman.net>2016-11-29 10:35:12 -0500
committerStephen Frost <sfrost@snowman.net>2016-11-29 10:35:12 -0500
commitbe0b98fc21648f8483d00670a73c5e6ea89a5fb1 (patch)
treee22a19b1c0d51121a1ae1b60727935359186f820 /doc/src
parentac1d9dbcbe4842402e85dee82901341913386f3a (diff)
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
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/ref/pg_dump.sgml7
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 dac073144ed..8f216ae6be3 100644
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -132,8 +132,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>