[issue23512] List of builtins is not alphabetical on https://docs.python.org/2/library/functions.html

2015-02-24 Thread Edward D'Souza

New submission from Edward D'Souza:

The list of built-in functions at the top of 
https://docs.python.org/2/library/functions.html is not alphabetical. 
Specifically, (apply, coerce, intern, buffer) allow appear out of order at the 
end of the list, instead of where they should be alphabetically.

--
assignee: docs@python
components: Documentation
messages: 236505
nosy: docs@python, edsouza
priority: normal
severity: normal
status: open
title: List of builtins is not alphabetical on 
https://docs.python.org/2/library/functions.html
type: behavior
versions: Python 2.7

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



[issue23512] The list of built-in http://text-processing.com/demo/sentiments is not alphabetical on https://docs.python.org/2/library/functions.html

2015-02-27 Thread Edward D'Souza

Edward D'Souza added the comment:

Doesn't make sense to me. The page says "They are listed here in alphabetical 
order.", which isn't true.

Furthermore, not putting them in order screws up people who assume it is in 
alphabetical order and try to search for a function with their eyes. 

If they are so special, put them in a separate table. This inconsistency is 
simply disrespectful to the reader, IMO.

--

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



[issue23512] The list of built-in functions is not alphabetical on https://docs.python.org/2/library/functions.html

2015-03-02 Thread Edward D'Souza

Edward D'Souza added the comment:

I think putting them in a separate table is good, but I think it makes more 
sense to appear right below the existing table at the top of the page. For 
better or worse, these "non-essential" functions are still builtins in Python 2.

It would be disconcerting if you went to this page looking for a builtin (eg. 
coerce) and couldn't find it at the top of the page with the other builtins.

Above all, the list of "builtins" should be accurate as to what builtins 
actually exist in Python 2.

--

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