glfw: clarify Monitor.setCallback docs

Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
This commit is contained in:
Stephen Gutekanst 2021-07-17 17:23:01 -07:00
parent c5b89fef2e
commit 0af761d046

View file

@ -235,13 +235,17 @@ var callback_data_ptr: ?usize = undefined;
/// This is called when a monitor is connected to or disconnected from the system. Example: /// This is called when a monitor is connected to or disconnected from the system. Example:
/// ///
/// ``` /// ```
/// fn monitorCallback(monitor: glfw.Monitor, event: ) callconv(.C) void { /// fn monitorCallback(monitor: glfw.Monitor, event: usize, data: *MyData) void {
/// // use monitor, set/get user data via monitor.setUserPointer, etc. /// // data is the pointer you passed into setCallback.
/// // event is one of glfw.connected or glfw.disconnected
/// } /// }
/// ... /// ...
/// glfw.Monitor.setCallback(monitorCallback) /// glfw.Monitor.setCallback(MyData, &myData, monitorCallback)
/// ``` /// ```
/// ///
/// `event` may be one of glfw.connected or glfw.disconnected. More events may be added in the
/// future.
///
/// Possible errors include glfw.Error.NotInitialized. /// Possible errors include glfw.Error.NotInitialized.
/// ///
/// @thread_safety This function must only be called from the main thread. /// @thread_safety This function must only be called from the main thread.