| Index: sync/engine/sync_scheduler.h | 
| diff --git a/sync/engine/sync_scheduler.h b/sync/engine/sync_scheduler.h | 
| index b2ebbe3f0484862b9f0c50a6d82e54b61f7dee36..afaaca7b275d402d81945ec66e6bf80f6bc71050 100644 | 
| --- a/sync/engine/sync_scheduler.h | 
| +++ b/sync/engine/sync_scheduler.h | 
| @@ -83,20 +83,37 @@ class SYNC_EXPORT_PRIVATE SyncScheduler | 
| // are cancelled. | 
| virtual void RequestStop(const base::Closure& callback) = 0; | 
|  | 
| -  // The meat and potatoes. Both of these methods will post a delayed task | 
| -  // to attempt the actual nudge (see ScheduleNudgeImpl). | 
| +  // The meat and potatoes. All three of the following methods will post a | 
| +  // delayed task to attempt the actual nudge (see ScheduleNudgeImpl). | 
| +  // | 
| // NOTE: |desired_delay| is best-effort. If a nudge is already scheduled to | 
| // depart earlier than Now() + delay, the scheduler can and will prefer to | 
| // batch the two so that only one nudge is sent (at the earlier time). Also, | 
| // as always with delayed tasks and timers, it's possible the task gets run | 
| // any time after |desired_delay|. | 
| -  virtual void ScheduleNudgeAsync( | 
| + | 
| +  // The LocalNudge indicates that we've made a local change, and that the | 
| +  // syncer should plan to commit this to the server some time soon. | 
| +  virtual void ScheduleLocalNudge( | 
| const base::TimeDelta& desired_delay, | 
| -      NudgeSource source, | 
| ModelTypeSet types, | 
| const tracked_objects::Location& nudge_location) = 0; | 
| -  virtual void ScheduleNudgeWithStatesAsync( | 
| -      const base::TimeDelta& desired_delay, NudgeSource source, | 
| + | 
| +  // The LocalRefreshRequest occurs when we decide for some reason to manually | 
| +  // request updates.  This should be used sparingly.  For example, one of its | 
| +  // uses is to fetch the latest tab sync data when it's relevant to the UI on | 
| +  // platforms where tab sync is not registered for invalidations. | 
| +  virtual void ScheduleLocalRefreshRequest( | 
| +      const base::TimeDelta& desired_delay, | 
| +      ModelTypeSet types, | 
| +      const tracked_objects::Location& nudge_location) = 0; | 
| + | 
| +  // Invalidations are notifications the server sends to let us know when other | 
| +  // clients have committed data.  We need to contact the sync server (being | 
| +  // careful to pass along the "hints" delivered with those invalidations) in | 
| +  // order to fetch the update. | 
| +  virtual void ScheduleInvalidationNudge( | 
| +      const base::TimeDelta& desired_delay, | 
| const ModelTypeInvalidationMap& invalidation_map, | 
| const tracked_objects::Location& nudge_location) = 0; | 
|  | 
|  |