E.R. Uber wrote:
When discussing long command line options like --version
they seem to be rendered in HTML with a single hyphen as in

    -version

In source code markup they are rendered as desired (--version).

What is the trick to get them to be rendered with a double hyphen?

That is smartypants attempting to make your text typographically nicer (the -- is converted to an "en dash", which is more appropriate than a normal hyphen in some cases).

As you noticed, smartypants shouldn't touch "literal" sections (such as source code). (Although there are buggy, common versions of smartypants out there that mistakenly do, and if that was your problem it is a simple matter of upgrading.)

The best way to deal with this particular instance is to use an inline reST literal, which would be to quote the command line option in double-backquotes as in ``--version``.

--
--Max Battcher--
http://worldmaker.net

--
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-...@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to