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

engelbert gruber via Docutils-develop <[email protected]> Tue, 13 Aug 2024 11:02:45 -0000
Newsgroups gmane.text.docutils.devel
Message-ID </p/docutils/patches/187/CAHnbgBOGR5+4xVt7TmHnTJpbz0AkyDtNmwxUkhZURXXHHz-tqw@mail.gmail.com>
nut i would only apply on svn ... might be not what's wanted

On Tue, 13 Aug 2024 at 12:43, engelbert gruber <
[email protected]> wrote:

> i could apply the rename this week ... nag me
>
> On Tue, 13 Aug 2024 at 12:42, engelbert gruber <
> [email protected]> wrote:
>
>> infrastructure docutils-update.local should prefer .rst but falls back on
>> .txt
>>
>> ./docs/user/Makefile.docutils-update
>>
>>   has fixed filenames but is only one file
>>
>>
>>
>> On Sun, 11 Aug 2024 at 13:57, engelbert gruber <
>> [email protected]> wrote:
>>
>>> sandbox/infrastructure/docutils-update.local errors will pop up when
>>> run , no problem to me
>>>
>>> On Fri, 9 Aug 2024 at 11:35, Günter Milde [email protected]
>>> wrote:
>>>
>>> We would need to adapt background scripts, too. I am unsure whether the
>>> following changes correctly describe the behaviour after applying this
>>> patch :
>>>
>>> --- a/sandbox/infrastructure/docutils-update.local+++
>>> b/sandbox/infrastructure/docutils-update.local@@ -14,10 +14,10 @@ # #
>>> ATTENTION #-# Any .html document with a corresponding .txt file is
>>> regenerated -# if the .txt has changed, but no new .html files will be
>>> generated.+# Any .html document with a corresponding .rst file is
>>> regenerated +# if the .rst has changed, but no new .html files will be
>>> generated. #-# * Funny thing: sf hides README.txt files.+# * Funny thing:
>>> sf hides README.rst files. # # ATTENTION
>>>
>>> I downloaded the patch set and tried to commit it to a local branch but
>>> failed:
>>>
>>> milde@heinz:/usr/local/src/docutils-git-svn/docutils/docutils > git am
>>> -3 /tmp/17.patch Applying: Rename all .txt files to .rstApplying: Update
>>> references to .txt filesUsing index info to reconstruct a base tree...M
>>> docutils/test/test_utils/test__init__.py.git/rebase-apply/patch:7937:
>>> trailing whitespace.# Any .html document with a corresponding .rst file is
>>> regenerated error: patch failed: docutils/docs/ref/rst/history.rst:1error:
>>> docutils/docs/ref/rst/history.rst: patch does not applyerror: Did you hand
>>> edit your patch?It does not apply to blobs recorded in its index.Patch
>>> failed at 0002 Update references to .txt fileshint: Use 'git am
>>> --show-current-patch=diff' to see the failed patchWhen you have resolved
>>> this problem, run "git am --continue".If you prefer to skip this patch, run
>>> "git am --skip" instead.To restore the original branch and stop patching,
>>> run "git am --abort".
>>> ------------------------------
>>>
>>>
>>> *[patches:#187] <https://sourceforge.net/p/docutils/patches/187/>
>>> https://sourceforge.net/p/docutils/patches/187/
>>> <https://sourceforge.net/p/docutils/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:* Fri Aug 09, 2024 05:12 AM 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 you indicated interest in
>>> https://sourceforge.net/p/docutils/patches/187/
>>>
>>> To unsubscribe from further messages, please visit
>>> https://sourceforge.net/auth/subscriptions/
>>>
>>> ------------------------------
>>>
>>> *[patches:#187] <https://sourceforge.net/p/docutils/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:* Fri Aug 09, 2024 09:35 AM 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 you indicated interest in
>>> https://sourceforge.net/p/docutils/patches/187/
>>>
>>> To unsubscribe from further messages, please visit
>>> https://sourceforge.net/auth/subscriptions/
>>>
>>



---

**[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:** Fri Aug 09, 2024 09:35 AM 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.