Squashed 'third_party/boostorg/iterator/' content from commit b2adecb
Change-Id: I284a73816f9cc846742923879275b84c6e0c915c
git-subtree-dir: third_party/boostorg/iterator
git-subtree-split: b2adecb951af025698618f19a3c838bd314966dc
diff --git a/doc/counting_iterator.rst b/doc/counting_iterator.rst
new file mode 100644
index 0000000..ff7da3c
--- /dev/null
+++ b/doc/counting_iterator.rst
@@ -0,0 +1,43 @@
+.. Distributed under the Boost
+.. Software License, Version 1.0. (See accompanying
+.. file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+
++++++++++++++++++++
+ Counting Iterator
++++++++++++++++++++
+
+:Author: David Abrahams, Jeremy Siek, Thomas Witt
+:Contact: dave@boost-consulting.com, jsiek@osl.iu.edu, witt@ive.uni-hannover.de
+:organization: `Boost Consulting`_, Indiana University `Open Systems
+ Lab`_, University of Hanover `Institute for Transport
+ Railway Operation and Construction`_
+:date: $Date$
+:copyright: Copyright David Abrahams, Jeremy Siek, and Thomas Witt 2003.
+
+.. _`Boost Consulting`: http://www.boost-consulting.com
+.. _`Open Systems Lab`: http://www.osl.iu.edu
+.. _`Institute for Transport Railway Operation and Construction`: http://www.ive.uni-hannover.de
+
+:abstract: How would you fill up a vector with the numbers zero
+ through one hundred using ``std::copy()``? The only iterator
+ operation missing from builtin integer types is an
+ ``operator*()`` that returns the current value of the integer.
+ The counting iterator adaptor adds this crucial piece of
+ functionality to whatever type it wraps. One can use the
+ counting iterator adaptor not only with integer types, but with
+ any incrementable type.
+
+ .. include:: counting_iterator_abstract.rst
+
+.. contents:: Table of Contents
+
+``counting_iterator`` synopsis
+..............................
+
+.. include:: counting_iterator_ref.rst
+.. include:: make_counting_iterator.rst
+
+.. include:: counting_iterator_eg.rst
+
+.. _iterator-category: iterator_facade.html#iterator-category
+.. |iterator-category| replace:: *iterator-category*