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? >