[Python-apps-team] Bug#805756: mercurial-git: double : in /usr/share/doc/mercurial-git/README.Debian

[txt.file]

Good to know and thanks for explaining.

I think this would help. As it is neither from the file name ending nor
from the content obvious that this file could be reST.

On 22/11/15 06:23, Ben Finney wrote:
> On 22-Nov-2015, Vieno Foo wrote:
>>    * What led up to the situation?
>> less /usr/share/doc/mercurial-git/README.Debian
>>
>>    * What was the outcome of this action?
>> see a "::" at the end of line 4
>>
>>    * What outcome did you expect instead?
>> see only one : at the lines end
> 
> That's not an error. The file is marked up as reStructuredText, and
> the ‘::’ at end of a paragraph introduces a block of literal text.
> 
> I'm tempted to change this bug report to request the ‘README.Debian’
> file state explicitly that it uses reST markup, perhaps via a reST
> comment at the end.
> 
> Vieno Foo, do you think that would be a good resolution to this bug
> report?
>