Currently Python documentation uses four type of dashes for same meaning: 1. Hyphen with spaces. 2. En-dash with spaces. 3. Em-dash with spaces. 4. Em-dash without spaces. Definitely the first case is just wrong and other three cases should be unified. Here is a patch which replaces spaced hyphens, en-dashes and em-dashes to em-dashes without spaces. See also a discussion at Python-Dev: http://mail.python.org/pipermail/python-dev/2013-July/thread.html#127420http://comments.gmane.org/gmane.comp.python.devel/140593
This looks like the kind of high-churn, low-benefit patches that we typically encourage new contributors not to do. It’s fine to update dashes when modifying the surrounding text for another fix, and it may be useful to encourage using them in the markup docs, but not to do one big change.