Re: [LINUX PATCH] net: axienet: Fix axiethernet register description

[Andrew Lunn]

On Sat, Jul 13, 2024 at 06:48:07PM +0530, Suraj Gupta wrote:
> Rename axiethernet register description to be inline with product guide
> register names. It also removes obsolete registers and bitmasks. There is
> no functional impact since the modified offsets are only renamed.
> 
> Rename XAE_PHYC_OFFSET->XAE_RMFC_OFFSET (Only used in ethtool get_regs)
> XAE_MDIO_* : update documentation comment.
> Remove unused Bit masks for Axi Ethernet PHYC register.
> Remove bit masks for MDIO interface MIS, MIP, MIE, MIC registers.
> Rename XAE_FMI -> XAE_FMC.

Might be too way out there, but why not modify the documentation to
fit Linux? This driver is likely to get bug fixes, and renames like
this make it harder to backport those fixes. Documentation on the
other hand just tends to get erratas, either in a separate document,
or appended to the beginning/end. There is no applying patches to
documentation.

	Andrew