* timeout.el (timeout--throttle-advice, timeout-throttled-func):
Capture the correct return value the first time a throttled
function is called.  Previously, it would return nil on the very
first call.

This fix was provided by Juri Linkov.

* timeout.el:

* timeout.el (timeout--eval-value, timeout--throttle-advice,
timeout--debounce-advice, timeout-debounce, timeout-throttle,
timeout-throttled-func, timeout-debounced-func): Allow debounce
and throttle delays to be dynamic, supplied via a symbol (whose
value is used) or a function (whose result is used).

* README.org: Update instructions for dynamic delay.

* timeout.el:

* timeout.el (timeout-debouce, timeout-debouced-func)
(timeout-throttle, timeout-throttled-func): For compatibility with
the version of this package to be upstreamed into Emacs, change
the names of the functions in this library to match the Elisp
naming conventions.  The changes are:

timeout-throttle  -> timeout-throttled-func
timeout-throttle  -> timeout-throttled-func
timeout-throttle! -> timeout-throttle
timeout-throttle! -> timeout-throttle

Update version of package to v2 because of breaking change.

* README.org: Mention breaking change.

* timeout.el (timeout--throttle-advice, timeout-throttle!,
timeout-throttle): Remove the DEFAULT argument to the throttle
functions.  This is never used, since the result from the current
call or the previous successful call is always available for a
throttled function.

* timeout.el (timeout-throttle!): Contrary to the docstring, not
specifying the optional `throttle' argument causes
`timeout-throttle!' to error.  Fix #7.

Fix typos and clarify what debounce/throttle do in docstrings.

* timeout.el (timeout--throttle-advice):
(timeout--debounce-advice):
(timeout-debounce!):
(timeout-throttle!):
(timeout-throttle):
(timeout-debounce):

* timeout.el (timeout--debounce-advice, timeout-debounce): Update
the DEFAULT return value of debounced function when the function
runs.  This brings the behavior in line with that of
timeout-throttle.