Doc-SIG

Download

doc-sig@python.org

May 2010

6 participants
2 discussions

Library: generic OS services chapter
by A.M. Kuchling May 19, 2010

May 19, 2010

Random thoughts on the Generic Operating System Services chapter of the library guide: http://docs.python.org/dev/library/allos.html * There are four sections that are very long and complex, nesting down to four levels: argparse, optparse, logging, and ctypes. Should any of them become chapters of their own? logging and ctypes seem like the most plausible ones to move. We could move argparse/optparse/getopt into a chapter by themselves, but that wouldn't reduce the nesting depth at all. * The usual rationale for the ordering is from more widely used modules to more esoteric or little-used. Should we therefore move optparse to follow getopt instead of preceding it? * I thought we were going to add a warning to the optparse docs suggesting people use argparse instead. Shall I go ahead and write that, or was it decided to not do that? --amk

2 1

Question about SequenceMatcher.quick_ratio
by INADA Naoki May 11, 2010

May 11, 2010

Hi, all. I am one of translator of Python document. But I am not good at English well. I can't understand one sentence in: http://docs.python.org/library/difflib.html#difflib.SequenceMatcher.quick_r… > This isn’t defined beyond that it is an upper bound on ratio(), and is faster to compute. I see that quick_ratio() calculates upper bound of ratio(). But I can't get what "this isn't defined beyond that" means. May someone explain this in easy sentence for me? -- INADA Naoki <songofacandy(a)gmail.com>

4 6