This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author eric.araujo
Recipients chris.jerdonek, eric.araujo, ezio.melotti, nitika, terry.reedy
Date 2014-03-19.06:29:12
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1395210552.55.0.508635107321.issue16927@psf.upfronthosting.co.za>
In-reply-to
Content
+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 :)
History
Date User Action Args
2014-03-19 06:29:12eric.araujosetrecipients: + eric.araujo, terry.reedy, ezio.melotti, chris.jerdonek, nitika
2014-03-19 06:29:12eric.araujosetmessageid: <1395210552.55.0.508635107321.issue16927@psf.upfronthosting.co.za>
2014-03-19 06:29:12eric.araujolinkissue16927 messages
2014-03-19 06:29:12eric.araujocreate