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

Randy Dunlap <[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]>

On 8/12/26 6:15 AM, Jonathan Corbet wrote:
> 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.

Agreed, let's not change the filename.

-- 
~Randy
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.