Противоречивые инструкции между страницами руководства и запуском справки по команде. ⇐ Linux

[Anonymous]

Недавно я пытался понять, почему запуск pip install --upgrade не обновляет некоторые пакеты в моей виртуальной среде.
Находясь на Ubuntu 22.04, я обратился к man-страницы для помощи.
Там я нашел следующее:

Код: Выделить всё

-U, --upgrade
Upgrade all packages to the newest available version.
This process is recursive regardless of whether a dependency is already satisfied.

Кажется, это не так, поэтому я немного растерялся.
Я проверил, откуда берутся страницы руководства, и они были местом установки системы

Код: Выделить всё

$ man -w pip
/usr/share/man/man1/pip3.1.gz

В конце концов я нашел pip --help, что, в свою очередь, привело меня к pip help install
Здесь я нашел различные инструкции по обновлению пакетов:

Код: Выделить всё

 -U, --upgrade    Upgrade all specified packages to the newest available version.
The handling of dependencies depends on the upgrade-strategy used.

--upgrade-strategy 
Determines how dependency upgrading should be handled [default: only-if-needed].
"eager"          dependencies are upgraded regardless of whether the currently installed
version satisfies the requirements of the upgraded package(s).
"only-if-needed" are upgraded only when they do not satisfy the requirements of the
upgraded package(s).

Указав стратегию быстрого обновления, я теперь могу воспроизвести поведение, описанное на страницах руководства.
Я пришел к выводу, что страницы руководства неверный/устаревший
Вопросы:

• Это ошибка Ubuntu или Pip? Если да, то следует ли мне сообщить об этом?
• Разве Pip больше не использует страницы руководства?
• Если страницы руководства больше не поддерживаются/устарели дата, почему они вообще там?

Подробнее здесь: https://stackoverflow.com/questions/785 ... he-command