Message 111561 - Python tracker

Message111561

Author	terry.reedy
Recipients	belopolsky, ezio.melotti, georg.brandl, lvogt, rhettinger, terry.reedy
Date	2010-07-25.22:01:56
SpamBayes Score	0.051758673
Marked as misclassified	No
Message-id	<1280095319.31.0.560347593732.issue7447@psf.upfronthosting.co.za>
In-reply-to

Content
Leonard, that you for the patch, in particular, the list of hints. I think the first is good but overly specific. It also has an extra '.itertools' in the path. Now: ''' + - To concatenate a list of lists ``lol`` use ``list(itertools.chain.from_iterable(lol))`` + (see :func:`from_iterable <itertools.itertools.chain.from_iterable>`). ''' How about instead" ''' + - To concatenate an iterable of iterables, such as a list of lists, + see :func:`from_iterable <itertools.chain.from_iterable>` + and call the appropriate constructor on the result, such as :class: `list`. ''' ?

Content

Leonard, that you for the patch, in particular, the list of hints. I think the first is good but overly specific. It also has an extra '.itertools' in the path. Now:

'''
+      - To concatenate a list of lists ``lol`` use ``list(itertools.chain.from_iterable(lol))``
+        (see :func:`from_iterable <itertools.itertools.chain.from_iterable>`).
'''

How about instead"
'''
+      - To concatenate an iterable of iterables, such as a list of lists,
+        see :func:`from_iterable <itertools.chain.from_iterable>`
+        and call the appropriate constructor on the result, such as :class: `list`.
'''
?

History
Date	User	Action	Args
2010-07-25 22:01:59	terry.reedy	set	recipients: + terry.reedy, georg.brandl, rhettinger, belopolsky, ezio.melotti, lvogt
2010-07-25 22:01:59	terry.reedy	set	messageid: <1280095319.31.0.560347593732.issue7447@psf.upfronthosting.co.za>
2010-07-25 22:01:57	terry.reedy	link	issue7447 messages
2010-07-25 22:01:56	terry.reedy	create