Fix copyright lines

[folly.git] / folly / futures / detail / Types.h

diff --git a/folly/futures/detail/Types.h b/folly/futures/detail/Types.h
index 57b93e053032685a4cc5b47e61f52d493c10d234..9f7b8afe4502e687aa084ebd4753ca2f828f28b6 100644 (file)
--- a/folly/futures/detail/Types.h
+++ b/folly/futures/detail/Types.h
@@ -1,5 +1,5 @@
 /*
- * Copyright 2014 Facebook, Inc.
+ * Copyright 2014-present Facebook, Inc.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -18,8 +18,21 @@
 
 #include <chrono>
 
-namespace folly { namespace wangle {
+namespace folly {
 
+/// folly::Duration is an alias for the best resolution we offer/work with.
+/// However, it is not intended to be used for client code - you should use a
+/// descriptive std::chrono::duration type instead. e.g. do not write this:
+///
+///   futures::sleep(Duration(1000))...
+///
+/// rather this:
+///
+///   futures::sleep(std::chrono::milliseconds(1000));
+///
+/// or this:
+///
+///   futures::sleep(std::chrono::seconds(1));
 using Duration = std::chrono::milliseconds;
 
-}}
+} // namespace folly