SQLite3::busyTimeout documentation incomplete

From manual page: https://php.net/sqlite3.busytimeout

SQLite3::busyTimeout — Sets the busy connection handler

Sets a busy handler that will sleep until the database is not locked or the timeout is reached.

"busy connection handler" is not adequately explained on the documentation web-page. Is the handler a callback the user must implement? Is it a built-in feature? How do we interact with this handler? What happens if the database is still locked after the timeout? Is an exception thrown? What is the default timeout value? These important details were omitted from this documentation page. Respectfully, please understand that not everyone has the detailed knowledge of SQLite3 or PHP internals to fully understand the PHP source code.

Returns true on success, or false on failure.

This also could be clearer. Does this mean:

"Returns true if timeout is successfully set, or false on failure" ?

Thanks.

Start with the SQLite3::busyTimeout manual page at https://php.net/sqlite3.busytimeout and verify the omitted behavior using the PHP or SQLite3 references mentioned in the issue. Done means the page explains the busy handler, timeout behavior, default value, failure outcome, and the meaning of the return value.