diff --git a/llvm/lib/Analysis/Lint.cpp b/llvm/lib/Analysis/Lint.cpp
index 9260eb2c007e..65a90d7bcd87 100644
--- a/llvm/lib/Analysis/Lint.cpp
+++ b/llvm/lib/Analysis/Lint.cpp
@@ -141,16 +141,16 @@ namespace {
       }
     }
 
-    // \brief A check failed, so printout out the condition and the message.
-    //
-    // This provides a nice place to put a breakpoint if you want to see why
-    // something is not correct.
+    /// \brief A check failed, so printout out the condition and the message.
+    ///
+    /// This provides a nice place to put a breakpoint if you want to see why
+    /// something is not correct.
     void CheckFailed(const Twine &Message) { MessagesStr << Message << '\n'; }
 
-    // \brief A check failed (with values to print).
-    //
-    // This calls the Message-only version so that the above is easier to set a
-    // breakpoint on.
+    /// \brief A check failed (with values to print).
+    ///
+    /// This calls the Message-only version so that the above is easier to set
+    /// a breakpoint on.
     template <typename T1, typename... Ts>
     void CheckFailed(const Twine &Message, const T1 &V1, const Ts &...Vs) {
       CheckFailed(Message);
diff --git a/llvm/lib/IR/Verifier.cpp b/llvm/lib/IR/Verifier.cpp
index 084bfb81a97f..0b93b8a84f1d 100644
--- a/llvm/lib/IR/Verifier.cpp
+++ b/llvm/lib/IR/Verifier.cpp
@@ -131,19 +131,19 @@ private:
   template <typename... Ts> void WriteTs() {}
 
 public:
-  // \brief A check failed, so printout out the condition and the message.
-  //
-  // This provides a nice place to put a breakpoint if you want to see why
-  // something is not correct.
+  /// \brief A check failed, so printout out the condition and the message.
+  ///
+  /// This provides a nice place to put a breakpoint if you want to see why
+  /// something is not correct.
   void CheckFailed(const Twine &Message) {
     OS << Message << '\n';
     Broken = true;
   }
 
-  // \brief A check failed (with values to print).
-  //
-  // This calls the Message-only version so that the above is easier to set a
-  // breakpoint on.
+  /// \brief A check failed (with values to print).
+  ///
+  /// This calls the Message-only version so that the above is easier to set a
+  /// breakpoint on.
   template <typename T1, typename... Ts>
   void CheckFailed(const Twine &Message, const T1 &V1, const Ts &... Vs) {
     CheckFailed(Message);