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

[Éric Araujo]

É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 :
+dict(), int(), str(), list(), tuple(), bytes(), set(),
+frozenset(), memoryview(), range()

These should use proper markup like :func:`dict` so that links get generated and specific style is applied.  See docs.python.org/devguide/documenting.html for info about the markup we use.

+Functions : 
+base conversion
+attribute-related
+math-related
+string-related
+IO
[etc.]

What Ezio meant was a reordering of the whole document.  For example, a new heading (see the doc about markup) named “Math functions” and after it, the existing docs for abs, pow, round and divmod.  Does that make the intent of this bug report clearer?

(Ezio also listed hash in the math functions, but it’s more related to dicts and sets than math itself.  Making a patch also implies giving your opinion on the proposed changes; an idea written by a core developer is not always perfect :)

----------
versions: +Python 3.5 -Python 3.2, Python 3.3

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16927>
_______________________________________