Tweak return of `Ractor#close`, add doc

1 files changed, 5 insertions, 0 deletions

diff --git a/ractor.rb b/ractor.rb
index 936310d645..b9fb4297b8 100644
--- a/ractor.rb
+++ b/ractor.rb
@@ -150,21 +150,26 @@ class Ractor
     attr_reader :ractor
   end
 
+  # Closes the incoming port and returns its previous state.
   def close_incoming
     __builtin_cexpr! %q{
       ractor_close_incoming(ec, RACTOR_PTR(self));
     }
   end
 
+  # Closes the outgoing port and returns its previous state.
   def close_outgoing
     __builtin_cexpr! %q{
       ractor_close_outgoing(ec, RACTOR_PTR(self));
     }
   end
 
+  # Closes both incoming and outgoing ports.
   def close
     close_incoming
     close_outgoing
+
+    self
   end
 
   # utility method