[Parse] Document PrintStats, SkipFunctionBodies

[modocache]

Summary

Add documentation for clang::ParseAST parameters PrintStats and
SkipFunctionBodies. Also, remove a tiny bit of trailing whitespace.

[craig.topper]

Guessing I'm only on here because I did the bulk of the 0->nullptr changes to clang a few years back.

[modocache]

Oops, sorry. I couldn't find anyone recent in the commit history. I hope no one minds if I just go ahead and commit this.

[arphaman]

Generally such NFC patches can be committed directly as they can be reviewed after the commit

[doug.gregor]

LGTM, thank you!

cfe/trunk/include/clang/Parse/ParseAST.h

namespace clang {
   class Sema;
 
   /// \brief Parse the entire file specified, notifying the ASTConsumer as
   /// the file is parsed.
   ///
   /// This operation inserts the parsed decls into the translation
   /// unit held by Ctx.
   ///
+  /// \param PrintStats Whether to print LLVM statistics related to parsing.
   /// \param TUKind The kind of translation unit being parsed.
-  ///
   /// \param CompletionConsumer If given, an object to consume code completion
   /// results.
+  /// \param SkipFunctionBodies Whether to skip parsing of function bodies.
+  /// This option can be used, for example, to speed up searches for
+  /// delcarations/definitions when indexing.
   void ParseAST(Preprocessor &pp, ASTConsumer *C,
                 ASTContext &Ctx, bool PrintStats = false,
                 TranslationUnitKind TUKind = TU_Complete,
                 CodeCompleteConsumer *CompletionConsumer = nullptr,
                 bool SkipFunctionBodies = false);
 
   /// \brief Parse the main file known to the preprocessor, producing an 
   /// abstract syntax tree.
   void ParseAST(Sema &S, bool PrintStats = false,
                 bool SkipFunctionBodies = false);
-  
 }  // end namespace clang
 
 #endif