Skip to contentSkip to conversation

doc: sfp-phylink: correct code indentation

PATCH Applied Russell King 3 participants 3 messages Mar 3, 2020 – Mar 4, 2020

Subsystems (3)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: sfp-phylink: correct code indentation

Using vim to edit the phylink documentation reveals some mistakes due to the "invisible" pythonesque white space indentation that can't be seen with other editors. Fix it.

---
 Documentation/networking/sfp-phylink.rst | 32 ++++++++++++------------
 1 file changed, 16 insertions(+), 16 deletions(-)
Documentation/networking/sfp-phylink.rst +16 -16
index 8d7af28cd835..5aec7c8857d0 100644
@@ -138,27 +138,27 @@ this documentation.
 
    .. code-block:: c
 
-    static int foo_ethtool_set_link_ksettings(struct net_device *dev,
-					     const struct ethtool_link_ksettings *cmd)
-    {
-	struct foo_priv *priv = netdev_priv(dev);
-
-	return phylink_ethtool_ksettings_set(priv->phylink, cmd);
-    }
-
-    static int foo_ethtool_get_link_ksettings(struct net_device *dev,
-					     struct ethtool_link_ksettings *cmd)
-    {
-	struct foo_priv *priv = netdev_priv(dev);
+	static int foo_ethtool_set_link_ksettings(struct net_device *dev,
+						  const struct ethtool_link_ksettings *cmd)
+	{
+		struct foo_priv *priv = netdev_priv(dev);
+	
+		return phylink_ethtool_ksettings_set(priv->phylink, cmd);
+	}
 
-	return phylink_ethtool_ksettings_get(priv->phylink, cmd);
-    }
+	static int foo_ethtool_get_link_ksettings(struct net_device *dev,
+						  struct ethtool_link_ksettings *cmd)
+	{
+		struct foo_priv *priv = netdev_priv(dev);
+	
+		return phylink_ethtool_ksettings_get(priv->phylink, cmd);
+	}
 
-7. Replace the call to:
+7. Replace the call to::
 
 	phy_dev = of_phy_connect(dev, node, link_func, flags, phy_interface);
 
-   and associated code with a call to:
+   and associated code with a call to::
 
 	err = phylink_of_phy_connect(priv->phylink, node, flags);
 
Signature · 1 line
2.20.1
maintainer Applied
#1 lore raw

From: Russell King <[email protected]>
Date: Tue, 03 Mar 2020 13:29:42 +0000

Quoted 5 lines

Using vim to edit the phylink documentation reveals some mistakes due to the "invisible" pythonesque white space indentation that can't be seen with other editors. Fix it.

I applied this, but you do know that GIT is going to warn about the trailing whitespace to me:

.git/rebase-apply/patch:29: trailing whitespace.

.git/rebase-apply/patch:39: trailing whitespace.

warning: 2 lines add whitespace errors.

Do the empty lines really need that leading TAB?

#2 lore raw
Quoted 12 lines · David Miller

From: Russell King <[email protected]>
Date: Tue, 03 Mar 2020 13:29:42 +0000

Quoted 5 lines

Using vim to edit the phylink documentation reveals some mistakes due to the "invisible" pythonesque white space indentation that can't be seen with other editors. Fix it.

I applied this, but you do know that GIT is going to warn about the trailing whitespace to me:

Quoted 7 lines

.git/rebase-apply/patch:29: trailing whitespace.

.git/rebase-apply/patch:39: trailing whitespace.

warning: 2 lines add whitespace errors.

Do the empty lines really need that leading TAB?

If vim's syntax colouring is correct, then it does need the tab for the code sequence to be recognised as a block of code.

As kerneldoc is based on python, and white-space indentation defining a block of code is a very (annoying) pythonesque thing, it seems that vim's probably correct. But... unless someone knows how the .rst format really works...

It could be that vim's syntax colouring for .rst files is broken. I was hoping that the documentation people would've spoken up about that though, as I explicitly stated in the commit message that the patch was based on vim's behaviour.

Not having the tabs causes vim to reverse-bold a lot of the file, making it basically uneditable without sunglasses.

Signature · 3 lines
RMK's Patch system: https://www.armlinux.org.uk/developer/patches/
FTTC broadband for 0.8mile line in suburbia: sync at 12.1Mbps down 622kbps up
According to speedtest.net: 11.9Mbps down 500kbps up