On Wed, 9 May 2007 16:38:09 -0700 Kristen Carlson Accardi [off-list ref] wrote:

 /**
+ *	ata_dev_set_AN - Issue SET FEATURES - SATA FEATURES
+ *                       with sector count set to indicate
+ *                       Asynchronous Notification feature

I think kenreldoc requires that all this be on a single line?

+ *	@dev: Device to which command will be sent
+ *
+ *	Issue SET FEATURES - SATA FEATURES command to device @dev
+ *	on port @ap.
+ *
+ *	LOCKING:
+ *	PCI/etc. bus probe sem.
+ *
+ *	RETURNS:
+ *	0 on success, AC_ERR_* mask otherwise.
+ */

ooh, locking and return value documentation.  Often missed, and nice.