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

[Kai Gülzau (JIRA)]

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