-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Am 16.03.2010 23:59, schrieb Max Battcher: > 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``.
Or, with the dedicated markup :option:`--version`. Georg -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.14 (GNU/Linux) iEYEARECAAYFAku62ckACgkQN9GcIYhpnLAWkACeNTAdANQR0MGp4cRQSKKpz261 u1wAniV3aeE7KXW9VVPs4gPN0z+bbV+w =xon5 -----END PGP SIGNATURE----- -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
