Éric Araujo mer...@netwok.org added the comment:
By the way, I wonder why this page is named “functions” and the one for
“builtins” is nearly empty.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10299
Georg Brandl ge...@python.org added the comment:
That's legacy from the good old latex days.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10299
___
Georg Brandl ge...@python.org added the comment:
Dividing the table in sections makes sense to me; it provides the kind of
grouping that is helpful sometimes, but cannot be kept when sorting
alphabetically. So when the table is grouped, the actual docs can remain
alphabetized.
--
Éric Araujo mer...@netwok.org added the comment:
Possible groups:
Types constructors: bool, bytearray, bytes, complex, dict, float, frozenset,
int, list, memoryview, object, range, set, slice, str, tuple
Mathematical functions: abs, bin, divmod, hex, oct, pow, round
Working with sequences:
Éric Araujo mer...@netwok.org added the comment:
In 2.7, the functions are not sorted alphabetically. I think they should, and
I offer to do the boring work.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10299
Ezio Melotti ezio.melo...@gmail.com added the comment:
The last 4 functions are Non-essential Built-in Functions[0] so I kept them
at the end of the list to match the order they have in the page.
[0]:
http://docs.python.org/library/functions.html#non-essential-built-in-functions
--
Éric Araujo mer...@netwok.org added the comment:
It’s fine to have them at the end of the page, but I think people want things
to be sorted in an index.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10299
Ezio Melotti ezio.melo...@gmail.com added the comment:
I don't think it's worth changing it. The table still provides a good overview,
and having them at the end won't prevent people to find their doc.
Both the table and the page could be divided in sections though, if we find a
way to group
Ezio Melotti ezio.melo...@gmail.com added the comment:
Committed in r86732 on py3k, will backport on 3.1/2.7 if Benjamin is OK with
that.
--
nosy: +benjamin.peterson
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10299
Benjamin Peterson benja...@python.org added the comment:
Okay.
2010/11/24 Ezio Melotti rep...@bugs.python.org:
Ezio Melotti ezio.melo...@gmail.com added the comment:
Committed in r86732 on py3k, will backport on 3.1/2.7 if Benjamin is OK with
that.
--
nosy: +benjamin.peterson
Ezio Melotti ezio.melo...@gmail.com added the comment:
Backported in r86735 (3.1) and r86736 (2.7).
--
resolution: - fixed
stage: patch review - committed/rejected
status: open - closed
___
Python tracker rep...@bugs.python.org
Éric Araujo mer...@netwok.org added the comment:
I like this version. HTML and LaTex build without warning; all-pdf takes
forever and spits out a metric ton of messages, so I haven’t checked its result.
The markup trickery is unfortunate, though, I’d like a pronouncement from Georg
about
Ezio Melotti ezio.melo...@gmail.com added the comment:
Here's a new patch with a 5 column tables. I had to use some rst trickery to
make a decent header that works both in the HTML and Latex outputs. I put the
title in the middle cell (the 3rd) of the header and left the others empty.
The
Éric Araujo mer...@netwok.org added the comment:
Using cell spanning breaks “make latex” (and thus PDF), you may want to rework
the reST table markup.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10299
Éric Araujo mer...@netwok.org added the comment:
+1 on the general idea. I applied the patch and built the documentation to see
what the output looks like: The hotlinks are here and work, that’s cool, but I
think the table wastes space. You could use five columns without damaging
usability
Éric Araujo mer...@netwok.org added the comment:
+1 on the general idea. I applied the patch and built the documentation to see
what the output looks like: The hotlinks are here and work, that’s cool, but I
think the table wastes space. You could use five columns without damaging
usability
Terry J. Reedy tjre...@udel.edu added the comment:
+1 from me on a table at the top of the functions page.
I am assuming that the markup will induce hotlinks.
The main problem I see is the need to hand rewrite when another function is
added
--
nosy: +terry.reedy
New submission from nestor nestornis...@gmail.com:
The built-in function page
(http://docs.python.org/dev/py3k/library/functions.html) is pretty long. Each
function has an anchor but unlike the built-in types section there is no quick
way to get an overview or jump to a specific function
Changes by Ezio Melotti ezio.melo...@gmail.com:
--
nosy: +ezio.melotti
stage: - needs patch
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10299
___
Ezio Melotti ezio.melo...@gmail.com added the comment:
The attached patch adds a 4-columns table that lists the functions without args.
--
assignee: d...@python - ezio.melotti
keywords: +patch
stage: needs patch - patch review
Added file: http://bugs.python.org/file19478/issue10299.diff
Changes by Fred L. Drake, Jr. fdr...@acm.org:
--
nosy: +fdrake
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10299
___
___
Python-bugs-list
21 matches
Mail list logo