Zipeng Zhang <zhangzipeng0@xxxxxxxxxxx> writes: > Add an escape character to resolve the problem of > "--version" being displayed as "–version". > > Without such escaping, -- is rendered as – (en dash). > > Signed-off-by: Zipeng Zhang <zhangzipeng0@xxxxxxxxxxx> > --- > Documentation/process/changes.rst | 38 +++++++++++++++---------------- > 1 file changed, 19 insertions(+), 19 deletions(-) Thanks for working on improving the documentation! I understand where you are coming from, but this may be one of those cases where the readability of the plain-text documentation has to win out. Those backslashes are ugly and seem unlikely to be maintained going forward. The right solution, if it is possible, is to convince Sphinx to stop messing with "--" altogether. Substituting em-dashes is of limited cosmetic value and, I think, is something we could do without. Thanks, jon