[gardening] Fixup a couple of doxygen comments.

Author: gottesmm

include/swift/SILOptimizer/Analysis/Analysis.h

@@ -83,14 +83,13 @@ class SILAnalysis : public DeleteNotificationHandler {
   bool invalidationLock;
 
 public:
-
   /// Returns the kind of derived class.
   AnalysisKind getKind() const { return kind; }
 
-  /// C'tor.
+  /// Constructor.
   SILAnalysis(AnalysisKind k) : kind(k), invalidationLock(false) {}
 
-  /// D'tor.
+  /// Destructor.
   virtual ~SILAnalysis() {}
 
   /// Can be used to retrieve other analysis passes from \p PM, which this
@@ -137,10 +136,12 @@ class SILAnalysis : public DeleteNotificationHandler {
   static void verifyFunction(SILFunction *F);
 };
 
-// RAII helper for locking analyses.
+/// RAII helper for locking analyses. Locks the analysis upon construction and
+/// unlocks upon destruction.
 class AnalysisPreserver {
   SILAnalysis *analysis;
-  public:
+
+public:
   AnalysisPreserver(SILAnalysis *a) : analysis(a) {
     analysis->lockInvalidation();
   }