1 files changed, 11 insertions, 3 deletions
diff --git a/src/algo_factory/algo_factory.h b/src/algo_factory/algo_factory.h
index 92653ab66..881194f0c 100644
--- a/src/algo_factory/algo_factory.h
+++ b/src/algo_factory/algo_factory.h
@@ -1,4 +1,4 @@
-/**
+/*
 * Algorithm Factory
 * (C) 2008 Jack Lloyd
 *
@@ -154,13 +154,21 @@ class BOTAN_DLL Algorithm_Factory
       void add_mac(MessageAuthenticationCode* algo,
                    const std::string& provider);
 
-      /*
-      * Deprecated
+      /**
+      * An iterator for the engines in this factory
+      * @deprecated
       */
       class BOTAN_DLL Engine_Iterator
          {
          public:
+            /**
+            * @return next engine in the sequence
+            */
             class Engine* next() { return af.get_engine_n(n++); }
+
+            /**
+            * @param a an algorithm factory
+            */
             Engine_Iterator(const Algorithm_Factory& a) : af(a) { n = 0; }
          private:
             const Algorithm_Factory& af;