summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorshugo <shugo@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>2013-07-02 08:24:26 +0000
committershugo <shugo@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>2013-07-02 08:24:26 +0000
commit9487404c62ea4e6d0381cb2523785df17a4fa8b9 (patch)
tree51defde2e288e87ab3eeb3c944487dfbc5fb90aa /doc
parent58919a4da91768367e4bb172df2ea4c9834c5eec (diff)
* doc/syntax/refinements.rdoc: add description of Module#using and
refinement inheritance by module inclusion. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@41746 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Diffstat (limited to 'doc')
-rw-r--r--doc/syntax/refinements.rdoc27
1 files changed, 26 insertions, 1 deletions
diff --git a/doc/syntax/refinements.rdoc b/doc/syntax/refinements.rdoc
index 7b3f0f6..519082e 100644
--- a/doc/syntax/refinements.rdoc
+++ b/doc/syntax/refinements.rdoc
@@ -48,7 +48,7 @@ Activate the refinement with #using:
== Scope
-You may only activate refinements at top-level to the end of the file or in a
+You may activate refinements at top-level to the end of the file or in a
string passed to Kernel#eval, Kernel#instance_eval or Kernel#module_eval until
the end of the string.
@@ -186,6 +186,25 @@ called:
p [{1=>2}, {3=>4}].to_json # prints "[{\"1\":2},{\"3\":4}]"
+You may also activate refinements in a class or module definition, in which
+case the refinements are activated from the point where using is called to
+the end of the class or module definition:
+
+ # not activated here
+ class Foo
+ # not activated here
+ using M
+ # activated here
+ def foo
+ # activated here
+ end
+ # activated here
+ end
+ # not activated here
+
+Note that the refinements in M are not activated automatically even if the class
+Foo is reopened later.
+
== Method Lookup
When looking up a method for an instance of class +C+ Ruby checks:
@@ -232,6 +251,12 @@ method lookup.
This behavior may be changed in the future.
+== Refinements and module inclusion
+
+Refinements are inherited by module inclusion. That is, using activates all
+refinements in the ancestors of the specified module. Refinements in a
+descendant have priority over refinements in an ancestor.
+
== Further Reading
See http://bugs.ruby-lang.org/projects/ruby-trunk/wiki/RefinementsSpec for the