[DOC] Adjust some new features wording/examples. (#9183)

* Reword Range#overlap? docs last paragraph.

* Docs: add explanation about Queue#freeze

* Docs: Add :rescue event docs for TracePoint

* Docs: Enhance Module#set_temporary_name documentation

* Docs: Slightly expand Process::Status deprecations

* Fix MatchData#named_captures rendering glitch

* Improve Dir.fchdir examples

* Adjust Refinement#target docs

1 files changed, 10 insertions, 1 deletions

diff --git a/eval.c b/eval.c
index be450a02f5..15b6567aff 100644
--- a/eval.c
+++ b/eval.c
@@ -1346,9 +1346,16 @@ rb_using_module(const rb_cref_t *cref, VALUE module)
 
 /*
  *  call-seq:
- *     target    -> class
+ *     target    -> class_or_module
  *
  *  Return the class or module refined by the receiver.
+ *
+ *     module M
+ *       refine String do
+ *       end
+ *     end
+ *
+ *     M.refinements[0].target # => String
  */
 VALUE
 rb_refinement_module_get_refined_class(VALUE module)
@@ -1363,6 +1370,8 @@ rb_refinement_module_get_refined_class(VALUE module)
  *  call-seq:
  *     refined_class    -> class
  *
+ *  Deprecated; prefer #target.
+ *
  *  Return the class refined by the receiver.
  */
 static VALUE