[issue28763] Use en-dashes for ranges in docs

[Roundup Robot]

Roundup Robot added the comment:

New changeset 77307437ae15 by Serhiy Storchaka in branch '3.5':
Issue #28763: Use double hyphens (rendered as en-dashes) in numerical ranges
https://hg.python.org/cpython/rev/77307437ae15

New changeset 59bd48afa1bc by Serhiy Storchaka in branch '2.7':
Issue #28763: Use double hyphens (rendered as en-dashes) in numerical ranges
https://hg.python.org/cpython/rev/59bd48afa1bc

New changeset 3434d84efdd4 by Serhiy Storchaka in branch '3.6':
Issue #28763: Use double hyphens (rendered as en-dashes) in numerical ranges
https://hg.python.org/cpython/rev/3434d84efdd4

New changeset dc407f50e823 by Serhiy Storchaka in branch 'default':
Issue #28763: Use double hyphens (rendered as en-dashes) in numerical ranges
https://hg.python.org/cpython/rev/dc407f50e823

--
nosy: +python-dev

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Serhiy Storchaka]

Serhiy Storchaka added the comment:

Thanks Terry.

--
resolution:  -> fixed
stage: commit review -> resolved
status: open -> closed
versions: +Python 2.7, Python 3.5, Python 3.6, Python 3.7

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Terry J. Reedy]

Terry J. Reedy added the comment:

I checked the patch with Rietveld and all the changes are '-' to '--' in 
numeric ranges in text. LGTM.

--
nosy: +terry.reedy
stage:  -> commit review

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Mark Dickinson]

Mark Dickinson added the comment:

> I read this recommendation in many books about TeX, and also in other 
> typographic resources.

Same here. I'd add Apple's Style Guide and the Chicago Manual of Style to that 
list.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Serhiy Storchaka]

Serhiy Storchaka added the comment:

Sorry, yes, I meant en-dashes of course. I read this recommendation in many 
books about TeX, and also in other typographic resources. In modern fonts a 
hyphen-minus (U+002D) is shorter than digits in modern fonts and is placed 
lower than the middle of digits. An en-dash (U+2013) has the same width as 
digits and is placed higher, at the middle of digit's height.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Martin Panter]

Martin Panter added the comment:

My Australian Style Manual says to use en rules for spans of figures etc. 
Wikipedia mentions some other guides: 
; apparently some prefer 
the hyphen. That is why I said it is a style issue, not a black and white thing.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Mark Dickinson]

Mark Dickinson added the comment:

> Did you mean en-dash rather than em-dash?

Ah, judging by the title and the patch, you did. :-) Phew!

Now I can delete the long post I had citing multiple sources for using 
en-dashes (not em-dashes) for numeric ranges...

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Mark Dickinson]

Mark Dickinson added the comment:

> It is recommended to use an em-dash instead of a hyphen for numerical ranges.

Who makes that recommendation? Did you mean en-dash rather than em-dash?

--
nosy: +mark.dickinson

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Martin Panter]

Martin Panter added the comment:

Sure, I was just saying that for whatever reason, 50% of the documentation uses 
hyphens for number ranges, and 50% uses en dashes.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Serhiy Storchaka]

Serhiy Storchaka added the comment:

The rest single hyphens between digits are meaningful hypens in iso-8859-1, 
ISDNs, sample outputs, etc.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Martin Panter]

Martin Panter added the comment:

Personally I prefer en dashes where practical, but I fear the change may 
conflict with other people’s styles and preferences. I quickly counted 22 
single hyphens (obviously I missed a few that your patch caught) and also 22 
existing en dashes.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Serhiy Storchaka]

Serhiy Storchaka added the comment:

Some of these double hyphens are in code examples. Thus the actual number of 
en-dashes that can be changed to em-dashes is smaller.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Serhiy Storchaka]

Serhiy Storchaka added the comment:

353 en-dashes with spaces.
479 em-dashes with spaces.
89 em-dashes without spaces.

And some number of hyphens with spaces. It is hard to automatically distinguish 
them from minuses in code examples, but in issue18529 I provided large patches 
that converted all of them to dashes.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Ezio Melotti]

Ezio Melotti added the comment:

While you are at it, have you checked how many en-dashes have been used instead 
of em-dashes?  "--" is commonly used to indicate em-dashes (e.g. in emails), 
but in rst it renders to an en-dash.

--
nosy: +ezio.melotti

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue28763] Use en-dashes for ranges in docs

[Serhiy Storchaka]

New submission from Serhiy Storchaka:

It is recommended to use an em-dash instead of a hyphen for numerical ranges. 
It looks better in the rendered document. Python documentation already use it, 
but not always. Proposed patch adds more en-dashes.

--
assignee: docs@python
components: Documentation
files: docs-en-dash.patch
keywords: patch
messages: 281347
nosy: docs@python, martin.panter, serhiy.storchaka
priority: normal
severity: normal
status: open
title: Use en-dashes for ranges in docs
type: enhancement
Added file: http://bugs.python.org/file45584/docs-en-dash.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com