The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/14/app-pgrestore.html
Description:
pg_restore seems to have two ways to restore data:
--section=data
or
--data-only
There is this cryptic warning that --data-only is "similar to but for
historical reasons different from" --section=data
But there is no further explanation of what those differences are or what
might be missed or different in your restore if you pick one option or the
other. Maybe one or the other option is the "preferred current way" and one
is the "historical way" or they are aimed at different types of use cases,
but that's not clear.