[issue12874] Rearrange descriptions of builtin types in the Library reference

2011-08-31 Thread Nick Coghlan
Changes by Nick Coghlan ncogh...@gmail.com: -- title: Rearrange descriptions of builtin types - Rearrange descriptions of builtin types in the Library reference ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue12874

[issue12874] Rearrange descriptions of builtin types in the Library reference

2011-08-31 Thread Nick Coghlan
Changes by Nick Coghlan ncogh...@gmail.com: -- stage: - needs patch ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue12874 ___ ___ Python-bugs-list

[issue12874] Rearrange descriptions of builtin types in the Library reference

2011-08-31 Thread Nick Coghlan
Nick Coghlan ncogh...@gmail.com added the comment: Better titles for the proposed new sections: 4.7 Text Data - str 4.8 Binary Data - bytes, bytearray, memoryview -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue12874

[issue12874] Rearrange descriptions of builtin types in the Library reference

2011-08-31 Thread Guido van Rossum
Guido van Rossum gu...@python.org added the comment: I agree on the subdivision, but I think they should still be grouped together somehow, since these all really *do* share some interfaces: __getitem__ (with slicing), __iter__, __len__, at least; arguably __contains__; probably some others

[issue12874] Rearrange descriptions of builtin types in the Library reference

2011-08-31 Thread Nick Coghlan
Nick Coghlan ncogh...@gmail.com added the comment: Putting the new sections on tier 2 makes a big difference in discoverability, since that's the lowest level the main ToC page shows. Perhaps just including the phrase Sequence Type in the new section titles would provide enough logical

[issue12874] Rearrange descriptions of builtin types in the Library reference

2011-08-31 Thread Guido van Rossum
Guido van Rossum gu...@python.org added the comment: That sounds fine. Or list most of them at tier 2: 4.6 Sequence Types - list, tuple, range, str, bytes and friends 4.6.1 Sequence containers - list, tuple, range 4.6.2 Text Sequence Type - str 4.6.3 Binary Data Sequence Types - bytes,

[issue12874] Rearrange descriptions of builtin types in the Library reference

2011-08-31 Thread Nick Coghlan
Nick Coghlan ncogh...@gmail.com added the comment: 'Sequence Types - list, tuple, str, bytes, etc' *might* work, but I think part of the problem is that str's brevity is actually a downside in this case. I know I missed it when I was scanning the ToC earlier (I wanted to check if the internal

[issue12874] Rearrange descriptions of builtin types in the Library reference

2011-08-31 Thread Guido van Rossum
Guido van Rossum gu...@python.org added the comment: How about list, tuple, text and binary strings ? -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue12874 ___

[issue12874] Rearrange descriptions of builtin types in the Library reference

2011-08-31 Thread Ezio Melotti
Ezio Melotti ezio.melo...@gmail.com added the comment: I believe this is a duplicate of #4966. -- nosy: +ezio.melotti resolution: - duplicate stage: needs patch - committed/rejected status: open - closed ___ Python tracker rep...@bugs.python.org