pci kernel-doc fatal error

rddunlap · torvalds · commit 443bd1c4ddab · 2008-07-21T10:43:26.000-07:00
Fix kernel-doc comments so that they don't produce errors.
Also cut some extraneous copy-paste text.

Error(linhead//drivers/pci/pci.c:1133): duplicate section name 'Description'
Error(linhead//drivers/pci/pci.c:1189): duplicate section name 'Description'

Signed-off-by: Randy Dunlap &lt;randy.dunlap@oracle.com&gt;
Signed-off-by: Linus Torvalds &lt;torvalds@linux-foundation.org&gt;
diff --git a/drivers/pci/pci.c b/drivers/pci/pci.c
@@ -1123,8 +1123,7 @@ int pci_enable_wake(struct pci_dev *dev, pci_power_t state, int enable)
 }
 
 /**
- * pci_prepare_to_sleep - prepare PCI device for system-wide transition into
- *                        a sleep state
+ * pci_prepare_to_sleep - prepare PCI device for system-wide transition into a sleep state
  * @dev: Device to handle.
  *
  * Choose the power state appropriate for the device depending on whether
@@ -1181,8 +1180,7 @@ int pci_prepare_to_sleep(struct pci_dev *dev)
 }
 
 /**
- * pci_back_from_sleep - turn PCI device on during system-wide transition into
- *                       the working state a sleep state
+ * pci_back_from_sleep - turn PCI device on during system-wide transition into working state
  * @dev: Device to handle.
  *
  * Disable device's sytem wake-up capability and put it into D0.

Original file line number	Diff line number	Diff line change
`@@ -1123,8 +1123,7 @@ int pci_enable_wake(struct pci_dev *dev, pci_power_t state, int enable)`
`1123`	`1123`	`}`
`1124`	`1124`
`1125`	`1125`	`/**`
`1126`		`- * pci_prepare_to_sleep - prepare PCI device for system-wide transition into`
`1127`		`- * a sleep state`
	`1126`	`+ * pci_prepare_to_sleep - prepare PCI device for system-wide transition into a sleep state`
`1128`	`1127`	`* @dev: Device to handle.`
`1129`	`1128`	`*`
`1130`	`1129`	`* Choose the power state appropriate for the device depending on whether`
`@@ -1181,8 +1180,7 @@ int pci_prepare_to_sleep(struct pci_dev *dev)`
`1181`	`1180`	`}`
`1182`	`1181`
`1183`	`1182`	`/**`
`1184`		`- * pci_back_from_sleep - turn PCI device on during system-wide transition into`
`1185`		`- * the working state a sleep state`
	`1183`	`+ * pci_back_from_sleep - turn PCI device on during system-wide transition into working state`
`1186`	`1184`	`* @dev: Device to handle.`
`1187`	`1185`	`*`
`1188`	`1186`	`* Disable device's sytem wake-up capability and put it into D0.`