Github user aledsage commented on a diff in the pull request:
https://github.com/apache/incubator-brooklyn/pull/595#discussion_r28326756
--- Diff: docs/guide/yaml/yaml-reference.md ---
@@ -157,12 +166,14 @@ concise DSL defined here:
* `$brooklyn:formatString("pattern e.g. %s %s", "field 1", "field 2")`
returns a future which creates the formatted string
with the given parameters, where parameters may be strings *or* other
tasks such as `attributeWhenReady`
* `$brooklyn:literal("string")` returns the given string as a literal
(suppressing any `$brooklyn:` expansion)
-* `$brooklyn:sensor("io.brooklyn.ContainingEntityClass", "sensor.name")`
returns the strongly typed sensor defined in the given class
+* `$brooklyn:object(Map)` creates an object, using keys `type` to define
the java type,
+ and either `object.fields` or `brooklyn.config` to supply
bean/constructor/flags to create an instance
* `$brooklyn:entitySpec(Map)` returns a new `ServiceSpecification` as
defined by the given `Map`,
--- End diff --
Longer term, this could do with a cross-reference to a section that
describes an `EntitySpec` (for those who don't look at the Java api), and we
should avoid java generics syntax like `ConfigKey<EntitySpec>`.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
