README.md in concurrent_worker-0.1.0 vs README.md in concurrent_worker-0.1.1

@@ -1,10 +1,8 @@
 # ConcurrentWorker
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/concurrent_worker`. To experiment with that code, run `bin/console` for an interactive prompt.
 
-TODO: Delete this and the text above, and describe your gem
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
@@ -20,20 +18,90 @@
 
     $ gem install concurrent_worker
 
 ## Usage
 
-TODO: Write usage instructions here
+### Worker
 
+You can define worker block executed in other thread, and send requests to the worker.
+
+```ruby
+require 'concurrent_worker'
+Thread.abort_on_exception = true
+
+# define a work block.
+logger = ConcurrentWorker::Worker.new do |args|
+  printf(*args)
+  $stdout.flush
+  nil
+end
+
+...
+# call work block asynchronously with 'req' method.
+logger.req("thread%d n=%d\n",0, 1)
+
+logger.join
+```
+
+If you need some preparation for the worker block, you can define 'base block':
+
+```ruby
+logger = ConcurrentWorker::Worker.new do |args|
+  # share object with 'base block' by instance variable(@xxx). 
+  printf(@file, *args)
+  @file.flush
+  nil
+end
+
+# define 'base block' for some preparation of 'work block'.
+logger.set_block(:base_block) do
+  open( "log.txt" , "w" ) do |file|
+    @file = file
+    # 'yield_loop_block' must be called in 'base block'.
+    # 'work block' will be called in this call.
+    yield_loop_block 
+  end
+end
+...
+```
+
+The 'work blick' and 'base block' are executed in a worker's instance scope, in a same thread, so that they can share object with the worker's instance variable.
+
+### WorkerPool
+You can exec work block in some process concurrently.
+
+```ruby
+#define a pool of 8 workers , executed in other process.
+pw = ConcurrentWorker::WorkerPool.new(type: :process, pool_max: 8) do
+  |n|
+  [n , n.times.inject(:+)]
+end
+
+# you can receive the result of work block with callback block.
+pw.add_callback do |n, result|
+  logger.log( "n=%d,result=%d", n, result)
+end
+
+(10000000..10000200).each do |n|
+  pw.req(n)
+end
+
+pw.join
+
+```
+
+Worker uses `Marshal::dump/load` to transport ruby object to other process. So, request arguments and result objects must be able to be Marshal dumped. 
+
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/concurrent_worker.
+Bug reports and pull requests are welcome on GitHub at https://github.com/murjp/concurrent_worker.
 
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).