Doxygenize the documentation comments

src/IceRegAlloc.h

Index: src/IceRegAlloc.h
diff --git a/src/IceRegAlloc.h b/src/IceRegAlloc.h
index 1658a7d4d97e27468ce1e183929e681f00fd5d2f..89ae715ae46aa9a12986bdcecc73ea81b2b6db40 100644
--- a/src/IceRegAlloc.h
+++ b/src/IceRegAlloc.h
@@ -6,11 +6,12 @@
 // License. See LICENSE.TXT for details.
 //
 //===----------------------------------------------------------------------===//
-//
-// This file declares the LinearScan data structure used during
-// linear-scan register allocation, which holds the various work
-// queues for the linear-scan algorithm.
-//
+///
+/// \file
+/// This file declares the LinearScan data structure used during
+/// linear-scan register allocation, which holds the various work
+/// queues for the linear-scan algorithm.
+///
 //===----------------------------------------------------------------------===//
 
 #ifndef SUBZERO_SRC_ICEREGALLOC_H
@@ -38,12 +39,12 @@ private:
 
   void initForGlobal();
   void initForInfOnly();
-  // Move an item from the From set to the To set.  From[Index] is
-  // pushed onto the end of To[], then the item is efficiently removed
-  // from From[] by effectively swapping it with the last item in
-  // From[] and then popping it from the back.  As such, the caller is
-  // best off iterating over From[] in reverse order to avoid the need
-  // for special handling of the iterator.
+  /// Move an item from the From set to the To set.  From[Index] is
+  /// pushed onto the end of To[], then the item is efficiently removed
+  /// from From[] by effectively swapping it with the last item in
+  /// From[] and then popping it from the back.  As such, the caller is
+  /// best off iterating over From[] in reverse order to avoid the need
+  /// for special handling of the iterator.
   void moveItem(UnorderedRanges &From, SizeT Index, UnorderedRanges &To) {
     To.push_back(From[Index]);
     From[Index] = From.back();
@@ -52,8 +53,8 @@ private:
 
   Cfg *const Func;
   OrderedRanges Unhandled;
-  // UnhandledPrecolored is a subset of Unhandled, specially collected
-  // for faster processing.
+  /// UnhandledPrecolored is a subset of Unhandled, specially collected
+  /// for faster processing.
   OrderedRanges UnhandledPrecolored;
   UnorderedRanges Active, Inactive, Handled;
   std::vector<InstNumberT> Kills;