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

[Adam T. <aa-...@us...>]

> Will windows ask what to do with .rst files

Yes, if you double click on the file it will open a pop-up asking what application you want to use to edit the files, and then you can select 'notepad' (preinstalled) or any other text editor. Windows can then remember the file association.

>  removng rst2html.py ... might be hard for people running the same script for 10 years

I do understand entirely -- any change is by its very nature breaking fron the status quo ante.

The latest patch I proposed though has no breaking changes (keeps `rst2html.py` etc), but less of the enhancements.

Can I take it that you'd support this change @grubert? (Trying to forge consensus!)

A

P.S. I have added an image of the file association pop-up box, as it is on my Windows 10 PC.


Attachments:

- [rst-file-assoc-popup.PNG](https://sourceforge.net/p/docutils/patches/_discuss/thread/c8407ba766/de6f/attachment/rst-file-assoc-popup.PNG) (30.6 kB; image/png)


---

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

**Status:** open
**Group:** None
**Created:** Wed Jan 05, 2022 05:51 PM UTC by Adam  Turner
**Last Updated:** Thu Jan 06, 2022 12:39 PM UTC
**Owner:** nobody


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 doc...@li... 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.