diff --git a/lib/ABI/Analyses/ConvertToCABIFunctionType.cpp b/lib/ABI/Analyses/ConvertToCABIFunctionType.cpp
index f3f3c64d3..f4e34691d 100644
--- a/lib/ABI/Analyses/ConvertToCABIFunctionType.cpp
+++ b/lib/ABI/Analyses/ConvertToCABIFunctionType.cpp
@@ -1,5 +1,4 @@
 /// \file ConvertToCABIFunctionType.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/ABI/Analyses/ConvertToRawFunctionType.cpp b/lib/ABI/Analyses/ConvertToRawFunctionType.cpp
index 9deaebf99..5c089dcf8 100644
--- a/lib/ABI/Analyses/ConvertToRawFunctionType.cpp
+++ b/lib/ABI/Analyses/ConvertToRawFunctionType.cpp
@@ -1,5 +1,4 @@
 /// \file ConvertToRawFunctionType.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/ABI/DefaultFunctionPrototype.cpp b/lib/ABI/DefaultFunctionPrototype.cpp
index 55b83e5b1..6dadf7a65 100644
--- a/lib/ABI/DefaultFunctionPrototype.cpp
+++ b/lib/ABI/DefaultFunctionPrototype.cpp
@@ -1,5 +1,4 @@
 /// \file DefaultPrototype.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/ABI/Definition.cpp b/lib/ABI/Definition.cpp
index 81789e3e1..74eea480f 100644
--- a/lib/ABI/Definition.cpp
+++ b/lib/ABI/Definition.cpp
@@ -1,5 +1,4 @@
 /// \file Definition.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/ABI/FunctionType/Conversion.cpp b/lib/ABI/FunctionType/Conversion.cpp
index 505d69b7a..d272bed70 100644
--- a/lib/ABI/FunctionType/Conversion.cpp
+++ b/lib/ABI/FunctionType/Conversion.cpp
@@ -1,5 +1,4 @@
 /// \file Conversion.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/ABI/FunctionType/Layout.cpp b/lib/ABI/FunctionType/Layout.cpp
index 5c4e98718..6f1249ef4 100644
--- a/lib/ABI/FunctionType/Layout.cpp
+++ b/lib/ABI/FunctionType/Layout.cpp
@@ -1,5 +1,4 @@
 /// \file Layout.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/ABI/FunctionType/Support.cpp b/lib/ABI/FunctionType/Support.cpp
index 6337cbcc7..8f97183b6 100644
--- a/lib/ABI/FunctionType/Support.cpp
+++ b/lib/ABI/FunctionType/Support.cpp
@@ -1,5 +1,4 @@
 /// \file Support.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/ABI/RegisterStateDeductions.cpp b/lib/ABI/RegisterStateDeductions.cpp
index bbd86586b..9ad717374 100644
--- a/lib/ABI/RegisterStateDeductions.cpp
+++ b/lib/ABI/RegisterStateDeductions.cpp
@@ -1,5 +1,4 @@
 /// \file ApplyRegisterStateDeductions.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/BasicAnalyses/EmptyNewPC.cpp b/lib/BasicAnalyses/EmptyNewPC.cpp
index 0edf22621..357e72687 100644
--- a/lib/BasicAnalyses/EmptyNewPC.cpp
+++ b/lib/BasicAnalyses/EmptyNewPC.cpp
@@ -1,6 +1,6 @@
 /// \file EmptyNewPC.cpp
-/// \brief A simple pass to given an empty body to the `newpc` function so that
-///        it can be optimized away.
+/// A simple pass to given an empty body to the `newpc` function so that it can
+/// be optimized away.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/BasicAnalyses/GeneratedCodeBasicInfo.cpp b/lib/BasicAnalyses/GeneratedCodeBasicInfo.cpp
index 54adb3b20..b5d5f87ff 100644
--- a/lib/BasicAnalyses/GeneratedCodeBasicInfo.cpp
+++ b/lib/BasicAnalyses/GeneratedCodeBasicInfo.cpp
@@ -1,6 +1,6 @@
 /// \file GeneratedCodeBasicInfo.cpp
-/// \brief Implements the GeneratedCodeBasicInfo pass which provides basic
-///        information about the translated code (e.g., which CSV is the PC).
+/// Implements the GeneratedCodeBasicInfo pass which provides basic information
+/// about the translated code (e.g., which CSV is the PC).
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/BasicAnalyses/MaterializedValue.cpp b/lib/BasicAnalyses/MaterializedValue.cpp
index aace32d9d..ff82512ff 100644
--- a/lib/BasicAnalyses/MaterializedValue.cpp
+++ b/lib/BasicAnalyses/MaterializedValue.cpp
@@ -1,5 +1,4 @@
 /// \file MaterializedValue.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/BasicAnalyses/RemoveDbgMetadata.cpp b/lib/BasicAnalyses/RemoveDbgMetadata.cpp
index a1f467291..c6f8766d1 100644
--- a/lib/BasicAnalyses/RemoveDbgMetadata.cpp
+++ b/lib/BasicAnalyses/RemoveDbgMetadata.cpp
@@ -1,5 +1,5 @@
 /// \file RemoveDbgMetadata.cpp
-/// \brief A simple pass to remove debug metadata from a function.
+/// A simple pass to remove debug metadata from a function.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/BasicAnalyses/RemoveHelperCalls.cpp b/lib/BasicAnalyses/RemoveHelperCalls.cpp
index e9cab27a2..debe79bf5 100644
--- a/lib/BasicAnalyses/RemoveHelperCalls.cpp
+++ b/lib/BasicAnalyses/RemoveHelperCalls.cpp
@@ -1,6 +1,6 @@
 /// \file RemoveHelperCalls.cpp
-/// \brief Remove calls to helpers in a function and replaces them
-///        with stores of an opaque value onto the CSVs clobbered by the helper.
+/// Remove calls to helpers in a function and replaces them with stores of an
+/// opaque value onto the CSVs clobbered by the helper.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/BasicAnalyses/RemoveNewPCCalls.cpp b/lib/BasicAnalyses/RemoveNewPCCalls.cpp
index 901f8887a..203e2e961 100644
--- a/lib/BasicAnalyses/RemoveNewPCCalls.cpp
+++ b/lib/BasicAnalyses/RemoveNewPCCalls.cpp
@@ -1,5 +1,5 @@
 /// \file RemoveNewPCCalls.cpp
-/// \brief Remove calls to newpc in a function.
+/// Remove calls to newpc in a function.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/BasicAnalyses/ShrinkInstructionOperandsPass.cpp b/lib/BasicAnalyses/ShrinkInstructionOperandsPass.cpp
index b61287d2e..b16f0beaf 100644
--- a/lib/BasicAnalyses/ShrinkInstructionOperandsPass.cpp
+++ b/lib/BasicAnalyses/ShrinkInstructionOperandsPass.cpp
@@ -1,5 +1,4 @@
 /// \file ShrinkInstructionOperandsPass.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/EarlyFunctionAnalysis/AAWriterPass.cpp b/lib/EarlyFunctionAnalysis/AAWriterPass.cpp
index e72894207..225e92389 100644
--- a/lib/EarlyFunctionAnalysis/AAWriterPass.cpp
+++ b/lib/EarlyFunctionAnalysis/AAWriterPass.cpp
@@ -1,6 +1,5 @@
 /// \file AAWriterPass.cpp
-/// \brief Add aliasing scope information to the IR before load and store
-///        accesses.
+/// Add aliasing scope information to the IR before load and store accesses.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/EarlyFunctionAnalysis/AttachDebugInfo.cpp b/lib/EarlyFunctionAnalysis/AttachDebugInfo.cpp
index 776ce0630..c3830b653 100644
--- a/lib/EarlyFunctionAnalysis/AttachDebugInfo.cpp
+++ b/lib/EarlyFunctionAnalysis/AttachDebugInfo.cpp
@@ -1,5 +1,5 @@
 /// \file AttachDebugInfo.cpp
-/// \brief A simple pass to attach debug metadata.
+/// A simple pass to attach debug metadata.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/EarlyFunctionAnalysis/CollectFunctionsFromCalleesPass.cpp b/lib/EarlyFunctionAnalysis/CollectFunctionsFromCalleesPass.cpp
index 2125b0d8b..7aaf83af2 100644
--- a/lib/EarlyFunctionAnalysis/CollectFunctionsFromCalleesPass.cpp
+++ b/lib/EarlyFunctionAnalysis/CollectFunctionsFromCalleesPass.cpp
@@ -1,5 +1,5 @@
 /// \file CollectFunctionsFromCalleesPass.cpp
-/// \brief Collect the function entry points from the callees.
+/// Collect the function entry points from the callees.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/EarlyFunctionAnalysis/CollectFunctionsFromUnusedAddressesPass.cpp b/lib/EarlyFunctionAnalysis/CollectFunctionsFromUnusedAddressesPass.cpp
index d827aebe9..d2407d641 100644
--- a/lib/EarlyFunctionAnalysis/CollectFunctionsFromUnusedAddressesPass.cpp
+++ b/lib/EarlyFunctionAnalysis/CollectFunctionsFromUnusedAddressesPass.cpp
@@ -1,5 +1,5 @@
 /// \file CollectFunctionsFromUnusedAddressesPass.cpp
-/// \brief Collect the function entry points from unused addresses.
+/// Collect the function entry points from unused addresses.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/EarlyFunctionAnalysis/IndirectBranchInfoPrinterPass.cpp b/lib/EarlyFunctionAnalysis/IndirectBranchInfoPrinterPass.cpp
index 90473dcf3..6a6442ccd 100644
--- a/lib/EarlyFunctionAnalysis/IndirectBranchInfoPrinterPass.cpp
+++ b/lib/EarlyFunctionAnalysis/IndirectBranchInfoPrinterPass.cpp
@@ -1,5 +1,5 @@
 /// \file IndirectBranchInfoPrinterPass.cpp
-/// \brief Serialize the results of the EarlyFunctionAnalysis on disk.
+/// Serialize the results of the EarlyFunctionAnalysis on disk.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/EarlyFunctionAnalysis/PromoteGlobalToLocalVars.cpp b/lib/EarlyFunctionAnalysis/PromoteGlobalToLocalVars.cpp
index 4e0e5fd46..fc046d662 100644
--- a/lib/EarlyFunctionAnalysis/PromoteGlobalToLocalVars.cpp
+++ b/lib/EarlyFunctionAnalysis/PromoteGlobalToLocalVars.cpp
@@ -1,5 +1,5 @@
 /// \file PromoteGlobalToLocalVars.cpp
-/// \brief Promote CSVs in form of global variables to local variables.
+/// Promote CSVs in form of global variables to local variables.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/EarlyFunctionAnalysis/SegregateDirectStackAccesses.cpp b/lib/EarlyFunctionAnalysis/SegregateDirectStackAccesses.cpp
index 481c4f070..a8f88fb54 100644
--- a/lib/EarlyFunctionAnalysis/SegregateDirectStackAccesses.cpp
+++ b/lib/EarlyFunctionAnalysis/SegregateDirectStackAccesses.cpp
@@ -1,7 +1,9 @@
 /// \file SegregateDirectStackAccesses.cpp
-/// \brief Segregate direct stack accesses from all other memory accesses
-///        through alias information. This provides a way to say that stack
-///        accesses do not interfere with any other memory access.
+/// Segregate direct stack accesses from all other memory accesses through alias
+/// information.
+///
+/// This provides a way to say that stack accesses do not interfere with any
+/// other memory access.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/FunctionCallIdentification/FunctionCallIdentification.cpp b/lib/FunctionCallIdentification/FunctionCallIdentification.cpp
index 7c4f3b1bc..89ef4e084 100644
--- a/lib/FunctionCallIdentification/FunctionCallIdentification.cpp
+++ b/lib/FunctionCallIdentification/FunctionCallIdentification.cpp
@@ -1,6 +1,6 @@
 /// \file FunctionCallIdentification.cpp
-/// \brief Implementation of the FunctionCallIdentification pass, which
-///        identifies function calls.
+/// Implementation of the FunctionCallIdentification pass, which identifies
+/// function calls.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/FunctionCallIdentification/PruneRetSuccessors.cpp b/lib/FunctionCallIdentification/PruneRetSuccessors.cpp
index b8bff1e26..7f55aca7b 100644
--- a/lib/FunctionCallIdentification/PruneRetSuccessors.cpp
+++ b/lib/FunctionCallIdentification/PruneRetSuccessors.cpp
@@ -1,5 +1,5 @@
 /// \file PruneRetSuccessors.cpp
-/// \brief Remove successors from return instructions
+/// Remove successors from return instructions
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/FunctionIsolation/DropRoot.cpp b/lib/FunctionIsolation/DropRoot.cpp
index 926ac2c1c..37108e61a 100644
--- a/lib/FunctionIsolation/DropRoot.cpp
+++ b/lib/FunctionIsolation/DropRoot.cpp
@@ -1,5 +1,4 @@
 /// \file DropRoot.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/FunctionIsolation/EnforceABI.cpp b/lib/FunctionIsolation/EnforceABI.cpp
index 1b0370b35..f9ccee673 100644
--- a/lib/FunctionIsolation/EnforceABI.cpp
+++ b/lib/FunctionIsolation/EnforceABI.cpp
@@ -1,6 +1,6 @@
 /// \file EnforceABI.cpp
-/// \brief Promotes global variables CSV to function arguments or local
-///        variables, according to the ABI analysis.
+/// Promotes global variables CSV to function arguments or local variables,
+/// according to the ABI analysis.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/FunctionIsolation/InlineHelpers.cpp b/lib/FunctionIsolation/InlineHelpers.cpp
index afa9070f9..726bfe832 100644
--- a/lib/FunctionIsolation/InlineHelpers.cpp
+++ b/lib/FunctionIsolation/InlineHelpers.cpp
@@ -1,5 +1,4 @@
 /// \file InlineHelpers.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/FunctionIsolation/InvokeIsolatedFunctions.cpp b/lib/FunctionIsolation/InvokeIsolatedFunctions.cpp
index c60c812f7..4ab5f4087 100644
--- a/lib/FunctionIsolation/InvokeIsolatedFunctions.cpp
+++ b/lib/FunctionIsolation/InvokeIsolatedFunctions.cpp
@@ -1,5 +1,4 @@
 /// \file InvokeIsolatedFunctions.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/FunctionIsolation/IsolateFunctions.cpp b/lib/FunctionIsolation/IsolateFunctions.cpp
index 16791d120..a21d35401 100644
--- a/lib/FunctionIsolation/IsolateFunctions.cpp
+++ b/lib/FunctionIsolation/IsolateFunctions.cpp
@@ -1,6 +1,6 @@
 /// \file IsolateFunctions.cpp
-/// \brief Implements the IsolateFunctions pass which applies function isolation
-///        using the information provided by EarlyFunctionAnalysis.
+/// Implements the IsolateFunctions pass which applies function isolation using
+/// the information provided by EarlyFunctionAnalysis.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/FunctionIsolation/PromoteCSVs.cpp b/lib/FunctionIsolation/PromoteCSVs.cpp
index b29ce04d2..0f03ac6e5 100644
--- a/lib/FunctionIsolation/PromoteCSVs.cpp
+++ b/lib/FunctionIsolation/PromoteCSVs.cpp
@@ -1,5 +1,4 @@
 /// \file PromoteCSVs.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/FunctionIsolation/RemoveExceptionalCalls.cpp b/lib/FunctionIsolation/RemoveExceptionalCalls.cpp
index 0990dc5e9..e3f5d40e7 100644
--- a/lib/FunctionIsolation/RemoveExceptionalCalls.cpp
+++ b/lib/FunctionIsolation/RemoveExceptionalCalls.cpp
@@ -1,5 +1,4 @@
 /// \file RemoveExceptionalCalls.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/FunctionIsolation/StructInitializers.cpp b/lib/FunctionIsolation/StructInitializers.cpp
index ab0321c1c..300f243d2 100644
--- a/lib/FunctionIsolation/StructInitializers.cpp
+++ b/lib/FunctionIsolation/StructInitializers.cpp
@@ -1,5 +1,4 @@
 /// \file StructInitializers.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/GraphLayout/SugiyamaStyle/Compute.cpp b/lib/GraphLayout/SugiyamaStyle/Compute.cpp
index 388f39646..777827a72 100644
--- a/lib/GraphLayout/SugiyamaStyle/Compute.cpp
+++ b/lib/GraphLayout/SugiyamaStyle/Compute.cpp
@@ -1,5 +1,4 @@
 /// \file Compute.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/GraphLayout/SugiyamaStyle/EdgeRouting.cpp b/lib/GraphLayout/SugiyamaStyle/EdgeRouting.cpp
index 7570103a5..dc57d276d 100644
--- a/lib/GraphLayout/SugiyamaStyle/EdgeRouting.cpp
+++ b/lib/GraphLayout/SugiyamaStyle/EdgeRouting.cpp
@@ -1,5 +1,4 @@
 /// \file EdgeRouting.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/GraphLayout/SugiyamaStyle/GraphPreparation.cpp b/lib/GraphLayout/SugiyamaStyle/GraphPreparation.cpp
index ecde5678e..85ca901fe 100644
--- a/lib/GraphLayout/SugiyamaStyle/GraphPreparation.cpp
+++ b/lib/GraphLayout/SugiyamaStyle/GraphPreparation.cpp
@@ -1,5 +1,4 @@
 /// \file GraphPreparation.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/GraphLayout/SugiyamaStyle/HorizontalPositions.cpp b/lib/GraphLayout/SugiyamaStyle/HorizontalPositions.cpp
index 07f8ea908..09f83da32 100644
--- a/lib/GraphLayout/SugiyamaStyle/HorizontalPositions.cpp
+++ b/lib/GraphLayout/SugiyamaStyle/HorizontalPositions.cpp
@@ -1,5 +1,4 @@
 /// \file HorizontalPositions.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/GraphLayout/SugiyamaStyle/LaneDistribution.cpp b/lib/GraphLayout/SugiyamaStyle/LaneDistribution.cpp
index 06f272edd..fd0184948 100644
--- a/lib/GraphLayout/SugiyamaStyle/LaneDistribution.cpp
+++ b/lib/GraphLayout/SugiyamaStyle/LaneDistribution.cpp
@@ -1,5 +1,4 @@
 /// \file LaneDistribution.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/GraphLayout/SugiyamaStyle/LayoutConversion.cpp b/lib/GraphLayout/SugiyamaStyle/LayoutConversion.cpp
index 2fa1c7d9a..1680a809f 100644
--- a/lib/GraphLayout/SugiyamaStyle/LayoutConversion.cpp
+++ b/lib/GraphLayout/SugiyamaStyle/LayoutConversion.cpp
@@ -1,5 +1,4 @@
 /// \file LayoutConversion.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/GraphLayout/SugiyamaStyle/LinearSegmentSelection.cpp b/lib/GraphLayout/SugiyamaStyle/LinearSegmentSelection.cpp
index bd946b850..dfd51b414 100644
--- a/lib/GraphLayout/SugiyamaStyle/LinearSegmentSelection.cpp
+++ b/lib/GraphLayout/SugiyamaStyle/LinearSegmentSelection.cpp
@@ -1,5 +1,4 @@
 /// \file LinearSegmentSelection.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/GraphLayout/SugiyamaStyle/NodeRanking.cpp b/lib/GraphLayout/SugiyamaStyle/NodeRanking.cpp
index f3adb9fae..da8c2f198 100644
--- a/lib/GraphLayout/SugiyamaStyle/NodeRanking.cpp
+++ b/lib/GraphLayout/SugiyamaStyle/NodeRanking.cpp
@@ -1,5 +1,4 @@
 /// \file NodeRanking.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/GraphLayout/SugiyamaStyle/PermutationSelection.cpp b/lib/GraphLayout/SugiyamaStyle/PermutationSelection.cpp
index b2d8ae41c..cf856bf6b 100644
--- a/lib/GraphLayout/SugiyamaStyle/PermutationSelection.cpp
+++ b/lib/GraphLayout/SugiyamaStyle/PermutationSelection.cpp
@@ -1,5 +1,4 @@
 /// \file PermutationSelection.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/GraphLayout/SugiyamaStyle/TopologicalOrdering.cpp b/lib/GraphLayout/SugiyamaStyle/TopologicalOrdering.cpp
index ab79fbb72..b304877d4 100644
--- a/lib/GraphLayout/SugiyamaStyle/TopologicalOrdering.cpp
+++ b/lib/GraphLayout/SugiyamaStyle/TopologicalOrdering.cpp
@@ -1,5 +1,4 @@
 /// \file TopologicalOrdering.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/GraphLayout/SugiyamaStyle/VerticalPositions.cpp b/lib/GraphLayout/SugiyamaStyle/VerticalPositions.cpp
index bae793559..706bf00b3 100644
--- a/lib/GraphLayout/SugiyamaStyle/VerticalPositions.cpp
+++ b/lib/GraphLayout/SugiyamaStyle/VerticalPositions.cpp
@@ -1,5 +1,4 @@
 /// \file VerticalPositions.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/CPUStateAccessAnalysisPass.cpp b/lib/Lift/CPUStateAccessAnalysisPass.cpp
index c70597683..cd2c0b8f4 100644
--- a/lib/Lift/CPUStateAccessAnalysisPass.cpp
+++ b/lib/Lift/CPUStateAccessAnalysisPass.cpp
@@ -1,6 +1,6 @@
 /// \file CPUStateAccessAnalysisPass.cpp
-/// \brief This file performs an analysis for reconstructing the access
-///        patterns to the CPU State Variables (CSV).
+/// This file performs an analysis for reconstructing the access patterns to the
+/// CPU State Variables (CSV).
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/CodeGenerator.cpp b/lib/Lift/CodeGenerator.cpp
index 4b37e8a7e..2ba7bca57 100644
--- a/lib/Lift/CodeGenerator.cpp
+++ b/lib/Lift/CodeGenerator.cpp
@@ -1,6 +1,6 @@
 /// \file CodeGenerator.cpp
-/// \brief This file handles the whole translation process from the input
-///        assembly to LLVM IR.
+/// This file handles the whole translation process from the input assembly to
+/// LLVM IR.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/ExternalJumpsHandler.cpp b/lib/Lift/ExternalJumpsHandler.cpp
index 7596ac281..693015e69 100644
--- a/lib/Lift/ExternalJumpsHandler.cpp
+++ b/lib/Lift/ExternalJumpsHandler.cpp
@@ -1,6 +1,6 @@
 /// \file externaljumpsHandler.cpp
-/// \brief Inject code to support jumping in non-translated code and handling
-///        the comeback.
+/// Inject code to support jumping in non-translated code and handling the
+/// comeback.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/InstructionTranslator.cpp b/lib/Lift/InstructionTranslator.cpp
index 1ea22ae5a..fbab51087 100644
--- a/lib/Lift/InstructionTranslator.cpp
+++ b/lib/Lift/InstructionTranslator.cpp
@@ -1,6 +1,5 @@
 /// \file InstructionTranslator.cpp
-/// \brief This file implements the logic to translate a PTC instruction in to
-///        LLVM IR.
+/// This file implements the logic to translate a PTC instruction in to LLVM IR.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/JumpTargetManager.cpp b/lib/Lift/JumpTargetManager.cpp
index cea8096dc..ef5ee8848 100644
--- a/lib/Lift/JumpTargetManager.cpp
+++ b/lib/Lift/JumpTargetManager.cpp
@@ -1,7 +1,6 @@
 /// \file JumpTargetManager.cpp
-/// \brief This file handles the possible jump targets encountered during
-///        translation and the creation and management of the respective
-///        BasicBlock.
+/// This file handles the possible jump targets encountered during translation
+/// and the creation and management of the respective BasicBlock.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/Lift.cpp b/lib/Lift/Lift.cpp
index e8a22cf59..48302e621 100644
--- a/lib/Lift/Lift.cpp
+++ b/lib/Lift/Lift.cpp
@@ -1,5 +1,4 @@
 /// \file Lift.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/LiftPipe.cpp b/lib/Lift/LiftPipe.cpp
index 9f8f7710e..47a84c867 100644
--- a/lib/Lift/LiftPipe.cpp
+++ b/lib/Lift/LiftPipe.cpp
@@ -1,5 +1,5 @@
 /// \file Lift.cpp
-/// \brief Lift transform a binary into a llvm module
+/// Lift transform a binary into a llvm module
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/LinkSupportPipe.cpp b/lib/Lift/LinkSupportPipe.cpp
index b3f342b76..1d3ac80a5 100644
--- a/lib/Lift/LinkSupportPipe.cpp
+++ b/lib/Lift/LinkSupportPipe.cpp
@@ -1,5 +1,5 @@
 /// \file LinkSupport.cpp
-/// \brief Link support adds the helper functions to a lifeted module
+/// Link support adds the helper functions to a lifeted module
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/LoadBinaryPass.cpp b/lib/Lift/LoadBinaryPass.cpp
index 5eff2354c..23e8569bc 100644
--- a/lib/Lift/LoadBinaryPass.cpp
+++ b/lib/Lift/LoadBinaryPass.cpp
@@ -1,5 +1,4 @@
 /// \file LoadBinaryPass.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/PTCDump.cpp b/lib/Lift/PTCDump.cpp
index 8d85fe22c..09ada5644 100644
--- a/lib/Lift/PTCDump.cpp
+++ b/lib/Lift/PTCDump.cpp
@@ -1,5 +1,5 @@
 /// \file PTCDump.cpp
-/// \brief This file handles dumping PTC to text
+/// This file handles dumping PTC to text
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/RootAnalyzer.cpp b/lib/Lift/RootAnalyzer.cpp
index f64d0b2c5..5a161029f 100644
--- a/lib/Lift/RootAnalyzer.cpp
+++ b/lib/Lift/RootAnalyzer.cpp
@@ -1,5 +1,4 @@
 /// \file RootAnalyzer.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/ValueMaterializerPass.cpp b/lib/Lift/ValueMaterializerPass.cpp
index 3ee34bf7d..4bb76522a 100644
--- a/lib/Lift/ValueMaterializerPass.cpp
+++ b/lib/Lift/ValueMaterializerPass.cpp
@@ -1,5 +1,4 @@
 /// \file ValueMaterializerPass.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Lift/VariableManager.cpp b/lib/Lift/VariableManager.cpp
index c0c5b9068..a22266b7a 100644
--- a/lib/Lift/VariableManager.cpp
+++ b/lib/Lift/VariableManager.cpp
@@ -1,6 +1,6 @@
 /// \file VariableManager.cpp
-/// \brief This file handles the creation and management of global variables,
-///        i.e. mainly parts of the CPU state
+/// This file handles the creation and management of global variables, i.e.
+/// mainly parts of the CPU state
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Binary.cpp b/lib/Model/Binary.cpp
index a928c4b7b..498c8e05c 100644
--- a/lib/Model/Binary.cpp
+++ b/lib/Model/Binary.cpp
@@ -1,5 +1,4 @@
 /// \file Binary.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Importer/Binary/BinaryImporter.cpp b/lib/Model/Importer/Binary/BinaryImporter.cpp
index 3fdf7e460..511934106 100644
--- a/lib/Model/Importer/Binary/BinaryImporter.cpp
+++ b/lib/Model/Importer/Binary/BinaryImporter.cpp
@@ -1,5 +1,4 @@
 /// \file BinaryImporter.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Importer/Binary/ELFImporter.cpp b/lib/Model/Importer/Binary/ELFImporter.cpp
index 9595ec78d..76522c8aa 100644
--- a/lib/Model/Importer/Binary/ELFImporter.cpp
+++ b/lib/Model/Importer/Binary/ELFImporter.cpp
@@ -1,5 +1,4 @@
 /// \file ELFImporter.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Importer/Binary/ImportBinaryAnalysis.cpp b/lib/Model/Importer/Binary/ImportBinaryAnalysis.cpp
index 6ab0fe447..2e349c7da 100644
--- a/lib/Model/Importer/Binary/ImportBinaryAnalysis.cpp
+++ b/lib/Model/Importer/Binary/ImportBinaryAnalysis.cpp
@@ -1,5 +1,4 @@
 /// \file ImportBinaryAnalysis.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Importer/Binary/MachOImporter.cpp b/lib/Model/Importer/Binary/MachOImporter.cpp
index 502cc5245..f6c116d91 100644
--- a/lib/Model/Importer/Binary/MachOImporter.cpp
+++ b/lib/Model/Importer/Binary/MachOImporter.cpp
@@ -1,5 +1,4 @@
 /// \file MachO.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Importer/Binary/Options.cpp b/lib/Model/Importer/Binary/Options.cpp
index ddf0aa8ab..b78a90753 100644
--- a/lib/Model/Importer/Binary/Options.cpp
+++ b/lib/Model/Importer/Binary/Options.cpp
@@ -1,5 +1,4 @@
 /// \file Options.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Importer/Binary/PECOFFImporter.cpp b/lib/Model/Importer/Binary/PECOFFImporter.cpp
index 36483b4a8..9421fcb67 100644
--- a/lib/Model/Importer/Binary/PECOFFImporter.cpp
+++ b/lib/Model/Importer/Binary/PECOFFImporter.cpp
@@ -1,5 +1,4 @@
 /// \file PECOFF.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Importer/DebugInfo/DwarfImporter.cpp b/lib/Model/Importer/DebugInfo/DwarfImporter.cpp
index 5d3fed603..86b9dcd16 100644
--- a/lib/Model/Importer/DebugInfo/DwarfImporter.cpp
+++ b/lib/Model/Importer/DebugInfo/DwarfImporter.cpp
@@ -1,5 +1,4 @@
 /// \file DwarfImporter.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Importer/DebugInfo/PDBImporter.cpp b/lib/Model/Importer/DebugInfo/PDBImporter.cpp
index c8f4d0bbf..40bacd28b 100644
--- a/lib/Model/Importer/DebugInfo/PDBImporter.cpp
+++ b/lib/Model/Importer/DebugInfo/PDBImporter.cpp
@@ -1,5 +1,4 @@
 /// \file PDBImporter.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Importer/WellKnownModels.cpp b/lib/Model/Importer/WellKnownModels.cpp
index 73787332f..a83e06e03 100644
--- a/lib/Model/Importer/WellKnownModels.cpp
+++ b/lib/Model/Importer/WellKnownModels.cpp
@@ -1,5 +1,4 @@
 /// \file WellKnownModels.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/LoadModelPass.cpp b/lib/Model/LoadModelPass.cpp
index f9f6e5dde..149788273 100644
--- a/lib/Model/LoadModelPass.cpp
+++ b/lib/Model/LoadModelPass.cpp
@@ -1,6 +1,6 @@
 /// \file LoadModelPass.cpp
-/// \brief Implementation of the immutable pass providing access to
-///        the model and taking care of its deserialization on the IR.
+/// Implementation of the immutable pass providing access to the model and
+/// taking care of its deserialization on the IR.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Pass/DeduplicateEquivalentTypes.cpp b/lib/Model/Pass/DeduplicateEquivalentTypes.cpp
index 7000ccf81..ccaff227e 100644
--- a/lib/Model/Pass/DeduplicateEquivalentTypes.cpp
+++ b/lib/Model/Pass/DeduplicateEquivalentTypes.cpp
@@ -1,5 +1,5 @@
 /// \file DeduplicateEquivalentTypes.cpp
-/// \brief Implementation of deduplication of identical types.
+/// Implementation of deduplication of identical types.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Pass/FixModel.cpp b/lib/Model/Pass/FixModel.cpp
index e78ed28f3..cab8d48cf 100644
--- a/lib/Model/Pass/FixModel.cpp
+++ b/lib/Model/Pass/FixModel.cpp
@@ -1,5 +1,4 @@
 /// \file FixModel.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Pass/OptionCategory.cpp b/lib/Model/Pass/OptionCategory.cpp
index 47ae6d094..be6a27cb5 100644
--- a/lib/Model/Pass/OptionCategory.cpp
+++ b/lib/Model/Pass/OptionCategory.cpp
@@ -1,5 +1,5 @@
 /// \file OptionCategory.cpp
-/// \brief Defines the option category for model passes to use.
+/// Defines the option category for model passes to use.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Pass/PromoteOriginalName.cpp b/lib/Model/Pass/PromoteOriginalName.cpp
index 3e6374ba7..86b02bc97 100644
--- a/lib/Model/Pass/PromoteOriginalName.cpp
+++ b/lib/Model/Pass/PromoteOriginalName.cpp
@@ -1,5 +1,4 @@
 /// \file PromoteOriginalName.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Pass/PurgeUnnamedAndUnreachableTypes.cpp b/lib/Model/Pass/PurgeUnnamedAndUnreachableTypes.cpp
index 70202c138..8bc85a8ba 100644
--- a/lib/Model/Pass/PurgeUnnamedAndUnreachableTypes.cpp
+++ b/lib/Model/Pass/PurgeUnnamedAndUnreachableTypes.cpp
@@ -1,5 +1,4 @@
 /// \file PurgeUnnamedAndUnreachableTypes.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Pass/Verify.cpp b/lib/Model/Pass/Verify.cpp
index 0376b0a13..a97d8fe45 100644
--- a/lib/Model/Pass/Verify.cpp
+++ b/lib/Model/Pass/Verify.cpp
@@ -1,5 +1,4 @@
 /// \file Verify.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Processing.cpp b/lib/Model/Processing.cpp
index c4f7de811..7c739ce35 100644
--- a/lib/Model/Processing.cpp
+++ b/lib/Model/Processing.cpp
@@ -1,6 +1,6 @@
 /// \file Processing.cpp
-/// \brief A collection of helper functions to improve the quality of the
-///        model/make it valid
+/// A collection of helper functions to improve the quality of the model/make it
+/// valid.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/SerializeModelPass.cpp b/lib/Model/SerializeModelPass.cpp
index 29ace3ac8..86058b023 100644
--- a/lib/Model/SerializeModelPass.cpp
+++ b/lib/Model/SerializeModelPass.cpp
@@ -1,6 +1,6 @@
 /// \file SerializeModelPass.cpp
-/// \brief Implementation of the pass taking care of serializing the
-///        model in the Module as Metadata.
+/// Implementation of the pass taking care of serializing the model in the
+/// Module as Metadata.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Model/Visits.cpp b/lib/Model/Visits.cpp
index bcc683ac0..0083584ff 100644
--- a/lib/Model/Visits.cpp
+++ b/lib/Model/Visits.cpp
@@ -1,5 +1,4 @@
 /// \file Visits.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/ContainerSet.cpp b/lib/Pipeline/ContainerSet.cpp
index d97cf5adf..e6724a1a0 100644
--- a/lib/Pipeline/ContainerSet.cpp
+++ b/lib/Pipeline/ContainerSet.cpp
@@ -1,6 +1,5 @@
 /// \file ContainerSet.cpp
-/// \brief ContainerSets are collections of containers able to spawn them on
-/// request
+/// ContainerSets are collections of containers able to spawn them on request.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/Context.cpp b/lib/Pipeline/Context.cpp
index f7d2b2c8d..4eeb1d7b1 100644
--- a/lib/Pipeline/Context.cpp
+++ b/lib/Pipeline/Context.cpp
@@ -1,6 +1,6 @@
 /// \file Context.cpp
-/// \brief The pipeline context the place where all objects used by more that
-/// one pipeline or container are stored.
+/// The pipeline context the place where all objects used by more that one
+/// pipeline or container are stored.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/Contract.cpp b/lib/Pipeline/Contract.cpp
index b0e32f1b8..d72d1467e 100644
--- a/lib/Pipeline/Contract.cpp
+++ b/lib/Pipeline/Contract.cpp
@@ -1,5 +1,5 @@
 /// \file Contract.cpp
-/// \brief A contract is "Rule" attached to a pipe that specifies what kind of
+/// A contract is "Rule" attached to a pipe that specifies what kind of
 /// transformations the pipe is allowed to do on input containers.
 
 //
diff --git a/lib/Pipeline/Errors.cpp b/lib/Pipeline/Errors.cpp
index 9a68383e9..8aa5102e9 100644
--- a/lib/Pipeline/Errors.cpp
+++ b/lib/Pipeline/Errors.cpp
@@ -1,6 +1,6 @@
 /// \file Errors.cpp
-/// \brief this file contains the various errors that can be thrown from whitin
-/// a pipeline
+/// This file contains the various errors that can be thrown from whitin a
+/// pipeline.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/GenericLLVMPipe.cpp b/lib/Pipeline/GenericLLVMPipe.cpp
index c0c8672b6..4b6f24934 100644
--- a/lib/Pipeline/GenericLLVMPipe.cpp
+++ b/lib/Pipeline/GenericLLVMPipe.cpp
@@ -1,5 +1,5 @@
 /// \file LLVMPipe.cpp
-/// \brief A llvm pipe is a pipe that operates on a llvm container
+/// A llvm pipe is a pipe that operates on a llvm container.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/Global.cpp b/lib/Pipeline/Global.cpp
index 94907e160..b366ccbac 100644
--- a/lib/Pipeline/Global.cpp
+++ b/lib/Pipeline/Global.cpp
@@ -1,6 +1,5 @@
 /// \file Global.cpp
-/// \brief a saveable object that an be serialized and deserialized from a
-/// string
+/// A saveable object that an be serialized and deserialized from a string.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/GlobalsMap.cpp b/lib/Pipeline/GlobalsMap.cpp
index 0a1ae6fa8..ed68bae86 100644
--- a/lib/Pipeline/GlobalsMap.cpp
+++ b/lib/Pipeline/GlobalsMap.cpp
@@ -1,5 +1,4 @@
 /// \file GlobalsMap.cpp
-/// \brief GlobalsMap methods implementations
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/Kind.cpp b/lib/Pipeline/Kind.cpp
index f93400a09..7ff35578c 100644
--- a/lib/Pipeline/Kind.cpp
+++ b/lib/Pipeline/Kind.cpp
@@ -1,6 +1,6 @@
 /// \file Kind.cpp
-/// \brief A kind is a object associated to target do distinguish semantically
-/// different targets that may share the same components path
+/// A kind is a object associated to target do distinguish semantically
+/// different targets that may share the same components path.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/LLVMContainer.cpp b/lib/Pipeline/LLVMContainer.cpp
index 4052085a4..4de984eae 100644
--- a/lib/Pipeline/LLVMContainer.cpp
+++ b/lib/Pipeline/LLVMContainer.cpp
@@ -1,7 +1,7 @@
 /// \file LLVMContainer.cpp
-/// \brief A llvm container is a container which uses a llvm module as a
-/// backend, and can be customized with downstream kinds that specify which
-/// global objects in it are which target.
+/// A llvm container is a container which uses a llvm module as a backend, and
+/// can be customized with downstream kinds that specify which global objects in
+/// it are which target.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/Loader.cpp b/lib/Pipeline/Loader.cpp
index 3bb7d2333..cae8a24b4 100644
--- a/lib/Pipeline/Loader.cpp
+++ b/lib/Pipeline/Loader.cpp
@@ -1,6 +1,6 @@
 /// \file Loader.cpp
-/// \brief a loader is a object that acceps a serialized pipeline and yields a
-/// runner object that rappresents that pipeline.
+/// A loader is a object that acceps a serialized pipeline and yields a runner
+/// object that rappresents that pipeline.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/RegisterKind.cpp b/lib/Pipeline/RegisterKind.cpp
index a4b15a523..fd5c1bd25 100644
--- a/lib/Pipeline/RegisterKind.cpp
+++ b/lib/Pipeline/RegisterKind.cpp
@@ -1,5 +1,4 @@
 // \file RegisterKind.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/Registry.cpp b/lib/Pipeline/Registry.cpp
index 4e259afd5..2108dd165 100644
--- a/lib/Pipeline/Registry.cpp
+++ b/lib/Pipeline/Registry.cpp
@@ -1,5 +1,4 @@
 // \file Registry.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/Runner.cpp b/lib/Pipeline/Runner.cpp
index 4d0985054..fdbd30d0a 100644
--- a/lib/Pipeline/Runner.cpp
+++ b/lib/Pipeline/Runner.cpp
@@ -1,6 +1,5 @@
 /// \file Runner.cpp
-/// \brief a runner top object of a pipeline structure, it is able to run the
-/// pipeline.
+/// A runner top object of a pipeline structure, it is able to run the pipeline.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/Step.cpp b/lib/Pipeline/Step.cpp
index 5e34912fa..06086e262 100644
--- a/lib/Pipeline/Step.cpp
+++ b/lib/Pipeline/Step.cpp
@@ -1,7 +1,6 @@
 /// \file Runner.cpp
-/// \brief a step is composed of a list of pipes and a set of containers
-/// rappresenting the content of the pipeline before the execution of such
-/// pipes.
+/// A step is composed of a list of pipes and a set of containers representing
+/// the content of the pipeline before the execution of such pipes.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipeline/Target.cpp b/lib/Pipeline/Target.cpp
index 80cb3c9aa..be45bf6cb 100644
--- a/lib/Pipeline/Target.cpp
+++ b/lib/Pipeline/Target.cpp
@@ -1,6 +1,6 @@
 /// \file Runner.cpp
-/// \brief a target is a object that is associated to the content of a container
-/// to describe it without knowing what is the real type of the content itself.
+/// A target is a object that is associated to the content of a container to
+/// describe it without knowing what is the real type of the content itself.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/PipelineC/Tracing/Inspector.cpp b/lib/PipelineC/Tracing/Inspector.cpp
index ed15696e7..3a104bd81 100644
--- a/lib/PipelineC/Tracing/Inspector.cpp
+++ b/lib/PipelineC/Tracing/Inspector.cpp
@@ -1,6 +1,6 @@
 /// \file Runner.cpp
-/// \brief Implements the logic for inspecting a trace file. Right now this
-///        entails listing and extracting buffers
+/// Implements the logic for inspecting a trace file. Right now this entails
+/// listing and extracting buffers.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/PipelineC/Tracing/Runner.cpp b/lib/PipelineC/Tracing/Runner.cpp
index 2071526bc..e5de80631 100644
--- a/lib/PipelineC/Tracing/Runner.cpp
+++ b/lib/PipelineC/Tracing/Runner.cpp
@@ -1,7 +1,6 @@
 /// \file Runner.cpp
-/// \brief Implements the logic to run a trace file, this boils down to the
-///        Trace.run function that will re-execute the commands of the trace in
-///        order
+/// Implements the logic to run a trace file, this boils down to the Trace.run
+/// function that will re-execute the commands of the trace in order.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipes/ApplyDiffAnalysis.cpp b/lib/Pipes/ApplyDiffAnalysis.cpp
index a503f08e6..6824293ad 100644
--- a/lib/Pipes/ApplyDiffAnalysis.cpp
+++ b/lib/Pipes/ApplyDiffAnalysis.cpp
@@ -1,5 +1,4 @@
 /// \file ApplyDiffAnalysis.cpp
-/// \brief Pipes contains all the various pipes and kinds exposed by revng
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipes/IRHelpers.cpp b/lib/Pipes/IRHelpers.cpp
index 276d44fbe..720d4c4b3 100644
--- a/lib/Pipes/IRHelpers.cpp
+++ b/lib/Pipes/IRHelpers.cpp
@@ -1,5 +1,4 @@
 /// \file IRHelpers.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipes/PipelineManager.cpp b/lib/Pipes/PipelineManager.cpp
index 5fed4f58f..3118e655e 100644
--- a/lib/Pipes/PipelineManager.cpp
+++ b/lib/Pipes/PipelineManager.cpp
@@ -1,7 +1,7 @@
 /// \file PipelineManager.cpp
-/// \brief A pipeline manager ties up all the various bit and pieces of a
-/// pipeline into a single object that does not require the c api to ever need
-/// to expose a delete operator except for the global one.
+/// A pipeline manager ties up all the various bit and pieces of a pipeline into
+/// a single object that does not require the c api to ever need to expose a
+/// delete operator except for the global one.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipes/Pipes.cpp b/lib/Pipes/Pipes.cpp
index 3e5b64ebc..1ba4093ac 100644
--- a/lib/Pipes/Pipes.cpp
+++ b/lib/Pipes/Pipes.cpp
@@ -1,5 +1,5 @@
 /// \file Pipes.cpp
-/// \brief Pipes contains all the various pipes and kinds exposed by revng
+/// Contains the definition of the pipe registry.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipes/RootKind.cpp b/lib/Pipes/RootKind.cpp
index 79276798c..7f162da2b 100644
--- a/lib/Pipes/RootKind.cpp
+++ b/lib/Pipes/RootKind.cpp
@@ -1,5 +1,5 @@
 /// \file RootKind.cpp
-/// \brief the kind associated to non isolated root.
+/// The kind associated to non isolated root.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Pipes/TaggedFunctionKind.cpp b/lib/Pipes/TaggedFunctionKind.cpp
index a25fc4c4c..b4aad6443 100644
--- a/lib/Pipes/TaggedFunctionKind.cpp
+++ b/lib/Pipes/TaggedFunctionKind.cpp
@@ -1,5 +1,5 @@
 /// \file CompileModule.cpp
-/// \brief The isolated kind is used to rappresent isolated root and functions.
+/// The isolated kind is used to rappresent isolated root and functions.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Recompile/CompileModulePipe.cpp b/lib/Recompile/CompileModulePipe.cpp
index cefe64f45..a2b8412ae 100644
--- a/lib/Recompile/CompileModulePipe.cpp
+++ b/lib/Recompile/CompileModulePipe.cpp
@@ -1,5 +1,5 @@
 /// \file CompileModule.cpp
-/// \brief The compile module pipe transforma llvm module into a object file
+/// The compile module pipe transforms an llvm module into an object file.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Recompile/LinkForTranslation.cpp b/lib/Recompile/LinkForTranslation.cpp
index d30775af7..d29fe35da 100644
--- a/lib/Recompile/LinkForTranslation.cpp
+++ b/lib/Recompile/LinkForTranslation.cpp
@@ -1,5 +1,4 @@
 /// \file LinkForTranslation.cpp
-/// \brief implementation of link for translation
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Recompile/LinkForTranslationPipe.cpp b/lib/Recompile/LinkForTranslationPipe.cpp
index 13040a3f3..f10f12d59 100644
--- a/lib/Recompile/LinkForTranslationPipe.cpp
+++ b/lib/Recompile/LinkForTranslationPipe.cpp
@@ -1,6 +1,6 @@
 /// \file LinkForTranslation.cpp
-/// \brief the link for translation pipe is used to link object files into a
-/// executable
+/// The link for translation pipe is used to link object files into a
+/// executable.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/Assert.cpp b/lib/Support/Assert.cpp
index 46f93cad4..f1fa4a249 100644
--- a/lib/Support/Assert.cpp
+++ b/lib/Support/Assert.cpp
@@ -1,5 +1,5 @@
 /// \file Assert.cpp
-/// \brief Implementation of the various functions to assert and abort.
+/// Implementation of the various functions to assert and abort.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/BasicBlockID.cpp b/lib/Support/BasicBlockID.cpp
index c089866f5..1c47e1784 100644
--- a/lib/Support/BasicBlockID.cpp
+++ b/lib/Support/BasicBlockID.cpp
@@ -1,5 +1,4 @@
 /// \file BasicBlockID.cpp
-/// \brief Implementation of BasicBlockID.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/CommandLine.cpp b/lib/Support/CommandLine.cpp
index a86c24019..965508020 100644
--- a/lib/Support/CommandLine.cpp
+++ b/lib/Support/CommandLine.cpp
@@ -1,5 +1,4 @@
 /// \file CommandLine.cpp
-/// \brief Implementation of the debug framework
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/Debug.cpp b/lib/Support/Debug.cpp
index 002f244a5..258bcbbc6 100644
--- a/lib/Support/Debug.cpp
+++ b/lib/Support/Debug.cpp
@@ -1,5 +1,5 @@
 /// \file Debug.cpp
-/// \brief Implementation of the debug framework
+/// Implementation of the debug framework.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/ExampleAnalysis.cpp b/lib/Support/ExampleAnalysis.cpp
index b32ddc042..2fe237372 100644
--- a/lib/Support/ExampleAnalysis.cpp
+++ b/lib/Support/ExampleAnalysis.cpp
@@ -1,6 +1,5 @@
 /// \file ExampleAnalysis.cpp
-/// \brief Example of minimal data-flow analysis using the MonotoneFramework
-///        class
+/// Example of minimal data-flow analysis using the MonotoneFramework class.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/FunctionTags.cpp b/lib/Support/FunctionTags.cpp
index df8dbbd16..343a45543 100644
--- a/lib/Support/FunctionTags.cpp
+++ b/lib/Support/FunctionTags.cpp
@@ -1,5 +1,4 @@
 /// \file FunctionTags.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/IRAnnotators.cpp b/lib/Support/IRAnnotators.cpp
index d3f8d9038..fcd3b7303 100644
--- a/lib/Support/IRAnnotators.cpp
+++ b/lib/Support/IRAnnotators.cpp
@@ -1,5 +1,5 @@
 /// \file IRAnnotators.cpp
-/// \brief This file handles debugging information generation.
+/// This file handles debugging information generation.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/IRHelpers.cpp b/lib/Support/IRHelpers.cpp
index 0bfe4b46f..0f06349d2 100644
--- a/lib/Support/IRHelpers.cpp
+++ b/lib/Support/IRHelpers.cpp
@@ -1,5 +1,5 @@
 /// \file IRHelpers.cpp
-/// \brief Implementation of IR helper functions
+/// Implementation of IR helper functions.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/LDDTree.cpp b/lib/Support/LDDTree.cpp
index f6a0e5ccd..4d79075ce 100644
--- a/lib/Support/LDDTree.cpp
+++ b/lib/Support/LDDTree.cpp
@@ -1,5 +1,5 @@
 /// \file LDDTree.cpp
-/// \brief Implementation of lddtree like API
+/// Implementation of lddtree like API.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/MetaAddress.cpp b/lib/Support/MetaAddress.cpp
index fe3ec4654..df8b09e55 100644
--- a/lib/Support/MetaAddress.cpp
+++ b/lib/Support/MetaAddress.cpp
@@ -1,5 +1,4 @@
 /// \file MetaAddress.cpp
-/// \brief Implementation of MetaAddress.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/ModuleStatistics.cpp b/lib/Support/ModuleStatistics.cpp
index d4850e1a5..f7d6c22bb 100644
--- a/lib/Support/ModuleStatistics.cpp
+++ b/lib/Support/ModuleStatistics.cpp
@@ -1,5 +1,4 @@
 /// \file ModuleStatistics.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/OriginalAssemblyAnnotationWriter.cpp b/lib/Support/OriginalAssemblyAnnotationWriter.cpp
index 8b49f8978..2e2e04278 100644
--- a/lib/Support/OriginalAssemblyAnnotationWriter.cpp
+++ b/lib/Support/OriginalAssemblyAnnotationWriter.cpp
@@ -1,5 +1,5 @@
 /// \file OriginalAssemblyAnnotationWriter.cpp
-/// \brief This file handles debugging information generation.
+/// This file handles debugging information generation.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/ProgramCounterHandler.cpp b/lib/Support/ProgramCounterHandler.cpp
index 6ab219fef..3d4f3a111 100644
--- a/lib/Support/ProgramCounterHandler.cpp
+++ b/lib/Support/ProgramCounterHandler.cpp
@@ -1,5 +1,4 @@
 /// \file ProgramCounterHandler.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/ProgramRunner.cpp b/lib/Support/ProgramRunner.cpp
index fa1afc63b..78f3619a6 100644
--- a/lib/Support/ProgramRunner.cpp
+++ b/lib/Support/ProgramRunner.cpp
@@ -1,6 +1,6 @@
 /// \file ProgramRunner.cpp
-/// \brief a program runner is used to invoke external programs a bit more
-/// safelly than to compose a string and invoke system
+/// A program runner is used to invoke external programs a bit more safelly than
+/// to compose a string and invoke system.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/SelfReferencingDbgAnnotationWriter.cpp b/lib/Support/SelfReferencingDbgAnnotationWriter.cpp
index 5d614aabd..4e9355129 100644
--- a/lib/Support/SelfReferencingDbgAnnotationWriter.cpp
+++ b/lib/Support/SelfReferencingDbgAnnotationWriter.cpp
@@ -1,5 +1,5 @@
 /// \file SelfReferencingDbgAnnotationWriter.cpp
-/// \brief This file handles debugging information generation.
+/// This file handles debugging information generation.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Support/Statistics.cpp b/lib/Support/Statistics.cpp
index 816cbd2ec..3b9653fb5 100644
--- a/lib/Support/Statistics.cpp
+++ b/lib/Support/Statistics.cpp
@@ -1,5 +1,5 @@
 /// \file Statistics.cpp
-/// \brief Implementation of the statistics collection framework
+/// Implementation of the statistics collection framework.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/TypeShrinking/BitLiveness.cpp b/lib/TypeShrinking/BitLiveness.cpp
index b0db1fdc7..c92ba8227 100644
--- a/lib/TypeShrinking/BitLiveness.cpp
+++ b/lib/TypeShrinking/BitLiveness.cpp
@@ -1,5 +1,6 @@
 /// \file BitLiveness.cpp
-/// \brief In this file we model the transfer functions for the analysis.
+/// In this file we model the transfer functions for the analysis.
+///
 /// Each transfer function models the information flow of a function or of
 /// a special case of an instruction.
 /// In our case, `R = transferXyz(Ins, E)` means that for the instruction Ins
diff --git a/lib/TypeShrinking/DataFlowGraph.cpp b/lib/TypeShrinking/DataFlowGraph.cpp
index 3c8d25ac8..16a622716 100644
--- a/lib/TypeShrinking/DataFlowGraph.cpp
+++ b/lib/TypeShrinking/DataFlowGraph.cpp
@@ -1,5 +1,4 @@
 /// \file DataFlowGraph.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/TypeShrinking/TypeShrinking.cpp b/lib/TypeShrinking/TypeShrinking.cpp
index 40e1ce3be..897d7a9d1 100644
--- a/lib/TypeShrinking/TypeShrinking.cpp
+++ b/lib/TypeShrinking/TypeShrinking.cpp
@@ -1,5 +1,5 @@
 /// \file TypeShrinking.cpp
-/// \brief This analysis finds which bits of each Instruction is alive
+/// This analysis finds which bits of each Instruction is alive.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/UnitTestHelpers/DotGraphObject.cpp b/lib/UnitTestHelpers/DotGraphObject.cpp
index 84ff831fd..ce584e5d5 100644
--- a/lib/UnitTestHelpers/DotGraphObject.cpp
+++ b/lib/UnitTestHelpers/DotGraphObject.cpp
@@ -1,5 +1,4 @@
 /// \file DotGraphObject.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/ValueMaterializer/AdvancedValueInfo.cpp b/lib/ValueMaterializer/AdvancedValueInfo.cpp
index 6385e9f90..e0f8f8404 100644
--- a/lib/ValueMaterializer/AdvancedValueInfo.cpp
+++ b/lib/ValueMaterializer/AdvancedValueInfo.cpp
@@ -1,5 +1,4 @@
 /// \file AdvanedValueInfo.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/ValueMaterializer/ControlFlowEdgesGraph.cpp b/lib/ValueMaterializer/ControlFlowEdgesGraph.cpp
index 288fb200d..48d709747 100644
--- a/lib/ValueMaterializer/ControlFlowEdgesGraph.cpp
+++ b/lib/ValueMaterializer/ControlFlowEdgesGraph.cpp
@@ -1,5 +1,4 @@
 /// \file ControlFlowEdgesGraph.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/ValueMaterializer/DataFlowGraph.cpp b/lib/ValueMaterializer/DataFlowGraph.cpp
index e852a9b1f..9fffbd9f8 100644
--- a/lib/ValueMaterializer/DataFlowGraph.cpp
+++ b/lib/ValueMaterializer/DataFlowGraph.cpp
@@ -1,5 +1,4 @@
 /// \file DataFlowGraph.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/ValueMaterializer/ValueMaterializer.cpp b/lib/ValueMaterializer/ValueMaterializer.cpp
index 7103e43bd..9fa835299 100644
--- a/lib/ValueMaterializer/ValueMaterializer.cpp
+++ b/lib/ValueMaterializer/ValueMaterializer.cpp
@@ -1,5 +1,4 @@
 /// \file ValueMaterializer.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/Assembly/DisassemblyHelper.cpp b/lib/Yield/Assembly/DisassemblyHelper.cpp
index b029951ca..eec97a461 100644
--- a/lib/Yield/Assembly/DisassemblyHelper.cpp
+++ b/lib/Yield/Assembly/DisassemblyHelper.cpp
@@ -1,5 +1,4 @@
 /// \file DisassemblyHelper.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/Assembly/LLVMDisassemblerInterface.cpp b/lib/Yield/Assembly/LLVMDisassemblerInterface.cpp
index 0f0e98d14..e616f93bd 100644
--- a/lib/Yield/Assembly/LLVMDisassemblerInterface.cpp
+++ b/lib/Yield/Assembly/LLVMDisassemblerInterface.cpp
@@ -1,5 +1,4 @@
 /// \file LLVMDisassemblerInterface.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/CallGraphs/CallGraphSlices.cpp b/lib/Yield/CallGraphs/CallGraphSlices.cpp
index a66267f1f..d432f9a8c 100644
--- a/lib/Yield/CallGraphs/CallGraphSlices.cpp
+++ b/lib/Yield/CallGraphs/CallGraphSlices.cpp
@@ -1,5 +1,4 @@
 /// \file Slices.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/ControlFlow/ConvertFromEFA.cpp b/lib/Yield/ControlFlow/ConvertFromEFA.cpp
index e1fff922c..2ae8ec3b9 100644
--- a/lib/Yield/ControlFlow/ConvertFromEFA.cpp
+++ b/lib/Yield/ControlFlow/ConvertFromEFA.cpp
@@ -1,5 +1,4 @@
 /// \file ConvertFromEFA.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/ControlFlow/Extraction.cpp b/lib/Yield/ControlFlow/Extraction.cpp
index f364ef17b..6154d4406 100644
--- a/lib/Yield/ControlFlow/Extraction.cpp
+++ b/lib/Yield/ControlFlow/Extraction.cpp
@@ -1,5 +1,4 @@
 /// \file Extraction.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/ControlFlow/FallthroughDetection.cpp b/lib/Yield/ControlFlow/FallthroughDetection.cpp
index 40b0e88bb..ddad22243 100644
--- a/lib/Yield/ControlFlow/FallthroughDetection.cpp
+++ b/lib/Yield/ControlFlow/FallthroughDetection.cpp
@@ -1,5 +1,4 @@
 /// \file FallthroughDetection.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/ControlFlow/NodeSizeCalculation.cpp b/lib/Yield/ControlFlow/NodeSizeCalculation.cpp
index 4667e1cab..659e8105d 100644
--- a/lib/Yield/ControlFlow/NodeSizeCalculation.cpp
+++ b/lib/Yield/ControlFlow/NodeSizeCalculation.cpp
@@ -1,5 +1,4 @@
 /// \file NodeSizeCalculation.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/CrossRelations.cpp b/lib/Yield/CrossRelations.cpp
index b90e147b0..9297d790f 100644
--- a/lib/Yield/CrossRelations.cpp
+++ b/lib/Yield/CrossRelations.cpp
@@ -1,5 +1,4 @@
 /// \file CallGraph.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/Dump.cpp b/lib/Yield/Dump.cpp
index f8b830a03..18d8a1a10 100644
--- a/lib/Yield/Dump.cpp
+++ b/lib/Yield/Dump.cpp
@@ -1,5 +1,4 @@
 /// \file Dump.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/PTML.cpp b/lib/Yield/PTML.cpp
index 2df158326..556e4dc2e 100644
--- a/lib/Yield/PTML.cpp
+++ b/lib/Yield/PTML.cpp
@@ -1,10 +1,9 @@
+/// \file PTML.cpp
+
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
 //
 
-/// \file PTML.cpp
-/// \brief
-
 #include <unordered_map>
 
 #include "llvm/ADT/PostOrderIterator.h"
diff --git a/lib/Yield/Plain.cpp b/lib/Yield/Plain.cpp
index a3163b0ac..8d0e2fb5c 100644
--- a/lib/Yield/Plain.cpp
+++ b/lib/Yield/Plain.cpp
@@ -1,5 +1,4 @@
 /// \file Plain.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/SVG.cpp b/lib/Yield/SVG.cpp
index 7636b9dff..24c00ce36 100644
--- a/lib/Yield/SVG.cpp
+++ b/lib/Yield/SVG.cpp
@@ -1,5 +1,4 @@
 /// \file SVG.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/lib/Yield/Verify.cpp b/lib/Yield/Verify.cpp
index b63451d1b..42b773b4a 100644
--- a/lib/Yield/Verify.cpp
+++ b/lib/Yield/Verify.cpp
@@ -1,5 +1,4 @@
 /// \file Verify.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/abi/tools/revng-check-compatibility-with-abi/ABIArtifactParser.cpp b/tests/abi/tools/revng-check-compatibility-with-abi/ABIArtifactParser.cpp
index 46943117a..e422eb02c 100644
--- a/tests/abi/tools/revng-check-compatibility-with-abi/ABIArtifactParser.cpp
+++ b/tests/abi/tools/revng-check-compatibility-with-abi/ABIArtifactParser.cpp
@@ -1,5 +1,4 @@
 /// \file Verify.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/abi/tools/revng-check-compatibility-with-abi/Main.cpp b/tests/abi/tools/revng-check-compatibility-with-abi/Main.cpp
index 22c4f2172..1c678080d 100644
--- a/tests/abi/tools/revng-check-compatibility-with-abi/Main.cpp
+++ b/tests/abi/tools/revng-check-compatibility-with-abi/Main.cpp
@@ -1,12 +1,9 @@
-//
-// This file is distributed under the MIT License. See LICENSE.md for details.
-//
-
 /// \file Main.cpp
-/// \brief This tool is used for ABI conversion testing. It's purpose is to
-/// make sure that the function still corresponds to the intended ABI no matter
-/// what kind of work was done on top of it. It works with both
-/// `RawFunctionType` and `CABIFunctionType`.
+/// This tool is used for ABI conversion testing.
+///
+/// It's purpose is to make sure that the function still corresponds to the
+/// intended ABI no matter what kind of work was done on top of it. It works
+/// with both `RawFunctionType` and `CABIFunctionType`.
 ///
 /// \note: This tool requires a runtime abi artifact. It can be obtained using
 /// revng-qa. For more information see the corresponding repository.
diff --git a/tests/abi/tools/revng-check-compatibility-with-abi/Verify.cpp b/tests/abi/tools/revng-check-compatibility-with-abi/Verify.cpp
index 8943bfa64..23c99c6d2 100644
--- a/tests/abi/tools/revng-check-compatibility-with-abi/Verify.cpp
+++ b/tests/abi/tools/revng-check-compatibility-with-abi/Verify.cpp
@@ -1,5 +1,4 @@
 /// \file Verify.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/abi/tools/revng-ensure-rft-equivalence/Main.cpp b/tests/abi/tools/revng-ensure-rft-equivalence/Main.cpp
index aef3988ab..f3c2d10ed 100644
--- a/tests/abi/tools/revng-ensure-rft-equivalence/Main.cpp
+++ b/tests/abi/tools/revng-ensure-rft-equivalence/Main.cpp
@@ -1,10 +1,6 @@
-//
-// This file is distributed under the MIT License. See LICENSE.md for details.
-//
-
 /// \file Main.cpp
-/// \brief This tool is a specialized `revng model diff` extension designed
-/// to work around the shortcomings of the abi testing pipeline.
+/// This tool is a specialized `revng model diff` extension designed to work
+/// around the shortcomings of the abi testing pipeline.
 ///
 /// It takes two models and produces a diff (and a non-zero exit code) if
 /// they are not equivalent.
@@ -13,6 +9,10 @@
 /// `model::purgeUnnamedAndUnreachableTypes` on both models and also
 /// specifically handles the IDs of `RawFunctionType`'s stack arguments.
 
+//
+// This file is distributed under the MIT License. See LICENSE.md for details.
+//
+
 #include <string>
 #include <unordered_set>
 
diff --git a/tests/pipeline/BadBehaviorLibrary.cpp b/tests/pipeline/BadBehaviorLibrary.cpp
index 677164a24..772cf2218 100644
--- a/tests/pipeline/BadBehaviorLibrary.cpp
+++ b/tests/pipeline/BadBehaviorLibrary.cpp
@@ -1,6 +1,6 @@
 /// \file BadBehaviorLibrary.cpp
-/// \brief This file, when compiled into a library, crashes in a manner
-/// configured in the environment variables.
+/// This file, when compiled into a library, crashes in a manner configured in
+/// the environment variables.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/pipeline/StringContainerLibrary.cpp b/tests/pipeline/StringContainerLibrary.cpp
index 522cbb2ce..d2978ab65 100644
--- a/tests/pipeline/StringContainerLibrary.cpp
+++ b/tests/pipeline/StringContainerLibrary.cpp
@@ -1,5 +1,5 @@
 /// \file StringContainerLibrary.cpp
-/// \brief the kind associated to non isolated root.
+/// The kind associated with non isolated root.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/AdvancedValueInfo.cpp b/tests/unit/AdvancedValueInfo.cpp
index 4c6537bb2..3faca919e 100644
--- a/tests/unit/AdvancedValueInfo.cpp
+++ b/tests/unit/AdvancedValueInfo.cpp
@@ -1,5 +1,4 @@
 /// \file AdvancedValueInfo.cpp
-/// \brief Test the AdvancedValueInfo analysis
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/ClassSentinel.cpp b/tests/unit/ClassSentinel.cpp
index 9fbb62b4f..2da787b75 100644
--- a/tests/unit/ClassSentinel.cpp
+++ b/tests/unit/ClassSentinel.cpp
@@ -1,5 +1,4 @@
 /// \file ClassSentinel.cpp
-/// \brief Tests for ClassSentinel
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/ConstantRangeSet.cpp b/tests/unit/ConstantRangeSet.cpp
index b81a37e0c..da7c50685 100644
--- a/tests/unit/ConstantRangeSet.cpp
+++ b/tests/unit/ConstantRangeSet.cpp
@@ -1,5 +1,4 @@
 /// \file ConstantrangeSet.cpp
-/// \brief Tests for ConstantrangeSet
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/DiffInvalidationEvent.cpp b/tests/unit/DiffInvalidationEvent.cpp
index ca5427860..a98c82757 100644
--- a/tests/unit/DiffInvalidationEvent.cpp
+++ b/tests/unit/DiffInvalidationEvent.cpp
@@ -1,5 +1,5 @@
 /// \file DiffInvalidationEvent.cpp
-/// \brief Tests for C API of revng-pipeline
+/// Tests for C API of revng-pipeline.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/FilteredGraphTraits.cpp b/tests/unit/FilteredGraphTraits.cpp
index a10545bcb..ea9de5ec1 100644
--- a/tests/unit/FilteredGraphTraits.cpp
+++ b/tests/unit/FilteredGraphTraits.cpp
@@ -1,5 +1,5 @@
 /// \file FilteredGraphTraits.cpp
-/// \brief Tests for the FilteredGraphTraits template
+/// Tests for the FilteredGraphTraits template.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/GenericGraph.cpp b/tests/unit/GenericGraph.cpp
index 9f11103c6..12e2524fe 100644
--- a/tests/unit/GenericGraph.cpp
+++ b/tests/unit/GenericGraph.cpp
@@ -1,5 +1,4 @@
 /// \file GenericGraph.cpp
-/// \brief Test the GenericGraph
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/GraphAlgorithms.cpp b/tests/unit/GraphAlgorithms.cpp
index b912523cf..2d2831143 100644
--- a/tests/unit/GraphAlgorithms.cpp
+++ b/tests/unit/GraphAlgorithms.cpp
@@ -1,5 +1,4 @@
 /// \file GraphAlgorithms.cpp
-/// \brief Test the GraphAlgorithms utils
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/IRHelpers.cpp b/tests/unit/IRHelpers.cpp
index abc2d9489..e8e19e7a2 100644
--- a/tests/unit/IRHelpers.cpp
+++ b/tests/unit/IRHelpers.cpp
@@ -1,5 +1,4 @@
 /// \file IRHelpers.cpp
-/// \brief Tests for IRHelpers
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/InstantiatePasses.cpp b/tests/unit/InstantiatePasses.cpp
index 2441a03d6..a81fc32fa 100644
--- a/tests/unit/InstantiatePasses.cpp
+++ b/tests/unit/InstantiatePasses.cpp
@@ -1,5 +1,4 @@
 /// \file InstantiatePasses.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/KeyedObjectsContainers.cpp b/tests/unit/KeyedObjectsContainers.cpp
index 2ab5206d8..f65406666 100644
--- a/tests/unit/KeyedObjectsContainers.cpp
+++ b/tests/unit/KeyedObjectsContainers.cpp
@@ -1,5 +1,5 @@
 /// \file KeyedObjectsContainers.cpp
-/// \brief Tests for MutableSet and SortedVector
+/// Tests for MutableSet and SortedVector.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/LazySmallBitVector.cpp b/tests/unit/LazySmallBitVector.cpp
index 1ed54b7ad..8d848e209 100644
--- a/tests/unit/LazySmallBitVector.cpp
+++ b/tests/unit/LazySmallBitVector.cpp
@@ -1,5 +1,4 @@
 /// \file LazySmallBitVector.cpp
-/// \brief Tests for LazySmallBitVector
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/MetaAddress.cpp b/tests/unit/MetaAddress.cpp
index b3ec9737a..1e9c2e23c 100644
--- a/tests/unit/MetaAddress.cpp
+++ b/tests/unit/MetaAddress.cpp
@@ -1,5 +1,4 @@
 /// \file MetaAddress.cpp
-/// \brief Tests for MetaAddress
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/Model.cpp b/tests/unit/Model.cpp
index 191dc2d94..82cc1f9e6 100644
--- a/tests/unit/Model.cpp
+++ b/tests/unit/Model.cpp
@@ -1,5 +1,4 @@
 /// \file Model.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/Pipeline.cpp b/tests/unit/Pipeline.cpp
index 3d0e45ae9..ec5834760 100644
--- a/tests/unit/Pipeline.cpp
+++ b/tests/unit/Pipeline.cpp
@@ -1,5 +1,4 @@
 /// \file Pipeline.cpp
-/// \brief Tests for revng-pipeline
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/PipelineC.cpp b/tests/unit/PipelineC.cpp
index 0fc8ee3fb..94c2351b0 100644
--- a/tests/unit/PipelineC.cpp
+++ b/tests/unit/PipelineC.cpp
@@ -1,5 +1,5 @@
 /// \file Pipeline.cpp
-/// \brief Tests for C API of revng-pipeline
+/// Tests for C API of revng-pipeline.
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/ShrinkInstructionOperandsPass.cpp b/tests/unit/ShrinkInstructionOperandsPass.cpp
index 01a9b8411..99270eb2a 100644
--- a/tests/unit/ShrinkInstructionOperandsPass.cpp
+++ b/tests/unit/ShrinkInstructionOperandsPass.cpp
@@ -1,5 +1,4 @@
 /// \file ShrinkInstructionOperandsPass.cpp
-/// \brief Tests for ShrinkInstructionOperandsPass
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/SmallMap.cpp b/tests/unit/SmallMap.cpp
index 5f7974a7f..b34480815 100644
--- a/tests/unit/SmallMap.cpp
+++ b/tests/unit/SmallMap.cpp
@@ -1,5 +1,4 @@
 /// \file SmallMap.cpp
-/// \brief Tests for SmallMap
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/UpcastablePointer.cpp b/tests/unit/UpcastablePointer.cpp
index 1b4880399..4172e822f 100644
--- a/tests/unit/UpcastablePointer.cpp
+++ b/tests/unit/UpcastablePointer.cpp
@@ -1,5 +1,4 @@
 /// \file UpcastablePointer.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tests/unit/ZipMapIterator.cpp b/tests/unit/ZipMapIterator.cpp
index 6eb3bd312..406d8fafe 100644
--- a/tests/unit/ZipMapIterator.cpp
+++ b/tests/unit/ZipMapIterator.cpp
@@ -1,5 +1,4 @@
 /// \file ZipMapIterator.cpp
-/// \brief Tests for ZipMapIterator
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tools/model/apply/Main.cpp b/tools/model/apply/Main.cpp
index 9c1e4876e..b6735d367 100644
--- a/tools/model/apply/Main.cpp
+++ b/tools/model/apply/Main.cpp
@@ -1,5 +1,4 @@
 /// \file Main.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tools/model/diff/Main.cpp b/tools/model/diff/Main.cpp
index 9e5966312..4ae589a99 100644
--- a/tools/model/diff/Main.cpp
+++ b/tools/model/diff/Main.cpp
@@ -1,5 +1,4 @@
 /// \file Main.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tools/model/dump/Main.cpp b/tools/model/dump/Main.cpp
index c257a1a09..28645718c 100644
--- a/tools/model/dump/Main.cpp
+++ b/tools/model/dump/Main.cpp
@@ -1,5 +1,4 @@
 /// \file Main.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tools/model/import/binary/Main.cpp b/tools/model/import/binary/Main.cpp
index f9fe7b557..2850a0ad4 100644
--- a/tools/model/import/binary/Main.cpp
+++ b/tools/model/import/binary/Main.cpp
@@ -1,5 +1,4 @@
 /// \file Main.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tools/model/import/debug-info/Main.cpp b/tools/model/import/debug-info/Main.cpp
index 9c58685d4..ee200017a 100644
--- a/tools/model/import/debug-info/Main.cpp
+++ b/tools/model/import/debug-info/Main.cpp
@@ -1,5 +1,4 @@
 /// \file Main.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tools/model/inject/Main.cpp b/tools/model/inject/Main.cpp
index bb55b7446..384fc4281 100644
--- a/tools/model/inject/Main.cpp
+++ b/tools/model/inject/Main.cpp
@@ -1,5 +1,4 @@
 /// \file Main.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.
diff --git a/tools/model/opt/Main.cpp b/tools/model/opt/Main.cpp
index 69839af55..babffded6 100644
--- a/tools/model/opt/Main.cpp
+++ b/tools/model/opt/Main.cpp
@@ -1,5 +1,4 @@
 /// \file Main.cpp
-/// \brief
 
 //
 // This file is distributed under the MIT License. See LICENSE.md for details.