Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

staging: kpc2000: kpc_i2c: fixup block comment style in i2c_driver.c

Throughout i2c_driver.c, there are numerous deviations from the two
standards of:
- placing a '*' at the beginning of every line containing a
block comment.
- placing the closing comment marker '*/' on a new line.

Instead, use a block comment style that is more consistent with the
prescribed guidelines.

Signed-off-by: Geordan Neukum <gneukum1@gmail.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Geordan Neukum and committed by
Greg Kroah-Hartman
7ac3e13a 03a51687

+21 -15
+21 -15
drivers/staging/kpc2000/kpc_i2c/i2c_driver.c
··· 137 137 #define outb_p(d,a) writeq(d,(void*)a) 138 138 139 139 /* Make sure the SMBus host is ready to start transmitting. 140 - Return 0 if it is, -EBUSY if it is not. */ 140 + * Return 0 if it is, -EBUSY if it is not. 141 + */ 141 142 static int i801_check_pre(struct i2c_device *priv) 142 143 { 143 144 int status; ··· 227 226 return result; 228 227 } 229 228 /* the current contents of SMBHSTCNT can be overwritten, since PEC, 230 - * INTREN, SMBSCMD are passed in xact */ 229 + * INTREN, SMBSCMD are passed in xact 230 + */ 231 231 outb_p(xact | I801_START, SMBHSTCNT(priv)); 232 232 233 233 /* We will always wait for a fraction of a second! */ ··· 426 424 } 427 425 428 426 /* Experience has shown that the block buffer can only be used for 429 - SMBus (not I2C) block transactions, even though the datasheet 430 - doesn't mention this limitation. */ 427 + * SMBus (not I2C) block transactions, even though the datasheet 428 + * doesn't mention this limitation. 429 + */ 431 430 if ((priv->features & FEATURE_BLOCK_BUFFER) && command != I2C_SMBUS_I2C_BLOCK_DATA && i801_set_block_buffer_mode(priv) == 0) { 432 431 result = i801_block_transaction_by_block(priv, data, read_write, hwpec); 433 432 } else { ··· 502 499 case I2C_SMBUS_I2C_BLOCK_DATA: 503 500 dev_dbg(&priv->adapter.dev, " [acc] SMBUS_I2C_BLOCK_DATA\n"); 504 501 /* NB: page 240 of ICH5 datasheet shows that the R/#W 505 - * bit should be cleared here, even when reading */ 502 + * bit should be cleared here, even when reading 503 + */ 506 504 outb_p((addr & 0x7f) << 1, SMBHSTADD(priv)); 507 505 if (read_write == I2C_SMBUS_READ) { 508 506 /* NB: page 240 of ICH5 datasheet also shows 509 - * that DATA1 is the cmd field when reading */ 507 + * that DATA1 is the cmd field when reading 508 + */ 510 509 outb_p(command, SMBHSTDAT1(priv)); 511 510 } else { 512 511 outb_p(command, SMBHSTCMD(priv)); ··· 538 533 } 539 534 540 535 /* Some BIOSes don't like it when PEC is enabled at reboot or resume 541 - time, so we forcibly disable it after every transaction. Turn off 542 - E32B for the same reason. */ 536 + * time, so we forcibly disable it after every transaction. Turn off 537 + * E32B for the same reason. 538 + */ 543 539 if (hwpec || block) { 544 540 dev_dbg(&priv->adapter.dev, " [acc] hwpec || block\n"); 545 541 outb_p(inb_p(SMBAUXCTL(priv)) & ~(SMBAUXCTL_CRC | SMBAUXCTL_E32B), SMBAUXCTL(priv)); ··· 579 573 struct i2c_device *priv = i2c_get_adapdata(adapter); 580 574 581 575 /* original settings 582 - u32 f = I2C_FUNC_SMBUS_QUICK | I2C_FUNC_SMBUS_BYTE | 583 - I2C_FUNC_SMBUS_BYTE_DATA | I2C_FUNC_SMBUS_WORD_DATA | 584 - I2C_FUNC_SMBUS_BLOCK_DATA | I2C_FUNC_SMBUS_WRITE_I2C_BLOCK | 585 - ((priv->features & FEATURE_SMBUS_PEC) ? I2C_FUNC_SMBUS_PEC : 0) | 586 - ((priv->features & FEATURE_I2C_BLOCK_READ) ? 587 - I2C_FUNC_SMBUS_READ_I2C_BLOCK : 0); 588 - */ 576 + * u32 f = I2C_FUNC_SMBUS_QUICK | I2C_FUNC_SMBUS_BYTE | 577 + * I2C_FUNC_SMBUS_BYTE_DATA | I2C_FUNC_SMBUS_WORD_DATA | 578 + * I2C_FUNC_SMBUS_BLOCK_DATA | I2C_FUNC_SMBUS_WRITE_I2C_BLOCK | 579 + * ((priv->features & FEATURE_SMBUS_PEC) ? I2C_FUNC_SMBUS_PEC : 0) | 580 + * ((priv->features & FEATURE_I2C_BLOCK_READ) ? 581 + * I2C_FUNC_SMBUS_READ_I2C_BLOCK : 0); 582 + */ 589 583 590 584 // http://lxr.free-electrons.com/source/include/uapi/linux/i2c.h#L85 591 585