[docutils:patches] #187 Rename .txt files to .rst

Adam Turner via Docutils-develop <[email protected]> Fri, 09 Aug 2024 05:12:17 -0000
Newsgroups gmane.text.docutils.devel
Message-ID </p/docutils/patches/187/9c331f00c400fb8dbe0ad504ad8c934d07cfece4.patches@docutils.p.sourceforge.net>
I have recreated the branch/patch for the rename, please have a look:

* https://github.com/AA-Turner/docutils/pull/17
* https://github.com/AA-Turner/docutils/pull/17.patch

All `.txt` files in docutils/, web/, and sandbox/infrastructure/ have been renamed. 

Writer template files remain unchanged.

A


---

**[patches:#187] Rename .txt files to .rst**

**Status:** pending-remind
**Group:** None
**Created:** Wed Jan 05, 2022 05:51 PM UTC by Adam  Turner
**Last Updated:** Thu Aug 08, 2024 07:37 PM UTC
**Owner:** Adam  Turner


This change is in two parts -- the first commit does the rename and the second goes through and updates references to .txt files. All tests pass.

The benefit of this change is primarily for people -- on user interfaces with syntax highlighting (e.g. IntelliJ / VSCode / Notepad++ editors, code mirrors, etc), the text is presented natively as reStructuredText, and editor features can assist with e.g. autocompletion.

Docutils itself of course does not care which file extension is used. 

I have not renamed any of the include files or template files in `docutils.parsers` or `docutils.writers`, as they form part of the public API and would need a deprecation cycle (or aliasing in the parsing code)

A

Please see https://github.com/AA-Turner/docutils/pull/3 and https://github.com/AA-Turner/docutils/pull/3.patch for the commits and patch.


---

Sent from sourceforge.net because [email protected] is subscribed to https://sourceforge.net/p/docutils/patches/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/patches/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.