Here's another instance: Documentation/devicetree/bindings/net/fsl-fec.txt: Required properties: - phy-mode : String, operation mode of the PHY interface. Supported values are: "mii", "gmii", "sgmii", "tbi", "rmii", "rgmii", "rgmii-id", "rgmii-rxid", "rgmii-txid", "rtbi", "smii". Is this really required? Maybe someone can point to where the code makes use of this, because I'm damned if I can find it: $ grep phy-mode drivers/net/ include/ net/ -r drivers/net/ethernet/marvell/mvneta.c: dev_err(&pdev->dev, "incorrect phy-mode\n"); drivers/net/ethernet/nxp/lpc_eth.c: phy-mode", NULL); "local-mac-address" in the optional properties also falls into this category: only a small handful of network drivers make use of this, and fec is not one of them. What's the use of documentation if its inaccurate. -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html