diff --git a/doc/permutation_iterator.rst b/doc/permutation_iterator.rst
new file mode 100644
index 0000000..0c8070c
--- /dev/null
+++ b/doc/permutation_iterator.rst
@@ -0,0 +1,41 @@
+.. 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)
+
+++++++++++++++++++++++
+ 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, David Abrahams, Roland Richter, and Jeremy Siek 2003. 
+
+.. _`Boost Consulting`: http://www.boost-consulting.com
+.. _`Open Systems Lab`: http://www.osl.iu.edu
+
+:abstract:
+
+  .. include:: permutation_iter_abstract.rst
+
+.. contents:: Table of Contents
+
+
+Introduction
+============
+
+.. include:: permutation_iterator_body.rst
+
+
+Reference
+=========
+
+.. include:: permutation_iterator_ref.rst
+
+
+Example
+=======
+
+.. include:: permutation_iterator_eg.rst