[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Changes by Raymond Hettinger : -- assignee: rhettinger -> ___ Python tracker ___

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Changes by Ezio Melotti : -- stage: needs patch -> patch review versions: +Python 3.6 ___ Python tracker ___

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Changes by Martin Panter vadmium...@gmail.com: -- nosy: +vadmium ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue16927 ___ ___ Python-bugs-list

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Nitika Agarwal added the comment: @Ezio Melotti Please see if this is what you wanted. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue16927 ___

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Terry J. Reedy added the comment: I think 'Builtin-in Types' should probably be 'Built-in Classes' as there is no longer any difference between types and classes. Note that after the unification, we added 'issubclass', not 'issubtype'. type should at least be listed under types/classes. The

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Raymond Hettinger added the comment: FWIW, I don't think we should separate built-in types from built-in functions. Tools like str(x) and int(x) are frequently used as if there were functions. Tools like iter(x) and open(x) could be viewed as constructors. Tools like type(x) are both a

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Changes by Raymond Hettinger raymond.hettin...@gmail.com: -- versions: -Python 2.7, Python 3.4 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue16927 ___

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Ezio Melotti added the comment: Tools like str(x) and int(x) are frequently used as if there were functions. The description of each object already mentions the function/type duality, and links to https://docs.python.org/3/library/stdtypes.html. If they are grouped together, a paragraph like

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Raymond Hettinger added the comment: This include two main groups that should be separated in two different sections: built-in types and functions. I forgot to mention that the docs have already been organized to cover the two groups. Section 3.2 has the built-in functions and Section 3.4

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Changes by Raymond Hettinger raymond.hettin...@gmail.com: -- assignee: ezio.melotti - rhettinger ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue16927 ___

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Raymond Hettinger added the comment: Nikita, your additional dispatch table looks like a reasonable addition. I'll wait on additional commentary before pushing it forward 1 should be especially useful to people that are new to the language Ezio, please take care not to conflate the role of

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Terry J. Reedy added the comment: I would be happy enough to just add a second index section, with short annotations or commentaries about the categories -- nitika's patch with sentences added. I would put it after the current table, and not box the links. Short example: The following

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Raymond Hettinger added the comment: Terry, I concur. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue16927 ___ ___ Python-bugs-list mailing list

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Éric Araujo added the comment: +Separate bulit-in types from functions and group similar functions +-- This should not be in the patch. (I made the same remark on another issue, please take reviews into account.) +Built-in Types

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Nitika Agarwal added the comment: Hi, I am attaching a new patch with some corrections which I got.Please help me where I am going wrong. -- Added file: http://bugs.python.org/file34507/issue16927.patch ___ Python tracker rep...@bugs.python.org

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Éric Araujo added the comment: Thanks, the markup for built-in types is better. (You added hash to that list, but it’s a function returning an int, not a type.) +Functions : +base conversion: :func:`bin`, :func:`oct`, :func:`hex` +attribute-related: :func:`getattr`, :func:`setattr`,

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Nitika Agarwal added the comment: I have added hash in functions under the heading : Math-Related -- Added file: http://bugs.python.org/file34508/issue16927_3.patch ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue16927

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Nitika Agarwal added the comment: Hi, Please review my patch attached. -- keywords: +patch Added file: http://bugs.python.org/file34506/issue16927_2.patch ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue16927

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Nitika Agarwal added the comment: Hello everyone, I am working on this issue to create a patch -- nosy: +nitika ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue16927 ___

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Terry J. Reedy added the comment: I like this idea, including the function subdivisions. I once suggested moving the classes into the later builtins chapter, but it was pointed out to me that a) they once *were* functions (no longer relevant); b) they are callables (very relevant); and hence

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

Chris Jerdonek added the comment: I admit that I'm used to the alphabetical listing, but I like the idea for this organization. In fact, it's similar to how the Built-in Types page is organized: grouped by similarity rather than listed alphabetically. Also just a note: strictly speaking

[issue16927] Separate built-in types from functions and group similar functions in functions.rst

New submission from Ezio Melotti: http://docs.python.org/3/library/functions.html currently lists all the builtin objects. This include two main groups that should be separated in two different sections: built-in types and functions. In addition, similar/related functions should be grouped