Orphan documentation in SDL_sensor.h?

[icculus]

This is in SDL_sensor.h, with nothing associated with it.

/**
 * Gyroscope sensor.
 *
 * The gyroscope returns the current rate of rotation in radians per second.
 * The rotation is positive in the counter-clockwise direction. That is,
 * an observer looking from a positive location on one of the axes would
 * see positive rotation on that axis when it appeared to be rotating
 * counter-clockwise.
 *
 * values[0]: Angular speed around the x axis (pitch)
 * values[1]: Angular speed around the y axis (yaw)
 * values[2]: Angular speed around the z axis (roll)
 *
 * For phones and tablets held in natural orientation and game controllers held in front of you, the axes are defined as follows:
 * -X ... +X : left ... right
 * -Y ... +Y : bottom ... top
 * -Z ... +Z : farther ... closer
 *
 * The axis data is not changed when the device is rotated.
 *
 * \sa SDL_GetCurrentDisplayOrientation()
 */

Did this have something that was removed? Is this just notes on what to expect from SDL_GetSensorData?

[slouken]

Both this and the "Accelerometer sensor" blocks are standalone documentation for SDL_SENSOR_ACCEL* and SDL_SENSOR_GYRO*. I'm guessing your script associated the accelerometer documentation with SDL_STANDARD_GRAVITY.

These should probably be moved into the SDL_SensorType block.

[icculus]

Okay, this has been updated: https://wiki.libsdl.org/SDL3/SDL_SensorType