Fix some comments.

git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@77531 91177308-0d34-0410-b5e6-96231b3b80d8

3 files changed, 3 insertions, 4 deletions

diff --git a/include/clang/Index/DeclReferenceMap.h b/include/clang/Index/DeclReferenceMap.h
index 130ca387d5..d1e2c09e98 100644
--- a/include/clang/Index/DeclReferenceMap.h
+++ b/include/clang/Index/DeclReferenceMap.h
@@ -26,8 +26,7 @@ namespace idx {
   
 /// \brief Maps NamedDecls with the ASTLocations that reference them.
 ///
-/// References are mapped and retrieved using the primary decls
-/// (see Decl::getPrimaryDecl()).
+/// References are mapped and retrieved using the canonical decls.
 class DeclReferenceMap {
 public:
   explicit DeclReferenceMap(ASTContext &Ctx);
diff --git a/include/clang/Index/Entity.h b/include/clang/Index/Entity.h
index 2b5adc6882..283f55276e 100644
--- a/include/clang/Index/Entity.h
+++ b/include/clang/Index/Entity.h
@@ -61,7 +61,7 @@ public:
   std::string getPrintableName() const;
 
   /// \brief Get an Entity associated with the given Decl.
-  /// \returns Null if an Entity cannot refer to this Decl.
+  /// \returns invalid Entity if an Entity cannot refer to this Decl.
   static Entity get(Decl *D, Program &Prog);
 
   /// \brief true if the Entity is not visible outside the trasnlation unit.
diff --git a/include/clang/Index/Program.h b/include/clang/Index/Program.h
index 2605bb685a..b2bdaa6c2e 100644
--- a/include/clang/Index/Program.h
+++ b/include/clang/Index/Program.h
@@ -20,7 +20,7 @@ namespace clang {
 namespace idx {
   class EntityHandler;
 
-/// idx::Program is the top level object that owns and maintains information
+/// \brief Top level object that owns and maintains information
 /// that is common across translation units.
 class Program {
   void *Impl;