Comment cleanup. Don't repeat the function name in the comment.

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

include/llvm/Target/TargetLoweringObjectFile.h

@@ -48,78 +48,76 @@ public:
 
   virtual ~TargetLoweringObjectFile();
 
-  /// Initialize - this method must be called before any actual lowering is
+  /// This method must be called before any actual lowering is done.  This
-  /// done.  This specifies the current context for codegen, and gives the
+  /// specifies the current context for codegen, and gives the lowering
-  /// lowering implementations a chance to set up their default sections.
+  /// implementations a chance to set up their default sections.
   virtual void Initialize(MCContext &ctx, const TargetMachine &TM);
 
   virtual void emitPersonalityValue(MCStreamer &Streamer,
                                     const TargetMachine &TM,
                                     const MCSymbol *Sym) const;
 
-  /// getDepLibFromLinkerOpt - Extract the dependent library name from a linker
+  /// Extract the dependent library name from a linker option string. Returns
-  /// option string. Returns StringRef() if the option does not specify a library.
+  /// StringRef() if the option does not specify a library.
   virtual StringRef getDepLibFromLinkerOpt(StringRef LinkerOption) const {
     return StringRef();
   }
 
-  /// emitModuleFlags - Emit the module flags that the platform cares about.
+  /// Emit the module flags that the platform cares about.
   virtual void emitModuleFlags(MCStreamer &,
                                ArrayRef<Module::ModuleFlagEntry>,
                                Mangler *, const TargetMachine &) const {
   }
 
-  /// shouldEmitUsedDirectiveFor - This hook allows targets to selectively
+  /// This hook allows targets to selectively decide not to emit the
-  /// decide not to emit the UsedDirective for some symbols in llvm.used.
+  /// UsedDirective for some symbols in llvm.used.
   /// FIXME: REMOVE this (rdar://7071300)
   virtual bool shouldEmitUsedDirectiveFor(const GlobalValue *GV,
                                           Mangler *) const {
     return GV != 0;
   }
 
-  /// getSectionForConstant - Given a constant with the SectionKind, return a
+  /// Given a constant with the SectionKind, return a section that it should be
-  /// section that it should be placed in.
+  /// placed in.
   virtual const MCSection *getSectionForConstant(SectionKind Kind) const;
 
-  /// getKindForGlobal - Classify the specified global variable into a set of
+  /// Classify the specified global variable into a set of target independent
-  /// target independent categories embodied in SectionKind.
+  /// categories embodied in SectionKind.
   static SectionKind getKindForGlobal(const GlobalValue *GV,
                                       const TargetMachine &TM);
 
-  /// SectionForGlobal - This method computes the appropriate section to emit
+  /// This method computes the appropriate section to emit the specified global
-  /// the specified global variable or function definition.  This should not
+  /// variable or function definition. This should not be passed external (or
-  /// be passed external (or available externally) globals.
+  /// available externally) globals.
   const MCSection *SectionForGlobal(const GlobalValue *GV,
                                     SectionKind Kind, Mangler *Mang,
                                     const TargetMachine &TM) const;
 
-  /// SectionForGlobal - This method computes the appropriate section to emit
+  /// This method computes the appropriate section to emit the specified global
-  /// the specified global variable or function definition.  This should not
+  /// variable or function definition. This should not be passed external (or
-  /// be passed external (or available externally) globals.
+  /// available externally) globals.
   const MCSection *SectionForGlobal(const GlobalValue *GV,
                                     Mangler *Mang,
                                     const TargetMachine &TM) const {
     return SectionForGlobal(GV, getKindForGlobal(GV, TM), Mang, TM);
   }
 
-  /// getExplicitSectionGlobal - Targets should implement this method to assign
+  /// Targets should implement this method to assign a section to globals with
-  /// a section to globals with an explicit section specfied.  The
+  /// an explicit section specfied. The implementation of this method can
-  /// implementation of this method can assume that GV->hasSection() is true.
+  /// assume that GV->hasSection() is true.
   virtual const MCSection *
   getExplicitSectionGlobal(const GlobalValue *GV, SectionKind Kind,
                            Mangler *Mang, const TargetMachine &TM) const = 0;
 
-  /// getSpecialCasedSectionGlobals - Allow the target to completely override
+  /// Allow the target to completely override section assignment of a global.
-  /// section assignment of a global.
   virtual const MCSection *
   getSpecialCasedSectionGlobals(const GlobalValue *GV, Mangler *Mang,
                                 SectionKind Kind) const {
     return 0;
   }
 
-  /// getTTypeGlobalReference - Return an MCExpr to use for a reference
+  /// Return an MCExpr to use for a reference to the specified global variable
-  /// to the specified global variable from exception handling information.
+  /// from exception handling information.
-  ///
   virtual const MCExpr *
   getTTypeGlobalReference(const GlobalValue *GV, Mangler *Mang,
                           MachineModuleInfo *MMI, unsigned Encoding,
@@ -134,12 +132,11 @@ public:
   MCSymbol *getSymbolWithGlobalValueBase(Mangler &M, const GlobalValue *GV,
                                          StringRef Suffix) const;
 
-  // getCFIPersonalitySymbol - The symbol that gets passed to .cfi_personality.
+  // The symbol that gets passed to .cfi_personality.
   virtual MCSymbol *
   getCFIPersonalitySymbol(const GlobalValue *GV, Mangler *Mang,
                           MachineModuleInfo *MMI) const;
 
-  ///
   const MCExpr *
   getTTypeReference(const MCSymbolRefExpr *Sym, unsigned Encoding,
                     MCStreamer &Streamer) const;