[jboss-jira] [JBoss JIRA] Commented: (JBRULES-2785) Documentation fixes w.r.t. events

[Wolfgang Laun (JIRA)]

    [ https://jira.jboss.org/browse/JBRULES-2785?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12562813#action_12562813 ] 

Wolfgang Laun commented on JBRULES-2785:
----------------------------------------

Rewrite this paragraph

3.3.3.1.3. Update

The Rule Engine must be notified of modified facts, so that they can be reprocessed. Internally, modification is actually a retract followed by an insert; the Rule Engine removes the fact from the WorkingMemory and inserts it again. You must use the update() method to notify the WorkingMemory of changed objects for those objects that are not able to notify the WorkingMemory themselves. Notice that update() always takes the modified object as a second parameter, which allows you to specify new instances for immutable objects. The update() method can only be used with objects that have shadow proxies turned on. The update method is only available within Java code. On the right hand side of a rule, also the modify statement is supported, providing simplified calls to the object's setters.

> Documentation fixes w.r.t. events 
> ----------------------------------
>
>                 Key: JBRULES-2785
>                 URL: https://jira.jboss.org/browse/JBRULES-2785
>             Project: Drools
>          Issue Type: Bug
>      Security Level: Public(Everyone can see) 
>          Components: drools-docs
>    Affects Versions: 5.1.1.FINAL
>            Reporter: Wolfgang Laun
>            Assignee: Mark Proctor
>            Priority: Critical
>             Fix For: 5.2.0.M1
>
>
> Correct the documentation:
> (1) Explicit expiry time by @expires() in declare has precedence over implicit, dervide from rules. (Critical, because right now is documented the other way round.)
> (2) Document that declare without any fields must refer to an existing, imported type.
> (3) Document the semantics of timer, and that timer() can only be used in a STREAM session. Also, document that "int:" (as in "timer(int: 0 1m)") is optional.
> (4) Make it clear that window:length( N ) is also satisfied if there are less than N events.
>  

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: https://jira.jboss.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira