Fix some comments.

llvm-svn: 77531

clang/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);

clang/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.

clang/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;