* [PATCH net-next 0/2] Documentation: ACPI: DSD: fix some build warnings
@ 2021-06-17 15:55 Ioana Ciornei
2021-06-17 15:55 ` [PATCH net-next 1/2] Documentation: ACPI: DSD: include phy.rst in the toctree Ioana Ciornei
` (2 more replies)
0 siblings, 3 replies; 4+ messages in thread
From: Ioana Ciornei @ 2021-06-17 15:55 UTC (permalink / raw)
To: davem, kuba, netdev
Cc: rjw, calvin.johnson, grant.likely, lenb, Ioana Ciornei
From: Ioana Ciornei <ioana.ciornei@nxp.com>
Fix some build warnings in the phy.rst documentation describing the MDIO
bus and PHYs in ACPI.
Ioana Ciornei (2):
Documentation: ACPI: DSD: include phy.rst in the toctree
Documentation: ACPI: DSD: fix block code comments
Documentation/firmware-guide/acpi/dsd/phy.rst | 15 +++++++++++----
Documentation/firmware-guide/acpi/index.rst | 1 +
2 files changed, 12 insertions(+), 4 deletions(-)
--
2.31.1
^ permalink raw reply [flat|nested] 4+ messages in thread
* [PATCH net-next 1/2] Documentation: ACPI: DSD: include phy.rst in the toctree
2021-06-17 15:55 [PATCH net-next 0/2] Documentation: ACPI: DSD: fix some build warnings Ioana Ciornei
@ 2021-06-17 15:55 ` Ioana Ciornei
2021-06-17 15:55 ` [PATCH net-next 2/2] Documentation: ACPI: DSD: fix block code comments Ioana Ciornei
2021-06-18 18:40 ` [PATCH net-next 0/2] Documentation: ACPI: DSD: fix some build warnings patchwork-bot+netdevbpf
2 siblings, 0 replies; 4+ messages in thread
From: Ioana Ciornei @ 2021-06-17 15:55 UTC (permalink / raw)
To: davem, kuba, netdev
Cc: rjw, calvin.johnson, grant.likely, lenb, Ioana Ciornei, Stephen Rothwell
From: Ioana Ciornei <ioana.ciornei@nxp.com>
Include the new phy.rst into the index of the ACPI support
documentation.
Fixes: e71305acd81c ("Documentation: ACPI: DSD: Document MDIO PHY")
Reported-by: Stephen Rothwell <sfr@canb.auug.org.au>
Signed-off-by: Ioana Ciornei <ioana.ciornei@nxp.com>
---
Documentation/firmware-guide/acpi/index.rst | 1 +
1 file changed, 1 insertion(+)
diff --git a/Documentation/firmware-guide/acpi/index.rst b/Documentation/firmware-guide/acpi/index.rst
index f72b5f1769fb..a99ee402b212 100644
--- a/Documentation/firmware-guide/acpi/index.rst
+++ b/Documentation/firmware-guide/acpi/index.rst
@@ -11,6 +11,7 @@ ACPI Support
dsd/graph
dsd/data-node-references
dsd/leds
+ dsd/phy
enumeration
osi
method-customizing
--
2.31.1
^ permalink raw reply related [flat|nested] 4+ messages in thread
* [PATCH net-next 2/2] Documentation: ACPI: DSD: fix block code comments
2021-06-17 15:55 [PATCH net-next 0/2] Documentation: ACPI: DSD: fix some build warnings Ioana Ciornei
2021-06-17 15:55 ` [PATCH net-next 1/2] Documentation: ACPI: DSD: include phy.rst in the toctree Ioana Ciornei
@ 2021-06-17 15:55 ` Ioana Ciornei
2021-06-18 18:40 ` [PATCH net-next 0/2] Documentation: ACPI: DSD: fix some build warnings patchwork-bot+netdevbpf
2 siblings, 0 replies; 4+ messages in thread
From: Ioana Ciornei @ 2021-06-17 15:55 UTC (permalink / raw)
To: davem, kuba, netdev
Cc: rjw, calvin.johnson, grant.likely, lenb, Ioana Ciornei, Stephen Rothwell
From: Ioana Ciornei <ioana.ciornei@nxp.com>
Use the '.. code-block:: none' to properly highlight the documented DSDT
entries. This also fixes warnings in the documentation build process.
Fixes: e71305acd81c ("Documentation: ACPI: DSD: Document MDIO PHY")
Reported-by: Stephen Rothwell <sfr@canb.auug.org.au>
Signed-off-by: Ioana Ciornei <ioana.ciornei@nxp.com>
---
Documentation/firmware-guide/acpi/dsd/phy.rst | 15 +++++++++++----
1 file changed, 11 insertions(+), 4 deletions(-)
diff --git a/Documentation/firmware-guide/acpi/dsd/phy.rst b/Documentation/firmware-guide/acpi/dsd/phy.rst
index 7d01ae8b3cc6..0d49bad2ea9c 100644
--- a/Documentation/firmware-guide/acpi/dsd/phy.rst
+++ b/Documentation/firmware-guide/acpi/dsd/phy.rst
@@ -27,7 +27,8 @@ network interfaces that have PHYs connected to MAC via MDIO bus.
During the MDIO bus driver initialization, PHYs on this bus are probed
using the _ADR object as shown below and are registered on the MDIO bus.
-::
+.. code-block:: none
+
Scope(\_SB.MDI0)
{
Device(PHY1) {
@@ -60,7 +61,9 @@ component (PHYs on the MDIO bus).
a) Silicon Component
This node describes the MDIO controller, MDI0
---------------------------------------------
-::
+
+.. code-block:: none
+
Scope(_SB)
{
Device(MDI0) {
@@ -80,7 +83,9 @@ This node describes the MDIO controller, MDI0
b) Platform Component
The PHY1 and PHY2 nodes represent the PHYs connected to MDIO bus MDI0
---------------------------------------------------------------------
-::
+
+.. code-block:: none
+
Scope(\_SB.MDI0)
{
Device(PHY1) {
@@ -98,7 +103,9 @@ DSDT entries representing MAC nodes
Below are the MAC nodes where PHY nodes are referenced.
phy-mode and phy-handle are used as explained earlier.
------------------------------------------------------
-::
+
+.. code-block:: none
+
Scope(\_SB.MCE0.PR17)
{
Name (_DSD, Package () {
--
2.31.1
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH net-next 0/2] Documentation: ACPI: DSD: fix some build warnings
2021-06-17 15:55 [PATCH net-next 0/2] Documentation: ACPI: DSD: fix some build warnings Ioana Ciornei
2021-06-17 15:55 ` [PATCH net-next 1/2] Documentation: ACPI: DSD: include phy.rst in the toctree Ioana Ciornei
2021-06-17 15:55 ` [PATCH net-next 2/2] Documentation: ACPI: DSD: fix block code comments Ioana Ciornei
@ 2021-06-18 18:40 ` patchwork-bot+netdevbpf
2 siblings, 0 replies; 4+ messages in thread
From: patchwork-bot+netdevbpf @ 2021-06-18 18:40 UTC (permalink / raw)
To: Ioana Ciornei
Cc: davem, kuba, netdev, rjw, calvin.johnson, grant.likely, lenb,
ioana.ciornei
Hello:
This series was applied to netdev/net-next.git (refs/heads/master):
On Thu, 17 Jun 2021 18:55:50 +0300 you wrote:
> From: Ioana Ciornei <ioana.ciornei@nxp.com>
>
> Fix some build warnings in the phy.rst documentation describing the MDIO
> bus and PHYs in ACPI.
>
> Ioana Ciornei (2):
> Documentation: ACPI: DSD: include phy.rst in the toctree
> Documentation: ACPI: DSD: fix block code comments
>
> [...]
Here is the summary with links:
- [net-next,1/2] Documentation: ACPI: DSD: include phy.rst in the toctree
https://git.kernel.org/netdev/net-next/c/79ab2b37034b
- [net-next,2/2] Documentation: ACPI: DSD: fix block code comments
https://git.kernel.org/netdev/net-next/c/5a336f97f1f5
You are awesome, thank you!
--
Deet-doot-dot, I am a bot.
https://korg.docs.kernel.org/patchwork/pwbot.html
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2021-06-18 18:40 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-06-17 15:55 [PATCH net-next 0/2] Documentation: ACPI: DSD: fix some build warnings Ioana Ciornei
2021-06-17 15:55 ` [PATCH net-next 1/2] Documentation: ACPI: DSD: include phy.rst in the toctree Ioana Ciornei
2021-06-17 15:55 ` [PATCH net-next 2/2] Documentation: ACPI: DSD: fix block code comments Ioana Ciornei
2021-06-18 18:40 ` [PATCH net-next 0/2] Documentation: ACPI: DSD: fix some build warnings patchwork-bot+netdevbpf
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).