From: Michael Ilseman <milseman@apple.com>
Date: Tue, 9 Oct 2012 17:05:59 +0000 (+0000)
Subject: More descriptive, doxygen-ed comments
X-Git-Url: http://demsky.eecs.uci.edu/git/?a=commitdiff_plain;h=798290e744343f098c686537b2906f9b93741039;p=oota-llvm.git

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 8b1895d4698..ade3676260b 100644
--- 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;
     }