partition docstring should be more explicit about dropped or partial trailing elements

Description

The doc for partition states "In case there are not enough padding elements, return a partition with less than n items." However, the behavior of this function is as follows:

Proposed: Proposed docstring update in bold:

Returns a lazy sequence of lists of n items each, at offsets step
apart. If step is not supplied, defaults to n, i.e. the partitions
do not overlap. **If a pad collection is not supplied, any tail elements
that remain from dividing the input collection length by n will not be
included in a partition.** If a pad collection is supplied, use its elements as
necessary to complete last partition upto n items. In case there are
not enough padding elements, return a partition with less than n items.

Patch: clj-1117.patch

Environment

OS X, 10.8

Assignee

Unassigned

Reporter

Timothy Baldridge

Labels

Approval

Triaged

Patch

Code

Affects versions

Priority

Minor
Configure