From 72a95cc7b0ff2909b552e76ed409500f385d0258 Mon Sep 17 00:00:00 2001 From: Raymond Hettinger Date: Wed, 25 Feb 2009 22:51:40 +0000 Subject: Sync-up 3.1 docs with 2.7 for collections.Counter(). --- Doc/library/collections.rst | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst index 4b3bbe9..c28704b 100644 --- a/Doc/library/collections.rst +++ b/Doc/library/collections.rst @@ -236,13 +236,12 @@ Common patterns for working with :class:`Counter` objects:: c.most_common()[:-n:-1] # n least common elements c += Counter() # remove zero and negative counts -Several multiset mathematical operations are provided for combining -:class:`Counter` objects. Multisets are like regular sets but are allowed to -contain repeated elements (with counts of one or more). Addition and -subtraction combine counters by adding or subtracting the counts of -corresponding elements. Intersection and union return the minimum and maximum -of corresponding counts. Each operation can accept inputs with signed counts, -but the output excludes results with counts less than one. +Several mathematical operations are provided for combining :class:`Counter` +objects to produce multisets (counters that have counts greater than zero). +Addition and subtraction combine counters by adding or subtracting the counts +of corresponding elements. Intersection and union return the minimum and +maximum of corresponding counts. Each operation can accept inputs with signed +counts, but the output will exclude results with counts of zero or less. >>> c = Counter(a=3, b=1) >>> d = Counter(a=1, b=2) -- cgit v0.12