* pm_runtime_force_resume - Force a device into resume state if needed.
* @dev: Device to resume.
*
-- * Prior invoking this function we expect the user to have brought the device
-- * into low power state by a call to pm_runtime_force_suspend(). Here we reverse
-- * those actions and bring the device into full power, if it is expected to be
-- * used on system resume. In the other case, we defer the resume to be managed
-- * via runtime PM.
++ * This function expects that either pm_runtime_force_suspend() has put the
++ * device into a low-power state prior to calling it, or the device had been
++ * runtime-suspended before the preceding system-wide suspend transition and it
++ * was left in suspend during that transition.
+ *
- * Typically this function may be invoked from a system resume callback.
++ * The actions carried out by pm_runtime_force_suspend(), or by a runtime
++ * suspend in general, are reversed and the device is brought back into full
++ * power if it is expected to be used on system resume, which is the case when
++ * its needs_force_resume flag is set or when its smart_suspend flag is set and
++ * its runtime PM status is "active".
+ *
- * Typically this function may be invoked from a system resume callback.
++ * In other cases, the resume is deferred to be managed via runtime PM.
++ *
++ * Typically, this function may be invoked from a system resume callback.
*/
int pm_runtime_force_resume(struct device *dev)
{