René Dudfield wrote:
It's a short description of the function - not so much a long winded one.
It's still *far* longer than I want to see *every* time the function is so much as mentioned, though!
perhaps add a title attribute to the link (which would give the description on hover over the link).
+1. That would be a excellent solution. [Reading the current pygame docs always makes me think of a passage from Terry Pratchett's "Pyramids", where a young, inexperienced pharaoh is hold a court session, and a court official is "interpreting" the naive things he says. Every time the official mentions the pharaoh's name, he uses his full official title, which is about five lines long. This happens several times in each paragraph. It makes for extremely funny comic fantasy, but it's not the best way to write documentation, IMO!] -- Greg
