More descriptive, doxygen-ed comments

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@165512 91177308-0d34-0410-b5e6-96231b3b80d8

diff --git a/include/llvm/User.h b/include/llvm/User.h
index 8b1895d4698839ee63cab1ce9643e69fc9315210..ade3676260bfc0e342ac4ab9b42565cdb91b90cc 100644 (file)
--- a/include/llvm/User.h
+++ b/include/llvm/User.h
@@ -118,6 +118,8 @@ public:
   inline op_iterator       op_end()         { return OperandList+NumOperands; }
   inline const_op_iterator op_end()   const { return OperandList+NumOperands; }
 
+  /// Convenience iterator for directly iterating over the Values in the
+  /// OperandList
   class value_op_iterator : public std::iterator<std::forward_iterator_tag,
                                                  Value*> {
     op_iterator OI;
@@ -131,7 +133,7 @@ public:
       return !operator==(x);
     }
 
-    // Iterator traversal: forward iteration only
+    /// Iterator traversal: forward iteration only
     value_op_iterator &operator++() {          // Preincrement
       ++OI;
       return *this;
@@ -140,7 +142,7 @@ public:
       value_op_iterator tmp = *this; ++*this; return tmp;
     }
 
-    // Retrieve a pointer to the current User.
+    /// Retrieve a pointer to the current Value.
     Value *operator*() const {
       return *OI;
     }