diff --git a/clang/include/clang/Lex/Preprocessor.h b/clang/include/clang/Lex/Preprocessor.h index fe05b07eebed..cc056ead5d16 100644 --- a/clang/include/clang/Lex/Preprocessor.h +++ b/clang/include/clang/Lex/Preprocessor.h @@ -277,22 +277,22 @@ public: void RemoveTopOfLexerStack(); /// EnableBacktrackAtThisPos - From the point that this method is called, and - /// until DisableBacktrack() or Backtrack() is called, the Preprocessor keeps - /// track of the lexed tokens so that a subsequent Backtrack() call will make - /// the Preprocessor re-lex the same tokens. + /// until CommitBacktrackedTokens() or Backtrack() is called, the Preprocessor + /// keeps track of the lexed tokens so that a subsequent Backtrack() call will + /// make the Preprocessor re-lex the same tokens. /// /// Nested backtracks are allowed, meaning that EnableBacktrackAtThisPos can - /// be called multiple times and DisableBacktrack/Backtrack calls will be - /// combined with the EnableBacktrackAtThisPos calls in reverse order. + /// be called multiple times and CommitBacktrackedTokens/Backtrack calls will + /// be combined with the EnableBacktrackAtThisPos calls in reverse order. /// - /// NOTE: *DO NOT* forget to call either DisableBacktrack() or Backtrack() at - /// some point after EnableBacktrackAtThisPos. If you don't, caching of tokens - /// will continue indefinitely. + /// NOTE: *DO NOT* forget to call either CommitBacktrackedTokens or Backtrack + /// at some point after EnableBacktrackAtThisPos. If you don't, caching of + /// tokens will continue indefinitely. /// void EnableBacktrackAtThisPos(); - /// DisableBacktrack - Disable the last EnableBacktrackAtThisPos() call. - void DisableBacktrack(); + /// CommitBacktrackedTokens - Disable the last EnableBacktrackAtThisPos call. + void CommitBacktrackedTokens(); /// Backtrack - Make Preprocessor re-lex the tokens that were lexed since /// EnableBacktrackAtThisPos() was previously called. diff --git a/clang/lib/Lex/PPCaching.cpp b/clang/lib/Lex/PPCaching.cpp index 5bed51eaa402..7ba5e45afabb 100644 --- a/clang/lib/Lex/PPCaching.cpp +++ b/clang/lib/Lex/PPCaching.cpp @@ -15,22 +15,22 @@ #include "clang/Lex/Preprocessor.h" using namespace clang; -/// EnableBacktrackAtThisPos - From the point that this method is called, and -/// until DisableBacktrack() or Backtrack() is called, the Preprocessor keeps -/// track of the lexed tokens so that a subsequent Backtrack() call will make -/// the Preprocessor re-lex the same tokens. -/// -/// Nested backtracks are allowed, meaning that EnableBacktrackAtThisPos can -/// be called multiple times and DisableBacktrack/Backtrack calls will be -/// combined with the EnableBacktrackAtThisPos calls in reverse order. +/// EnableBacktrackAtThisPos - From the point that this method is called, and +/// until CommitBacktrackedTokens() or Backtrack() is called, the Preprocessor +/// keeps track of the lexed tokens so that a subsequent Backtrack() call will +/// make the Preprocessor re-lex the same tokens. +/// +/// Nested backtracks are allowed, meaning that EnableBacktrackAtThisPos can +/// be called multiple times and CommitBacktrackedTokens/Backtrack calls will +/// be combined with the EnableBacktrackAtThisPos calls in reverse order. void Preprocessor::EnableBacktrackAtThisPos() { CacheTokens = true; BacktrackPositions.push_back(CachedLexPos); EnterCachingLexMode(); } -/// DisableBacktrack - Disable the last EnableBacktrackAtThisPos() call. -void Preprocessor::DisableBacktrack() { +/// CommitBacktrackedTokens - Disable the last EnableBacktrackAtThisPos call. +void Preprocessor::CommitBacktrackedTokens() { assert(!BacktrackPositions.empty() && "EnableBacktrackAtThisPos was not called!"); BacktrackPositions.pop_back();