PCI: document pci_target_state
authorJesse Barnes <jbarnes@hobbes.lan>
Mon, 28 Jul 2008 18:49:26 +0000 (11:49 -0700)
committerJesse Barnes <jbarnes@virtuousgeek.org>
Mon, 28 Jul 2008 18:49:26 +0000 (11:49 -0700)
The empty kdoc was causing warnings, so provide some actual documentation.

Signed-off-by: Jesse Barnes <jbarnes@virtuousgeek.org>
drivers/pci/pci.c

index e9c356236d27378d2529ab0dc67ef14b776dd3d3..c95f77d657187b464cd9d8324b2d83d9796089bf 100644 (file)
@@ -1123,6 +1123,12 @@ int pci_enable_wake(struct pci_dev *dev, pci_power_t state, int enable)
 }
 
 /**
+ * pci_target_state - find an appropriate low power state for a given PCI dev
+ * @dev: PCI device
+ *
+ * Use underlying platform code to find a supported low power state for @dev.
+ * If the platform can't manage @dev, return the deepest state from which it
+ * can generate wake events, based on any available PME info.
  */
 pci_power_t pci_target_state(struct pci_dev *dev)
 {