From fd89894ae3c7709470f73728ad47453c2fc623a2 Mon Sep 17 00:00:00 2001
From: Chandler Carruth <chandlerc@gmail.com>
Date: Thu, 15 Jan 2015 03:51:04 +0000
Subject: [PATCH] [PM] Clean up the TLI doxygen comments prior to refactoring
 this code for the new pass manager.

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@226089 91177308-0d34-0410-b5e6-96231b3b80d8
---
 include/llvm/Analysis/TargetLibraryInfo.h | 32 ++++++++++++++---------
 1 file changed, 19 insertions(+), 13 deletions(-)

diff --git a/include/llvm/Analysis/TargetLibraryInfo.h b/include/llvm/Analysis/TargetLibraryInfo.h
index 5a35ca01957..9c6bfdba3a1 100644
--- a/include/llvm/Analysis/TargetLibraryInfo.h
+++ b/include/llvm/Analysis/TargetLibraryInfo.h
@@ -692,9 +692,11 @@ namespace llvm {
     };
   }
 
-/// TargetLibraryInfo - This immutable pass captures information about what
-/// library functions are available for the current target, and allows a
-/// frontend to disable optimizations through -fno-builtin etc.
+/// \brief Provides information about what library functions are available for
+/// the current target.
+///
+/// This both allows optimizations to handle them specially and frontends to
+/// disable such optimizations through -fno-builtin etc.
 class TargetLibraryInfo : public ImmutablePass {
   virtual void anchor();
   unsigned char AvailableArray[(LibFunc::NumLibFuncs+3)/4];
@@ -720,18 +722,19 @@ public:
   TargetLibraryInfo(const Triple &T);
   explicit TargetLibraryInfo(const TargetLibraryInfo &TLI);
 
-  /// getLibFunc - Search for a particular function name.  If it is one of the
-  /// known library functions, return true and set F to the corresponding value.
+  /// \brief Searches for a particular function name.
+  ///
+  /// If it is one of the known library functions, return true and set F to the
+  /// corresponding value.
   bool getLibFunc(StringRef funcName, LibFunc::Func &F) const;
 
-  /// has - This function is used by optimizations that want to match on or form
-  /// a given library function.
+  /// \brief Tests wether a library function is available.
   bool has(LibFunc::Func F) const {
     return getState(F) != Unavailable;
   }
 
-  /// hasOptimizedCodeGen - Return true if the function is both available as
-  /// a builtin and a candidate for optimized code generation.
+  /// \brief Tests if the function is both available and a candidate for
+  /// optimized code generation.
   bool hasOptimizedCodeGen(LibFunc::Func F) const {
     if (getState(F) == Unavailable)
       return false;
@@ -772,16 +775,18 @@ public:
     return CustomNames.find(F)->second;
   }
 
-  /// setUnavailable - this can be used by whatever sets up TargetLibraryInfo to
-  /// ban use of specific library functions.
+  /// \brief Forces a function to be marked as unavailable.
   void setUnavailable(LibFunc::Func F) {
     setState(F, Unavailable);
   }
 
+  /// \brief Forces a function to be marked as available.
   void setAvailable(LibFunc::Func F) {
     setState(F, StandardName);
   }
 
+  /// \brief Forces a function to be marked as available and provide an
+  /// alternate name that must be used.
   void setAvailableWithName(LibFunc::Func F, StringRef Name) {
     if (StandardNames[F] != Name) {
       setState(F, CustomName);
@@ -792,8 +797,9 @@ public:
     }
   }
 
-  /// disableAllFunctions - This disables all builtins, which is used for
-  /// options like -fno-builtin.
+  /// \brief Disables all builtins.
+  ///
+  /// This can be used for options like -fno-builtin.
   void disableAllFunctions();
 };
 
-- 
2.34.1