Re: [PATCH 1/5] Docs: changes.rst: rename file and references and add links

[Jonathan Corbet]

Manuel Ebner <manuelebnerli@xxxxxxxxxxx> writes:

> The current name does not reflect the content of the file, the new name
> does so. With the links legacy references should continue to work.
>
> Change name to software-requirements.rst
> Change names in Doc/translations/*
> Add link Doc/process/changes.rst to software-version.rst.
> Add link Doc/Changes to software-version.rst.
> Add links in Doc/translations/*
> Change changes.rst to software-version.rst inChange changes.rst to software-version.rst in
>  Documentation/*
>  README
>  samples/bpf/README.rst
>  scripts/min-tool-version.sh
>  scripts/ver_linux
>
> Signed-off-by: Manuel Ebner <manuelebnerli@xxxxxxxxxxx>
> ---
>  Documentation/Changes                         |   2 +-
>  Documentation/admin-guide/README.rst          |   6 +-
>  Documentation/doc-guide/sphinx.rst            |   2 +-
>  Documentation/filesystems/locks.rst           |   2 +-
>  Documentation/process/changes.rst             | 576 +----------------
>  Documentation/process/howto.rst               |   2 +-
>  .../process/software-requirements.rst         | 575 +++++++++++++++++
>  .../translations/it_IT/process/changes.rst    | 554 +----------------
>  .../translations/it_IT/process/howto.rst      |   2 +-
>  .../it_IT/process/software-requirements.rst   | 553 +++++++++++++++++
>  .../translations/ja_JP/process/howto.rst      |   2 +-
>  .../translations/ko_KR/process/howto.rst      |   2 +-
>  .../translations/pt_BR/process/changes.rst    | 577 +-----------------
>  .../pt_BR/process/software-requirements.rst   | 576 +++++++++++++++++
>  .../translations/sp_SP/process/howto.rst      |   2 +-
>  .../translations/zh_CN/admin-guide/README.rst |   6 +-
>  .../translations/zh_CN/process/howto.rst      |   2 +-
>  .../translations/zh_TW/admin-guide/README.rst |   6 +-
>  .../translations/zh_TW/process/howto.rst      |   2 +-
>  README                                        |   2 +-
>  samples/bpf/README.rst                        |   2 +-
>  scripts/min-tool-version.sh                   |   2 +-
>  scripts/ver_linux                             |   2 +-
>  23 files changed, 1730 insertions(+), 1727 deletions(-)
>  mode change 100644 => 120000 Documentation/process/changes.rst
>  create mode 100644 Documentation/process/software-requirements.rst
>  mode change 100644 => 120000 Documentation/translations/it_IT/process/changes.rst
>  create mode 100644 Documentation/translations/it_IT/process/software-requirements.rst
>  mode change 100644 => 120000 Documentation/translations/pt_BR/process/changes.rst
>  create mode 100644 Documentation/translations/pt_BR/process/software-requirements.rst

That is a *lot* of churn just because you don't like the name of the
file.  The naming is not perfect - it is the result of decades of
history - but I think we're better to live with it.

jon