review: fix up comments

Author: inbelic

llvm/docs/DirectX/DXILArchitecture.rst

@@ -122,7 +122,7 @@ Each of these passes has a defined responsibility:
    namely removing attributes, and inserting bitcasts to allow typed pointers
    to be inserted.
 #. DXILTranslateMetadata transforms and emits all recognized DXIL Metadata.
-#. DXILValidateMetadata validates all emitted DXIL metadata structures
+#. DXILValidateMetadata validates that all emitted DXIL metadata structures
    conform to DXIL validation.
 
 The passes to encode DXIL to binary in the DX Container follow the flow:

llvm/lib/Target/DirectX/DXILValidateMetadata.cpp

@@ -28,8 +28,8 @@ using namespace llvm;
 
 namespace {
 
-/// A simple Wrapper DiagnosticInfo that generates Module-level diagnostic
-/// for the ValidateMetadata pass
+/// A simple wrapper of DiagnosticInfo that generates module-level diagnostic
+/// for the DXILValidateMetadata pass
 class DiagnosticInfoValidateMD : public DiagnosticInfo {
 private:
   const Twine &Msg;
@@ -70,7 +70,7 @@ static void validateLoopMetadata(Module &M, MDNode *LoopMD) {
                                                  "llvm.loop.unroll.disable",
                                                  "llvm.loop.unroll.full"};
 
-  // llvm.loop metadata must have it's first operand be a self-reference, so we
+  // llvm.loop metadata must have its first operand be a self-reference, so we
   // require at least 1 operand.
   //
   // It only makes sense to specify up to 1 of the hints on a branch, so we can

llvm/lib/Target/DirectX/DXILValidateMetadata.h

@@ -1,4 +1,4 @@
-//===- DXILValidateMetadata.h - Pass to emit DXIL metadata -----*- C++ -*-===//
+//===- DXILValidateMetadata.h - Pass to validate DXIL metadata --*- C++ -*-===//
 //
 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
 // See https://llvm.org/LICENSE.txt for license information.
@@ -13,7 +13,7 @@
 
 namespace llvm {
 
-/// A pass that transforms DXIL Intrinsics that don't have DXIL opCodes
+/// A pass that validates metadata to be DXIL compatible
 class DXILValidateMetadata : public PassInfoMixin<DXILValidateMetadata> {
 public:
   PreservedAnalyses run(Module &M, ModuleAnalysisManager &);