From 2877dda572cccbab459b6e03d4365febcf03ff58 Mon Sep 17 00:00:00 2001
From: xster <xiao@xster.net>
Date: Wed, 9 Aug 2017 12:27:11 -0700
Subject: [PATCH] Add a small doc suggesting usage pattern for
 setSystemUIOverlayStyle (#11558)

---
 packages/flutter/lib/src/services/system_chrome.dart | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/flutter/lib/src/services/system_chrome.dart b/packages/flutter/lib/src/services/system_chrome.dart
index 2d1e04e501..f3dd33f4e5 100644
--- a/packages/flutter/lib/src/services/system_chrome.dart
+++ b/packages/flutter/lib/src/services/system_chrome.dart
@@ -152,6 +152,10 @@ class SystemChrome {
   /// overwrite the pending value, such that only the last specified value takes
   /// effect.
   ///
+  /// Call this API in code whose lifecyle matches that of the desired
+  /// system UI styles. For instance, to change the system UI style on a new
+  /// page, consider calling when pushing/popping a new [PageRoute].
+  ///
   /// If a particular style is not supported on the platform, selecting it will
   /// have no effect.
   static void setSystemUIOverlayStyle(SystemUiOverlayStyle style) {