docs: i2c: replace "I2C-transfer" -> "I2C transfer" consistently

"I2C transfer" is a legitimate english sentence, no need for a hyphen
between the two words, as as such it is used in most of the
documentation. Remove the hyphen in the few places where it is present.

Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net>
Acked-by: Peter Rosin <peda@axentia.se>
Reviewed-by: Jean Delvare <jdelvare@suse.de>
Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
This commit is contained in:
Luca Ceresoli 2020-01-29 16:19:31 +01:00 коммит произвёл Wolfram Sang
Родитель 40c573d12e
Коммит 48ca3b7fb8
1 изменённых файлов: 12 добавлений и 12 удалений

Просмотреть файл

@ -137,14 +137,14 @@ Mux-locked Example
When there is an access to D1, this happens: When there is an access to D1, this happens:
1. Someone issues an I2C-transfer to D1. 1. Someone issues an I2C transfer to D1.
2. M1 locks muxes on its parent (the root adapter in this case). 2. M1 locks muxes on its parent (the root adapter in this case).
3. M1 calls ->select to ready the mux. 3. M1 calls ->select to ready the mux.
4. M1 (presumably) does some I2C-transfers as part of its select. 4. M1 (presumably) does some I2C transfers as part of its select.
These transfers are normal I2C-transfers that locks the parent These transfers are normal I2C transfers that locks the parent
adapter. adapter.
5. M1 feeds the I2C-transfer from step 1 to its parent adapter as a 5. M1 feeds the I2C transfer from step 1 to its parent adapter as a
normal I2C-transfer that locks the parent adapter. normal I2C transfer that locks the parent adapter.
6. M1 calls ->deselect, if it has one. 6. M1 calls ->deselect, if it has one.
7. Same rules as in step 4, but for ->deselect. 7. Same rules as in step 4, but for ->deselect.
8. M1 unlocks muxes on its parent. 8. M1 unlocks muxes on its parent.
@ -169,7 +169,7 @@ PL1. If you build a topology with a parent-locked mux being the child
of another mux, this might break a possible assumption from the of another mux, this might break a possible assumption from the
child mux that the root adapter is unused between its select op child mux that the root adapter is unused between its select op
and the actual transfer (e.g. if the child mux is auto-closing and the actual transfer (e.g. if the child mux is auto-closing
and the parent mux issues I2C-transfers as part of its select). and the parent mux issues I2C transfers as part of its select).
This is especially the case if the parent mux is mux-locked, but This is especially the case if the parent mux is mux-locked, but
it may also happen if the parent mux is parent-locked. it may also happen if the parent mux is parent-locked.
@ -197,15 +197,15 @@ Parent-locked Example
When there is an access to D1, this happens: When there is an access to D1, this happens:
1. Someone issues an I2C-transfer to D1. 1. Someone issues an I2C transfer to D1.
2. M1 locks muxes on its parent (the root adapter in this case). 2. M1 locks muxes on its parent (the root adapter in this case).
3. M1 locks its parent adapter. 3. M1 locks its parent adapter.
4. M1 calls ->select to ready the mux. 4. M1 calls ->select to ready the mux.
5. If M1 does any I2C-transfers (on this root adapter) as part of 5. If M1 does any I2C transfers (on this root adapter) as part of
its select, those transfers must be unlocked I2C-transfers so its select, those transfers must be unlocked I2C transfers so
that they do not deadlock the root adapter. that they do not deadlock the root adapter.
6. M1 feeds the I2C-transfer from step 1 to the root adapter as an 6. M1 feeds the I2C transfer from step 1 to the root adapter as an
unlocked I2C-transfer, so that it does not deadlock the parent unlocked I2C transfer, so that it does not deadlock the parent
adapter. adapter.
7. M1 calls ->deselect, if it has one. 7. M1 calls ->deselect, if it has one.
8. Same rules as in step 5, but for ->deselect. 8. Same rules as in step 5, but for ->deselect.
@ -293,7 +293,7 @@ device lockups and/or other problems.
The topology is especially troublesome if M2 is an auto-closing The topology is especially troublesome if M2 is an auto-closing
mux. In that case, any interleaved accesses to D4 might close M2 mux. In that case, any interleaved accesses to D4 might close M2
prematurely, as might any I2C-transfers part of M1->select. prematurely, as might any I2C transfers part of M1->select.
But if M2 is not making the above stated assumption, and if M2 is not But if M2 is not making the above stated assumption, and if M2 is not
auto-closing, the topology is fine. auto-closing, the topology is fine.