request clarification on pg_restore documentation

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.