factoring the specialized iterator adaptors

[SVN r19467]

doc/permutation_iterator.rst

@@ -0,0 +1,31 @@
+++++++++++++++++++++++
+ Permutation Iterator
+++++++++++++++++++++++
+
+:Author: Toon Knapen, David Abrahams, Roland Richter, Jeremy Siek
+:Contact: dave@boost-consulting.com, jsiek@osl.iu.edu
+:organization: `Boost Consulting`_, Indiana University `Open Systems
+               Lab`_
+:date: $Date$
+:copyright: Copyright Toon Knapen, Dave Abrahams, Roland Richter, and Jeremy Siek 2003. All rights reserved
+
+.. _`Boost Consulting`: http://www.boost-consulting.com
+.. _`Open Systems Lab`: http://www.osl.iu.edu
+
+:abstract:
+
+.. include:: permutation_iterator_abstract.rst
+
+.. contents:: Table of Contents
+
+
+Introduction
+============
+
+.. include:: permutation_iterator_body.rst
+
+
+Reference
+=========
+
+.. include:: permutation_iterator_ref.rst