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

Jonathan Corbet <[email protected]>
Newsgroups org.kernel.vger.workflows,dev.linux.lists.llvm,org.kernel.vger.bpf,org.kernel.vger.linux-doc,org.kernel.vger.linux-kernel,org.kernel.vger.rust-for-linux
Message-ID <[email protected]>
Manuel Ebner <[email protected]> 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 <[email protected]>
> ---
>  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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.