Where would be a good place for test cases for an rst_escape() function? Docutils?<div><br></div><div><a href="https://github.com/westurner/dotfiles/blob/develop/scripts/git-changelog.py">https://github.com/westurner/dotfiles/blob/develop/scripts/git-changelog.py</a></div><div><br></div><div>- rst_escape # YMMV</div><div>- $ <span style="max-height:999999px;color:rgb(34,34,34);font-family:Roboto-Regular,HelveticaNeue,Arial,sans-serif;font-size:14px">git</span><span style="color:rgb(34,34,34);font-family:Roboto-Regular,HelveticaNeue,Arial,sans-serif;font-size:14px">-</span><span style="max-height:999999px;color:rgb(34,34,34);font-family:Roboto-Regular,HelveticaNeue,Arial,sans-serif;font-size:14px">changelog</span><span style="color:rgb(34,34,34);font-family:Roboto-Regular,HelveticaNeue,Arial,sans-serif;font-size:14px">.py -r "release/0.3.14" --hdr= "+"` </span><br><br>On Monday, May 1, 2017, Nick Coghlan <<a href="mailto:ncoghlan@gmail.com">ncoghlan@gmail.com</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 1 May 2017 at 17:13, Martin Panter <<a href="javascript:;" onclick="_e(event, 'cvml', 'vadmium+py@gmail.com')">vadmium+py@gmail.com</a>> wrote:<br>
> On 1 May 2017 at 06:37, Nick Coghlan <<a href="javascript:;" onclick="_e(event, 'cvml', 'ncoghlan@gmail.com')">ncoghlan@gmail.com</a>> wrote:<br>
>> Hi folks,<br>
>><br>
>> I'm trying to write a NEWS entry that explains that the<br>
>> ":func:`bytes`" cross-references have changed to refer to the type<br>
>> descriptions by default (matching other builtin container types), so<br>
>> you now need to use ``:ref:`func-bytes`" to refer to the old target in<br>
>> the list of builtin functions (if you really want that for some<br>
>> reason).<br>
>><br>
>> Unfortunately, my first two attempts both cause warnings in "make<br>
>> suspicious" with the following output:<br>
><br>
> What is the full output? Usually it includes instructions to add false<br>
> positives to Doc/tools/susp-ignored.csv; maybe that is all you have to<br>
> do?<br>
<br>
You're right, that would be likely be the way to go if I decided to<br>
keep the escaped markup.<br>
<br>
However...<br>
<br>
>> My fallback plan is to just include the unescaped markup in the NEWS<br>
>> entry (rather than trying to make it readable even in rendered form),<br>
>> but I figured I'd ask for advice here first.<br>
><br>
> I thought the NEWS file was mainly regarded as plain text, so it would<br>
> be important to avoid ugly RST markup like backslashes if possible.<br>
<br>
... I think you're right on this point, so it makes more sense to skip<br>
the escaping entirely,<br>
and just use the correct link markup in the NEWS entry.</blockquote><div>How convenient.</div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Cheers,<br>
Nick.<br>
<br>
--<br>
Nick Coghlan   |   <a href="javascript:;" onclick="_e(event, 'cvml', 'ncoghlan@gmail.com')">ncoghlan@gmail.com</a>   |   Brisbane, Australia<br>
______________________________<wbr>_________________<br>
Python-Dev mailing list<br>
<a href="javascript:;" onclick="_e(event, 'cvml', 'Python-Dev@python.org')">Python-Dev@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/python-dev" target="_blank">https://mail.python.org/<wbr>mailman/listinfo/python-dev</a><br>
Unsubscribe: <a href="https://mail.python.org/mailman/options/python-dev/wes.turner%40gmail.com" target="_blank">https://mail.python.org/<wbr>mailman/options/python-dev/<wbr>wes.turner%40gmail.com</a><br>
</blockquote></div>