Permalink
Browse files

Changes scaladoc of trait Dynamic

  • Loading branch information...
dgruntz committed May 2, 2012
1 parent 90d2bee commit e4ccaa99f139a72fc02424bcaa5cfdc3f75f8f82
Showing with 18 additions and 5 deletions.
  1. +18 −5 src/library/scala/Dynamic.scala
@@ -9,12 +9,25 @@
package scala
/** A marker trait that enables dynamic invocations. Instances `x` of this
- * trait allow calls `x.meth(args)` for arbitrary method names `meth` and
- * argument lists `args`. If a call is not natively supported by `x`, it
- * is rewritten to `x.applyDynamic("meth")(args)`.
+ * trait allow method invocations `x.meth(args)` for arbitrary method
+ * names `meth` and argument lists `args` as well as field accesses
+ * `x.field` for arbitrary field names `field`.
*
- * As of scala 2.9, `scalac` must receive the `-Xexperimental` option for
- * `Dynamic` to receive this treatment.
+ * If a call is not natively supported by `x` (i.e. if type checking
+ * fails), it is rewritten according to the following rules:
+ *
+ * {{{
+ * foo.method("blah") ~~> foo.applyDynamic("method")("blah")
+ * foo.method(x = "blah") ~~> foo.applyDynamicNamed("method")(("x", "blah"))
+ * foo.method(x = 1, 2) ~~> foo.applyDynamicNamed("method")(("x", 1), ("", 2))
+ * foo.field ~~> foo.selectDynamic("field")
+ * foo.varia = 10 ~~> foo.updateDynamic("varia")(10)
+ * foo.arr(10) = 13 ~~> foo.selectDynamic("arr").update(10, 13)
+ * foo.arr(10) ~~> foo.applyDynamics("arr")(10)
+ * }}}
+ *
+ * As of Scala 2.10, defining direct or indirect subclasses of this trait
+ * is only possible if the language feature `dynamics` is enabled.
*/
trait Dynamic

0 comments on commit e4ccaa9

Please sign in to comment.