[i2c] [patch 2.6.25-rc1] i2c: improve smbus-protocol documentation

[Jean Delvare]

Hi David,

On Sat, 3 May 2008 17:50:33 -0700, David Brownell wrote:
> Improve the smbus-protocol documentation file somewhat:
> 
>  - Use the names of the SMBus protocol operations (from the 2.0
>    specification), not made-up-for-Linux names.
> 
>  - Add the name of the call used to execute each operation ... and
>    point out that there are mismatches, where functions execute
>    different protocol operations than their names specify.
>    
> The most confusing examples are that "Read Byte" isn't executed by
> i2c_smbus_read_byte(), and that "Write Byte" isn't executed by
> i2c_smbus_write_byte().  When coding, that's not as bad as it may
> seem; but that case would seem to be worth fixing.
> 
> Signed-off-by: David Brownell <dbrownell at users.sourceforge.net>
> ---
> As doc-only, this is appropriate for bundling with any I2C fixes
> before the 2.6.26-final code freeze.  Note that this doesn't address
> the confusion between "command" and "register" in this text, though
> in some cases it reduces confusion between "command" and "protocol
> operation" or "function call".
> 
>  Documentation/i2c/smbus-protocol |   75 +++++++++++++++++++++------------------
>  1 file changed, 42 insertions(+), 33 deletions(-)

Applied, thanks for doing this. This patch will be included in my next
batch to Linus (probably today or tomorrow.)

-- 
Jean Delvare