[DOCS] pg_restore option data-only and section=data

Поиск
Список
Период
Сортировка
От Kenichiro Tanaka
Тема [DOCS] pg_restore option data-only and section=data
Дата
Msg-id CALyBiZLoyHvVt7soWsmaS0Ggqp4z_ay9Rmpq704tcyM6vhdbiQ@mail.gmail.com
обсуждение исходный текст
Список pgsql-docs
Hello,pgsql-docs

I'd like to propose improving following the description of PostgerSQL
documentation.

https://www.postgresql.org/docs/9.6/static/app-pgrestore.html

------------------------------------------------------------------------
This option is similar to, but for historical reasons not identical to,
specifying --section=data.
------------------------------------------------------------------------

I think this description is ambiguous for postgresql user(not Hacker).
In fact, my customer inquired our support "What is the difference
between  '--section=data' and --data-only ?".

I've read this git comment.

https://git.postgresql.org/gitweb/?p=postgresql.git;a=commitdiff;h=4317e0246c645f60c39e6572644cff1cb03b4c65
------------------------------------------------------------------------
Rewrite --section option to decouple it from --schema-only/--data-only.
------------------------------------------------------------------------

https://git.postgresql.org/gitweb/?p=postgresql.git;a=commitdiff;h=5110a96992e508b220a7a6ab303b0501c4237b4a
------------------------------------------------------------------------
This fixes an undesirable inconsistency between
the meanings of "--data-only" and "--section=data"
------------------------------------------------------------------------

Now,there is no difference  between '--section=data' and --data-only "
from the view point of user .Because they make same output.
(But internal procedure is different.)


So how about  changing description from

"This option is similar to, but for historical reasons not identical
to, specifying --section=data."

to

"This option makes same result which --section=data makes, but
internal procedure is different for historical reasons"


Regard Kenichiro Tanaka


В списке pgsql-docs по дате отправления:

Предыдущее
От: sergey.klimkevich@gmail.com
Дата:
Сообщение: [DOCS] INSERT/UPDATE/DELETE with RETURNING
Следующее
От: Robert Haas
Дата:
Сообщение: Re: [DOCS] Questionable tag usage