Re: [Python-Dev] Escaping docs markup in NEWS entries?

2017-05-02 Thread Wes Turner
On Tue, May 2, 2017 at 1:58 PM, David Goodger wrote: > On Mon, May 1, 2017 at 5:03 AM, Wes Turner wrote: > > Where would be a good place for test cases for an rst_escape() function? > > Docutils? > > > >

Re: [Python-Dev] Escaping docs markup in NEWS entries?

2017-05-02 Thread David Goodger
On Mon, May 1, 2017 at 5:03 AM, Wes Turner wrote: > Where would be a good place for test cases for an rst_escape() function? > Docutils? > > https://github.com/westurner/dotfiles/blob/develop/scripts/git-changelog.py I'd say that the test cases for any function should

Re: [Python-Dev] Escaping docs markup in NEWS entries?

2017-05-01 Thread Wes Turner
Where would be a good place for test cases for an rst_escape() function? Docutils? https://github.com/westurner/dotfiles/blob/develop/scripts/git-changelog.py - rst_escape # YMMV - $ git-changelog.py -r "release/0.3.14" --hdr= "+"` On Monday, May 1, 2017, Nick Coghlan

Re: [Python-Dev] Escaping docs markup in NEWS entries?

2017-05-01 Thread Nick Coghlan
On 1 May 2017 at 17:13, Martin Panter wrote: > On 1 May 2017 at 06:37, Nick Coghlan wrote: >> Hi folks, >> >> I'm trying to write a NEWS entry that explains that the >> ":func:`bytes`" cross-references have changed to refer to the type >> descriptions by

Re: [Python-Dev] Escaping docs markup in NEWS entries?

2017-05-01 Thread Martin Panter
On 1 May 2017 at 06:37, Nick Coghlan wrote: > Hi folks, > > I'm trying to write a NEWS entry that explains that the > ":func:`bytes`" cross-references have changed to refer to the type > descriptions by default (matching other builtin container types), so > you now need to use

[Python-Dev] Escaping docs markup in NEWS entries?

2017-05-01 Thread Nick Coghlan
Hi folks, I'm trying to write a NEWS entry that explains that the ":func:`bytes`" cross-references have changed to refer to the type descriptions by default (matching other builtin container types), so you now need to use ``:ref:`func-bytes`" to refer to the old target in the list of builtin