Document TaskRunners/TaskTraits/FROM_HERE as implicitly included from post_task.h

base/task_scheduler/post_task.h

 // Copyright 2016 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 BASE_TASK_SCHEDULER_POST_TASK_H_
 #define BASE_TASK_SCHEDULER_POST_TASK_H_
 
 #include "base/base_export.h"
 #include "base/callback_forward.h"
+#include "base/memory/ref_counted.h"
+
+// To avoid redundant includes: users may omit including the following headers

[robliao, 2016/11/02 17:06:25]

https://google.github.io/styleguide/cppguide.html#Names_and_Order_of_Includes

The language in the style guide does not seem to permit deviation.


Keep this in alphabetical order and then have a comment banner below discussing
the permitted files to omit.

[gab, 2016/11/02 18:18:33]

Done.

+// if they are using their provided data types solely in direct interactions
+// with the post_task.h API.
 #include "base/location.h"
-#include "base/memory/ref_counted.h"
 #include "base/sequenced_task_runner.h"
 #include "base/single_thread_task_runner.h"
 #include "base/task_runner.h"
 #include "base/task_scheduler/task_traits.h"
 
 namespace base {
 
 // This is the preferred interface to post tasks to the TaskScheduler.
 //
 // Note: The TaskScheduler is still in an experimental phase in Chrome. Please
@@ skipping 83 matching lines @@
 // CreateSequencedTaskRunnerWithTraits(). Only use this if you rely on a thread-
 // affine API (it might be safer to assume thread-affinity when dealing with
 // under-documented third-party APIs, e.g. other OS') or share data across tasks
 // using thread-local storage.
 BASE_EXPORT scoped_refptr<SingleThreadTaskRunner>
 CreateSingleThreadTaskRunnerWithTraits(const TaskTraits& traits);
 
 }  // namespace base
 
 #endif  // BASE_TASK_SCHEDULER_POST_TASK_H_