[richfaces-issues] [JBoss JIRA] Commented: (RF-7305) a4j:poll interval - inaccurate doc

[Kai Gülzau (JIRA)]

    [ https://jira.jboss.org/jira/browse/RF-7305?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12470365#action_12470365 ] 

Kai Gülzau commented on RF-7305:
--------------------------------

OK, RTFM.
Interval is described correctly in chapter 6.17.4
http://www.jboss.org/file-access/default/members/jbossrichfaces/freezone/docs/devguide/en/html/a4j_poll.html#d0e9781

"The  "interval"   attribute defines an interval in milliseconds between the previous response and the next request. The total period beetween two requests generated by the  <a4j:poll>   component is a sum of an  "interval"   attribute value and server response time."

> a4j:poll interval - inaccurate doc
> ----------------------------------
>
>                 Key: RF-7305
>                 URL: https://jira.jboss.org/jira/browse/RF-7305
>             Project: RichFaces
>          Issue Type: Task
>          Components: doc
>    Affects Versions: 3.3.1
>            Reporter: Kai Gülzau
>
> Current doc for a4j:poll interval is "Interval (in ms) for call poll requests. Default value is "1000"ms (1 second)."
> In fact this value is _not_ the interval for polling but the time between last poll response (or last timeout) and new poll request.
> The polling interval calculates as:
>    network delay send request
> + server processing time
> + network delay get response
> + a4j:poll interval
> Example:
> <a4j:poll interval="5000" timeout="30000" ...>
> If network is bad and all poll requests get lost the actual poll interval is 35sec not 5sec.
> This should be stated in the docs.
> Futhermore docs should notice, that polling does not start at once but with a delay of "interval".

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