| Message ID | bce6d8c98a188ec5f0efe78962aa12839c7442e9.1561723980.git.mchehab+samsung@kernel.org (mailing list archive) |
|---|---|
| State | Accepted, archived |
| Delegated to: | Rafael Wysocki |
| Headers | show |
| Series | None | expand |
Hi Mauro, On 19. 6. 28. 오후 9:20, Mauro Carvalho Chehab wrote: > The intel-int3496.txt file is a documentation for an ACPI driver. > > There's no reason to keep it on a separate directory. > > So, instead of keeping it on some random location, move it > to a sub-directory inside the ACPI documentation dir, > renaming it to .rst. > > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> > --- > .../acpi/extcon-intel-int3496.rst} | 14 ++++++++++---- > Documentation/firmware-guide/acpi/index.rst | 1 + > MAINTAINERS | 6 +++--- > 3 files changed, 14 insertions(+), 7 deletions(-) > rename Documentation/{extcon/intel-int3496.txt => firmware-guide/acpi/extcon-intel-int3496.rst} (66%) > > diff --git a/Documentation/extcon/intel-int3496.txt b/Documentation/firmware-guide/acpi/extcon-intel-int3496.rst > similarity index 66% > rename from Documentation/extcon/intel-int3496.txt > rename to Documentation/firmware-guide/acpi/extcon-intel-int3496.rst > index 8155dbc7fad3..5137ca834b54 100644 > --- a/Documentation/extcon/intel-int3496.txt > +++ b/Documentation/firmware-guide/acpi/extcon-intel-int3496.rst > @@ -1,5 +1,6 @@ > +===================================================== > Intel INT3496 ACPI device extcon driver documentation > ------------------------------------------------------ > +===================================================== > > The Intel INT3496 ACPI device extcon driver is a driver for ACPI > devices with an acpi-id of INT3496, such as found for example on > @@ -13,15 +14,20 @@ between an USB host and an USB peripheral controller. > The ACPI devices exposes this functionality by returning an array with up > to 3 gpio descriptors from its ACPI _CRS (Current Resource Settings) call: > > -Index 0: The input gpio for the id-pin, this is always present and valid > -Index 1: The output gpio for enabling Vbus output from the device to the otg > +======= ===================================================================== > +Index 0 The input gpio for the id-pin, this is always present and valid > +Index 1 The output gpio for enabling Vbus output from the device to the otg > port, write 1 to enable the Vbus output (this gpio descriptor may > be absent or invalid) > -Index 2: The output gpio for muxing of the data pins between the USB host and > +Index 2 The output gpio for muxing of the data pins between the USB host and > the USB peripheral controller, write 1 to mux to the peripheral > controller > +======= ===================================================================== > > There is a mapping between indices and GPIO connection IDs as follows > + > + ======= ======= > id index 0 > vbus index 1 > mux index 2 > + ======= ======= > diff --git a/Documentation/firmware-guide/acpi/index.rst b/Documentation/firmware-guide/acpi/index.rst > index ae609eec4679..90c90d42d9ad 100644 > --- a/Documentation/firmware-guide/acpi/index.rst > +++ b/Documentation/firmware-guide/acpi/index.rst > @@ -24,3 +24,4 @@ ACPI Support > acpi-lid > lpit > video_extension > + extcon-intel-int3496 > diff --git a/MAINTAINERS b/MAINTAINERS > index fd6fab0dec77..2cf8abf6d48e 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -321,7 +321,7 @@ F: drivers/pnp/pnpacpi/ > F: include/linux/acpi.h > F: include/linux/fwnode.h > F: include/acpi/ > -F: Documentation/acpi/ > +F: Documentation/firmware-guide/acpi/ > F: Documentation/ABI/testing/sysfs-bus-acpi > F: Documentation/ABI/testing/configfs-acpi > F: drivers/pci/*acpi* > @@ -4896,7 +4896,7 @@ S: Maintained > F: Documentation/ > F: scripts/kernel-doc > X: Documentation/ABI/ > -X: Documentation/acpi/ > +X: Documentation/firmware-guide/acpi/ > X: Documentation/devicetree/ > X: Documentation/i2c/ > X: Documentation/media/ > @@ -6073,7 +6073,7 @@ S: Maintained > F: drivers/extcon/ > F: include/linux/extcon/ > F: include/linux/extcon.h > -F: Documentation/extcon/ > +F: Documentation/firmware-guide/acpi/extcon-intel-int3496.rst > F: Documentation/devicetree/bindings/extcon/ > > EXYNOS DP DRIVER > Acked-by: Chanwoo Choi <cw00.choi@samsung.com>
On Friday, June 28, 2019 2:20:37 PM CEST Mauro Carvalho Chehab wrote: > The intel-int3496.txt file is a documentation for an ACPI driver. > > There's no reason to keep it on a separate directory. > > So, instead of keeping it on some random location, move it > to a sub-directory inside the ACPI documentation dir, > renaming it to .rst. > > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> > --- > .../acpi/extcon-intel-int3496.rst} | 14 ++++++++++---- > Documentation/firmware-guide/acpi/index.rst | 1 + > MAINTAINERS | 6 +++--- > 3 files changed, 14 insertions(+), 7 deletions(-) > rename Documentation/{extcon/intel-int3496.txt => firmware-guide/acpi/extcon-intel-int3496.rst} (66%) > > diff --git a/Documentation/extcon/intel-int3496.txt b/Documentation/firmware-guide/acpi/extcon-intel-int3496.rst > similarity index 66% > rename from Documentation/extcon/intel-int3496.txt > rename to Documentation/firmware-guide/acpi/extcon-intel-int3496.rst > index 8155dbc7fad3..5137ca834b54 100644 > --- a/Documentation/extcon/intel-int3496.txt > +++ b/Documentation/firmware-guide/acpi/extcon-intel-int3496.rst > @@ -1,5 +1,6 @@ > +===================================================== > Intel INT3496 ACPI device extcon driver documentation > ------------------------------------------------------ > +===================================================== > > The Intel INT3496 ACPI device extcon driver is a driver for ACPI > devices with an acpi-id of INT3496, such as found for example on > @@ -13,15 +14,20 @@ between an USB host and an USB peripheral controller. > The ACPI devices exposes this functionality by returning an array with up > to 3 gpio descriptors from its ACPI _CRS (Current Resource Settings) call: > > -Index 0: The input gpio for the id-pin, this is always present and valid > -Index 1: The output gpio for enabling Vbus output from the device to the otg > +======= ===================================================================== > +Index 0 The input gpio for the id-pin, this is always present and valid > +Index 1 The output gpio for enabling Vbus output from the device to the otg > port, write 1 to enable the Vbus output (this gpio descriptor may > be absent or invalid) > -Index 2: The output gpio for muxing of the data pins between the USB host and > +Index 2 The output gpio for muxing of the data pins between the USB host and > the USB peripheral controller, write 1 to mux to the peripheral > controller > +======= ===================================================================== > > There is a mapping between indices and GPIO connection IDs as follows > + > + ======= ======= > id index 0 > vbus index 1 > mux index 2 > + ======= ======= > diff --git a/Documentation/firmware-guide/acpi/index.rst b/Documentation/firmware-guide/acpi/index.rst > index ae609eec4679..90c90d42d9ad 100644 > --- a/Documentation/firmware-guide/acpi/index.rst > +++ b/Documentation/firmware-guide/acpi/index.rst > @@ -24,3 +24,4 @@ ACPI Support > acpi-lid > lpit > video_extension > + extcon-intel-int3496 > diff --git a/MAINTAINERS b/MAINTAINERS > index fd6fab0dec77..2cf8abf6d48e 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -321,7 +321,7 @@ F: drivers/pnp/pnpacpi/ > F: include/linux/acpi.h > F: include/linux/fwnode.h > F: include/acpi/ > -F: Documentation/acpi/ > +F: Documentation/firmware-guide/acpi/ > F: Documentation/ABI/testing/sysfs-bus-acpi > F: Documentation/ABI/testing/configfs-acpi > F: drivers/pci/*acpi* > @@ -4896,7 +4896,7 @@ S: Maintained > F: Documentation/ > F: scripts/kernel-doc > X: Documentation/ABI/ > -X: Documentation/acpi/ > +X: Documentation/firmware-guide/acpi/ > X: Documentation/devicetree/ > X: Documentation/i2c/ > X: Documentation/media/ > @@ -6073,7 +6073,7 @@ S: Maintained > F: drivers/extcon/ > F: include/linux/extcon/ > F: include/linux/extcon.h > -F: Documentation/extcon/ > +F: Documentation/firmware-guide/acpi/extcon-intel-int3496.rst > F: Documentation/devicetree/bindings/extcon/ > > EXYNOS DP DRIVER > Applied, thanks!
diff --git a/Documentation/extcon/intel-int3496.txt b/Documentation/firmware-guide/acpi/extcon-intel-int3496.rst similarity index 66% rename from Documentation/extcon/intel-int3496.txt rename to Documentation/firmware-guide/acpi/extcon-intel-int3496.rst index 8155dbc7fad3..5137ca834b54 100644 --- a/Documentation/extcon/intel-int3496.txt +++ b/Documentation/firmware-guide/acpi/extcon-intel-int3496.rst @@ -1,5 +1,6 @@ +===================================================== Intel INT3496 ACPI device extcon driver documentation ------------------------------------------------------ +===================================================== The Intel INT3496 ACPI device extcon driver is a driver for ACPI devices with an acpi-id of INT3496, such as found for example on @@ -13,15 +14,20 @@ between an USB host and an USB peripheral controller. The ACPI devices exposes this functionality by returning an array with up to 3 gpio descriptors from its ACPI _CRS (Current Resource Settings) call: -Index 0: The input gpio for the id-pin, this is always present and valid -Index 1: The output gpio for enabling Vbus output from the device to the otg +======= ===================================================================== +Index 0 The input gpio for the id-pin, this is always present and valid +Index 1 The output gpio for enabling Vbus output from the device to the otg port, write 1 to enable the Vbus output (this gpio descriptor may be absent or invalid) -Index 2: The output gpio for muxing of the data pins between the USB host and +Index 2 The output gpio for muxing of the data pins between the USB host and the USB peripheral controller, write 1 to mux to the peripheral controller +======= ===================================================================== There is a mapping between indices and GPIO connection IDs as follows + + ======= ======= id index 0 vbus index 1 mux index 2 + ======= ======= diff --git a/Documentation/firmware-guide/acpi/index.rst b/Documentation/firmware-guide/acpi/index.rst index ae609eec4679..90c90d42d9ad 100644 --- a/Documentation/firmware-guide/acpi/index.rst +++ b/Documentation/firmware-guide/acpi/index.rst @@ -24,3 +24,4 @@ ACPI Support acpi-lid lpit video_extension + extcon-intel-int3496 diff --git a/MAINTAINERS b/MAINTAINERS index fd6fab0dec77..2cf8abf6d48e 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -321,7 +321,7 @@ F: drivers/pnp/pnpacpi/ F: include/linux/acpi.h F: include/linux/fwnode.h F: include/acpi/ -F: Documentation/acpi/ +F: Documentation/firmware-guide/acpi/ F: Documentation/ABI/testing/sysfs-bus-acpi F: Documentation/ABI/testing/configfs-acpi F: drivers/pci/*acpi* @@ -4896,7 +4896,7 @@ S: Maintained F: Documentation/ F: scripts/kernel-doc X: Documentation/ABI/ -X: Documentation/acpi/ +X: Documentation/firmware-guide/acpi/ X: Documentation/devicetree/ X: Documentation/i2c/ X: Documentation/media/ @@ -6073,7 +6073,7 @@ S: Maintained F: drivers/extcon/ F: include/linux/extcon/ F: include/linux/extcon.h -F: Documentation/extcon/ +F: Documentation/firmware-guide/acpi/extcon-intel-int3496.rst F: Documentation/devicetree/bindings/extcon/ EXYNOS DP DRIVER
The intel-int3496.txt file is a documentation for an ACPI driver. There's no reason to keep it on a separate directory. So, instead of keeping it on some random location, move it to a sub-directory inside the ACPI documentation dir, renaming it to .rst. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> --- .../acpi/extcon-intel-int3496.rst} | 14 ++++++++++---- Documentation/firmware-guide/acpi/index.rst | 1 + MAINTAINERS | 6 +++--- 3 files changed, 14 insertions(+), 7 deletions(-) rename Documentation/{extcon/intel-int3496.txt => firmware-guide/acpi/extcon-intel-int3496.rst} (66%)