tree 4fc43dc0e901f565e37219ba59ea305409fb8be7
parent 8916e3702ec422b57cc549fbae3986106292100f
author Srivatsa S. Bhat <srivatsa.bhat@linux.vnet.ibm.com> 1328390786 +0100
committer Rafael J. Wysocki <rjw@sisk.pl> 1328828149 +0100

PM / Freezer / Docs: Document the beauty of freeze/thaw semantics

The way the different freeze/thaw functions encapsulate each other are quite
lovely from a design point of view. And as a side-effect, the way in which
they are invoked (cleaning up on failure for example) differs significantly
from how usual functions are dealt with. This is because of the underlying
semantics that govern the freezing and thawing of various tasks.

This subtle aspect that differentiates these functions from the rest, is
worth documenting.

Many thanks to Tejun Heo for providing enlightenment on this topic.

Signed-off-by: Srivatsa S. Bhat <srivatsa.bhat@linux.vnet.ibm.com>
Signed-off-by: Rafael J. Wysocki <rjw@sisk.pl>