Merge branch 'master' into synchronization

* upstream/master: (22 commits)
  Async now hides :new and provides safe :create factory.
  ...

Author: pitr-ch

.rspec

@@ -1,4 +1,3 @@
 --require spec_helper
 --color
---backtrace
 --format documentation

.yardopts

@@ -1,4 +1,3 @@
---protected
 --no-private
 --embed-mixins
 --output-dir ./yardoc

Gemfile

@@ -18,7 +18,9 @@ end
 
 group :testing do
   gem 'rspec', '~> 3.2.0'
+  gem 'timecop', '~> 0.7.3'
+
+  # Coverage
   gem 'simplecov', '~> 0.10.0', :require => false
   gem 'coveralls', '~> 0.8.1', :require => false
-  gem 'timecop', '~> 0.7.3'
 end

doc/async.md

@@ -21,7 +21,18 @@ class Agent
     #
     # @param [Object] initial the initial value
     #
-    # @!macro executor_and_deref_options
+    # @!macro [attach] executor_and_deref_options
+    #  
+    #   @param [Hash] opts the options used to define the behavior at update and deref
+    #     and to specify the executor on which to perform actions
+    #   @option opts [Executor] :executor when set use the given `Executor` instance.
+    #     Three special values are also supported: `:task` returns the global task pool,
+    #     `:operation` returns the global operation pool, and `:immediate` returns a new
+    #     `ImmediateExecutor` object.
+    #   @option opts [Boolean] :dup_on_deref (false) call `#dup` before returning the data
+    #   @option opts [Boolean] :freeze_on_deref (false) call `#freeze` before returning the data
+    #   @option opts [Proc] :copy_on_deref (nil) call the given `Proc` passing
+    #     the internal value and returning the value returned from the proc
     def initialize(initial, opts = {})
       @value                = initial
       @rescuers             = []