D-Programming-Language/phobos — pull request #969 by monarchdodra (2012-11-23 11:02:14+00:00)
Title: add dropExactly/popFrontExactly

You may want to review both commits individually:

* The first commit "consolidates" the `drop`-`dropFront`-`dropBack` and `popFrontN`-`popBackN` by merging their ddoc sections. This means users will not have to read the exact same documentation for similar functions.
* The second commit adds `popFrontExactly` and `dropExactly`, as well as `dropOne`

Notes:
* I chose `popFrontExactly` as opposed to `popFrontNExactly`, because, IMO, both derived from `popFront`: `popFrontExactly` and `popFrontN` are variations of each other. Also, it reads easier.
* I also added `dropOne`. It's convenient to have, and doesn't add much complexity (since there is no `popFrontOne`... That'd just be silly :D )

Please do not hesitate to point out even the slightest nitpicks.