[Mac, Win] Show a user manager tutorial once per profile.

chrome/browser/profiles/profile_window.h

 // Copyright 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_PROFILES_PROFILE_WINDOW_H_
 #define CHROME_BROWSER_PROFILES_PROFILE_WINDOW_H_
 
 #include "base/callback_forward.h"
 #include "chrome/browser/profiles/profile_metrics.h"
 #include "chrome/browser/ui/host_desktop.h"
 #include "chrome/browser/ui/startup/startup_types.h"
 
 class Profile;
 namespace base { class FilePath; }
 
 namespace profiles {
 
 // Callback to be used when switching to a new profile is completed.
 typedef base::Callback<void()> ProfileSwitchingDoneCallback;
 
+// Different tutorials that can be displayed in the user manager.
+enum UserManagerTutorialMode {
+  USER_MANAGER_NO_TUTORIAL,        // Does not display a tutorial.
+  USER_MANAGER_TUTORIAL_OVERVIEW,  // Basic overview of new features.
+  USER_MANAGER_TUTORIAL_LOCK       // Not yet implemented.
+};
+
 // Activates a window for |profile| on the desktop specified by
 // |desktop_type|. If no such window yet exists, or if |always_create| is
 // true, this first creates a new window, then activates
 // that. If activating an exiting window and multiple windows exists then the
 // window that was most recently active is activated. This is used for
 // creation of a window from the multi-profile dropdown menu.
 void FindOrCreateNewWindowForProfile(
     Profile* profile,
     chrome::startup::IsProcessStartup process_startup,
     chrome::startup::IsFirstRun is_first_run,
@@ skipping 21 matching lines @@
 void CreateAndSwitchToNewProfile(chrome::HostDesktopType desktop_type,
                                  ProfileSwitchingDoneCallback callback,
                                  ProfileMetrics::ProfileAdd metric);
 
 // Closes all browser windows that belong to the guest profile.
 void CloseGuestProfileWindows();
 
 // Closes all the browser windows for |profile| and opens the user manager.
 void LockProfile(Profile* profile);
 
+// Creates or reuses the guest profile needed by the user manager. Based on
+// the value of |tutorial_mode|, it can show a tutorial. If a tutorial is
+// not shown, |profile_path_to_focus| could be used to specify which user
+// pod should be focused. |callback| is ran once the custom url for the

[Alexei Svitkine (slow), 2014/03/18 15:50:33]

 What's a user pod?

[noms (inactive), 2014/03/19 15:58:20]

Done.

+// user manager has been decided.

[Alexei Svitkine (slow), 2014/03/18 15:50:33]

Can you document what the second param of the callback is?

[noms (inactive), 2014/03/19 15:58:20]

I thought it was already documented, but I've expanded the comment.
On 2014/03/18 15:50:33, Alexei Svitkine wrote:

[Alexei Svitkine (slow), 2014/03/19 16:37:01]

I meant the 2nd param of |callback|, not the 2nd param of
|CreateGuestProfileForUserManager|. Make the comment explicitly say that its the
URL somewhere.

On 2014/03/19 15:58:20, Monica Dinculescu wrote:

[noms (inactive), 2014/03/19 17:10:38]

Done.

+void CreateGuestProfileForUserManager(
+    const base::FilePath& profile_path_to_focus,
+    profiles::UserManagerTutorialMode tutorial_mode,
+    const base::Callback<void(Profile*, const std::string&)>& callback);
+
 }  // namespace profiles
 
 #endif  // CHROME_BROWSER_PROFILES_PROFILE_WINDOW_H_