Skip to contentSkip to conversation

net: organize driver docs by device type

RFC In review Jakub Kicinski 4 participants 15 messages Jun 11, 2020 – Jun 12, 2020

Subsystems (25)
lore
Share & tools
lore

Jakub Kicinski

author maintainer
#0 lore raw

cover net: organize driver docs by device type

Hi!

This series finishes off what I started in
commit b255e500c8dc ("net: documentation: build a directory structure for drivers"). The objective is to de-clutter our documentation folder so folks
have a chance of finding relevant info. I _think_ I got all the
driver docs from the main documentation directory this time around.

While doing this I realized that many of them are of limited relevance these days, so I went ahead and sliced the drivers directory by technology. Those feeling nostalgic are free to dive into the FDDI, ATM etc. docs, but for most Ethernet is what we care about.

Jakub Kicinski (8):
docs: networking: reorganize driver documentation again
docs: networking: move z8530 to the hw driver section
docs: networking: move baycom to the hw driver section
docs: networking: move ray_cs to the hw driver section
docs: networking: move remaining Ethernet driver docs to the hw
section
docs: networking: move AppleTalk / LocalTalk drivers to the hw driver
section
docs: networking: move ATM drivers to the hw driver section
docs: networking: move FDDI drivers to the hw driver section

 .../devicetree/bindings/misc/fsl,qoriq-mc.txt |  2 +-
 .../{ => device_drivers/appletalk}/cops.rst   |  0
 .../device_drivers/appletalk/index.rst        | 19 +++++
 .../{ => device_drivers/appletalk}/ltpc.rst   |  0
 .../{ => device_drivers/atm}/cxacru-cf.py     |  0
 .../{ => device_drivers/atm}/cxacru.rst       |  0
 .../{ => device_drivers/atm}/fore200e.rst     |  0
 .../networking/device_drivers/atm/index.rst   | 20 ++++++
 .../{ => device_drivers/atm}/iphase.rst       |  0
 .../networking/device_drivers/cable/index.rst | 18 +++++
 .../device_drivers/{ => cable}/sb1000.rst     |  0
 .../device_drivers/cellular/index.rst         | 18 +++++
 .../{ => cellular}/qualcomm/rmnet.rst         |  0
 .../{ => ethernet}/3com/3c509.rst             |  0
 .../{ => ethernet}/3com/vortex.rst            |  2 -
 .../ethernet/altera}/altera_tse.rst           |  0
 .../{ => ethernet}/amazon/ena.rst             |  0
 .../{ => ethernet}/aquantia/atlantic.rst      |  0
 .../{ => ethernet}/chelsio/cxgb.rst           |  0
 .../{ => ethernet}/cirrus/cs89x0.rst          |  0
 .../{ => ethernet}/davicom/dm9000.rst         |  0
 .../{ => ethernet}/dec/de4x5.rst              |  0
 .../{ => ethernet}/dec/dmfe.rst               |  0
 .../{ => ethernet}/dlink/dl2k.rst             |  0
 .../{ => ethernet}/freescale/dpaa.rst         |  0
 .../freescale/dpaa2/dpio-driver.rst           |  6 +-
 .../freescale/dpaa2/ethernet-driver.rst       |  3 +-
 .../{ => ethernet}/freescale/dpaa2/index.rst  |  0
 .../freescale/dpaa2/mac-phy-support.rst       |  0
 .../freescale/dpaa2/overview.rst              |  0
 .../{ => ethernet}/freescale/gianfar.rst      |  0
 .../{ => ethernet}/google/gve.rst             |  0
 .../ethernet/huawei}/hinic.rst                |  0
 .../device_drivers/ethernet/index.rst         | 60 ++++++++++++++++
 .../{ => ethernet}/intel/e100.rst             |  0
 .../{ => ethernet}/intel/e1000.rst            |  0
 .../{ => ethernet}/intel/e1000e.rst           |  0
 .../{ => ethernet}/intel/fm10k.rst            |  0
 .../{ => ethernet}/intel/i40e.rst             |  0
 .../{ => ethernet}/intel/iavf.rst             |  0
 .../{ => ethernet}/intel/ice.rst              |  0
 .../{ => ethernet}/intel/igb.rst              |  0
 .../{ => ethernet}/intel/igbvf.rst            |  0
 .../{ => ethernet}/intel/ixgb.rst             |  0
 .../{ => ethernet}/intel/ixgbe.rst            |  0
 .../{ => ethernet}/intel/ixgbevf.rst          |  0
 .../{ => ethernet}/marvell/octeontx2.rst      |  0
 .../{ => ethernet}/mellanox/mlx5.rst          |  0
 .../{ => ethernet}/microsoft/netvsc.rst       |  0
 .../{ => ethernet}/neterion/s2io.rst          |  0
 .../{ => ethernet}/neterion/vxge.rst          |  0
 .../{ => ethernet}/netronome/nfp.rst          |  0
 .../{ => ethernet}/pensando/ionic.rst         |  0
 .../{ => ethernet}/smsc/smc9.rst              |  0
 .../{ => ethernet}/stmicro/stmmac.rst         |  0
 .../device_drivers/{ => ethernet}/ti/cpsw.rst |  0
 .../{ => ethernet}/ti/cpsw_switchdev.rst      |  0
 .../device_drivers/{ => ethernet}/ti/tlan.rst |  0
 .../{ => ethernet}/toshiba/spider_net.rst     |  0
 .../{ => device_drivers/fddi}/defza.rst       |  0
 .../networking/device_drivers/fddi/index.rst  | 19 +++++
 .../{ => device_drivers/fddi}/skfp.rst        |  0
 .../{ => device_drivers/hamradio}/baycom.rst  |  0
 .../device_drivers/hamradio/index.rst         | 19 +++++
 .../hamradio}/z8530drv.rst                    |  0
 .../networking/device_drivers/index.rst       | 56 +++------------
 .../networking/device_drivers/wan/index.rst   | 18 +++++
 .../{ => device_drivers/wan}/z8530book.rst    |  0
 .../networking/device_drivers/wifi/index.rst  | 20 ++++++
 .../{ => wifi}/intel/ipw2100.rst              |  0
 .../{ => wifi}/intel/ipw2200.rst              |  0
 .../{ => device_drivers/wifi}/ray_cs.rst      |  0
 Documentation/networking/index.rst            | 13 ----
 MAINTAINERS                                   | 70 +++++++++----------
 drivers/atm/Kconfig                           |  8 ++-
 drivers/net/Kconfig                           |  2 +-
 drivers/net/appletalk/Kconfig                 |  3 +-
 drivers/net/ethernet/3com/3c59x.c             |  4 +-
 drivers/net/ethernet/3com/Kconfig             |  4 +-
 drivers/net/ethernet/chelsio/Kconfig          |  2 +-
 drivers/net/ethernet/cirrus/Kconfig           |  2 +-
 drivers/net/ethernet/dec/tulip/Kconfig        |  4 +-
 drivers/net/ethernet/dlink/dl2k.c             | 10 +--
 drivers/net/ethernet/intel/Kconfig            | 24 +++----
 drivers/net/ethernet/neterion/Kconfig         |  4 +-
 drivers/net/ethernet/pensando/Kconfig         |  2 +-
 drivers/net/ethernet/smsc/Kconfig             |  4 +-
 drivers/net/ethernet/ti/Kconfig               |  2 +-
 drivers/net/ethernet/ti/tlan.c                |  2 +-
 drivers/net/fddi/Kconfig                      |  4 +-
 drivers/net/hamradio/Kconfig                  | 16 +++--
 drivers/net/hamradio/scc.c                    |  2 +-
 drivers/net/wireless/Kconfig                  |  3 +-
 drivers/net/wireless/intel/ipw2x00/Kconfig    |  4 +-
 drivers/net/wireless/intel/ipw2x00/ipw2100.c  |  2 +-
 95 files changed, 317 insertions(+), 154 deletions(-)
 rename Documentation/networking/{ => device_drivers/appletalk}/cops.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/appletalk/index.rst
 rename Documentation/networking/{ => device_drivers/appletalk}/ltpc.rst (100%)
 rename Documentation/networking/{ => device_drivers/atm}/cxacru-cf.py (100%)
 rename Documentation/networking/{ => device_drivers/atm}/cxacru.rst (100%)
 rename Documentation/networking/{ => device_drivers/atm}/fore200e.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/atm/index.rst
 rename Documentation/networking/{ => device_drivers/atm}/iphase.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/cable/index.rst
 rename Documentation/networking/device_drivers/{ => cable}/sb1000.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/cellular/index.rst
 rename Documentation/networking/device_drivers/{ => cellular}/qualcomm/rmnet.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/3com/3c509.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/3com/vortex.rst (99%)
 rename Documentation/networking/{ => device_drivers/ethernet/altera}/altera_tse.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/amazon/ena.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/aquantia/atlantic.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/chelsio/cxgb.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/cirrus/cs89x0.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/davicom/dm9000.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/dec/de4x5.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/dec/dmfe.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/dlink/dl2k.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa2/dpio-driver.rst (97%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa2/ethernet-driver.rst (98%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa2/index.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa2/mac-phy-support.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa2/overview.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/gianfar.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/google/gve.rst (100%)
 rename Documentation/networking/{ => device_drivers/ethernet/huawei}/hinic.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/ethernet/index.rst
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/e100.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/e1000.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/e1000e.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/fm10k.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/i40e.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/iavf.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/ice.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/igb.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/igbvf.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/ixgb.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/ixgbe.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/ixgbevf.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/marvell/octeontx2.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/mellanox/mlx5.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/microsoft/netvsc.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/neterion/s2io.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/neterion/vxge.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/netronome/nfp.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/pensando/ionic.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/smsc/smc9.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/stmicro/stmmac.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/ti/cpsw.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/ti/cpsw_switchdev.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/ti/tlan.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/toshiba/spider_net.rst (100%)
 rename Documentation/networking/{ => device_drivers/fddi}/defza.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/fddi/index.rst
 rename Documentation/networking/{ => device_drivers/fddi}/skfp.rst (100%)
 rename Documentation/networking/{ => device_drivers/hamradio}/baycom.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/hamradio/index.rst
 rename Documentation/networking/{ => device_drivers/hamradio}/z8530drv.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/wan/index.rst
 rename Documentation/networking/{ => device_drivers/wan}/z8530book.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/wifi/index.rst
 rename Documentation/networking/device_drivers/{ => wifi}/intel/ipw2100.rst (100%)
 rename Documentation/networking/device_drivers/{ => wifi}/intel/ipw2200.rst (100%)
 rename Documentation/networking/{ => device_drivers/wifi}/ray_cs.rst (100%)
Signature · 1 line
2.26.2
author maintainer
#1 lore raw

RFC 1/8 docs: networking: reorganize driver documentation again

Organize driver documentation by device type. Most documents have fairly verbose yet uninformative names, so let users first select a well defined device type, and then search for a particular driver.

While at it rename the section from Vendor drivers to Hardware drivers. This seems more accurate, besides people sometimes refer to out-of-tree drivers as vendor drivers.

--
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]

---
 .../devicetree/bindings/misc/fsl,qoriq-mc.txt |  2 +-
 .../networking/device_drivers/cable/index.rst | 18 +++++
 .../device_drivers/{ => cable}/sb1000.rst     |  0
 .../device_drivers/cellular/index.rst         | 18 +++++
 .../{ => cellular}/qualcomm/rmnet.rst         |  0
 .../{ => ethernet}/3com/3c509.rst             |  0
 .../{ => ethernet}/3com/vortex.rst            |  2 -
 .../{ => ethernet}/amazon/ena.rst             |  0
 .../{ => ethernet}/aquantia/atlantic.rst      |  0
 .../{ => ethernet}/chelsio/cxgb.rst           |  0
 .../{ => ethernet}/cirrus/cs89x0.rst          |  0
 .../{ => ethernet}/davicom/dm9000.rst         |  0
 .../{ => ethernet}/dec/de4x5.rst              |  0
 .../{ => ethernet}/dec/dmfe.rst               |  0
 .../{ => ethernet}/dlink/dl2k.rst             |  0
 .../{ => ethernet}/freescale/dpaa.rst         |  0
 .../freescale/dpaa2/dpio-driver.rst           |  6 +-
 .../freescale/dpaa2/ethernet-driver.rst       |  3 +-
 .../{ => ethernet}/freescale/dpaa2/index.rst  |  0
 .../freescale/dpaa2/mac-phy-support.rst       |  0
 .../freescale/dpaa2/overview.rst              |  0
 .../{ => ethernet}/freescale/gianfar.rst      |  0
 .../{ => ethernet}/google/gve.rst             |  0
 .../device_drivers/ethernet/index.rst         | 58 ++++++++++++++++
 .../{ => ethernet}/intel/e100.rst             |  0
 .../{ => ethernet}/intel/e1000.rst            |  0
 .../{ => ethernet}/intel/e1000e.rst           |  0
 .../{ => ethernet}/intel/fm10k.rst            |  0
 .../{ => ethernet}/intel/i40e.rst             |  0
 .../{ => ethernet}/intel/iavf.rst             |  0
 .../{ => ethernet}/intel/ice.rst              |  0
 .../{ => ethernet}/intel/igb.rst              |  0
 .../{ => ethernet}/intel/igbvf.rst            |  0
 .../{ => ethernet}/intel/ixgb.rst             |  0
 .../{ => ethernet}/intel/ixgbe.rst            |  0
 .../{ => ethernet}/intel/ixgbevf.rst          |  0
 .../{ => ethernet}/marvell/octeontx2.rst      |  0
 .../{ => ethernet}/mellanox/mlx5.rst          |  0
 .../{ => ethernet}/microsoft/netvsc.rst       |  0
 .../{ => ethernet}/neterion/s2io.rst          |  0
 .../{ => ethernet}/neterion/vxge.rst          |  0
 .../{ => ethernet}/netronome/nfp.rst          |  0
 .../{ => ethernet}/pensando/ionic.rst         |  0
 .../{ => ethernet}/smsc/smc9.rst              |  0
 .../{ => ethernet}/stmicro/stmmac.rst         |  0
 .../device_drivers/{ => ethernet}/ti/cpsw.rst |  0
 .../{ => ethernet}/ti/cpsw_switchdev.rst      |  0
 .../device_drivers/{ => ethernet}/ti/tlan.rst |  0
 .../{ => ethernet}/toshiba/spider_net.rst     |  0
 .../networking/device_drivers/index.rst       | 51 ++------------
 .../networking/device_drivers/wifi/index.rst  | 19 ++++++
 .../{ => wifi}/intel/ipw2100.rst              |  0
 .../{ => wifi}/intel/ipw2200.rst              |  0
 MAINTAINERS                                   | 66 +++++++++----------
 drivers/net/Kconfig                           |  2 +-
 drivers/net/ethernet/3com/3c59x.c             |  4 +-
 drivers/net/ethernet/3com/Kconfig             |  4 +-
 drivers/net/ethernet/chelsio/Kconfig          |  2 +-
 drivers/net/ethernet/cirrus/Kconfig           |  2 +-
 drivers/net/ethernet/dec/tulip/Kconfig        |  4 +-
 drivers/net/ethernet/dlink/dl2k.c             | 10 +--
 drivers/net/ethernet/intel/Kconfig            | 24 +++----
 drivers/net/ethernet/neterion/Kconfig         |  4 +-
 drivers/net/ethernet/pensando/Kconfig         |  2 +-
 drivers/net/ethernet/smsc/Kconfig             |  4 +-
 drivers/net/ethernet/ti/Kconfig               |  2 +-
 drivers/net/ethernet/ti/tlan.c                |  2 +-
 drivers/net/wireless/intel/ipw2x00/Kconfig    |  4 +-
 drivers/net/wireless/intel/ipw2x00/ipw2100.c  |  2 +-
 69 files changed, 191 insertions(+), 124 deletions(-)
 create mode 100644 Documentation/networking/device_drivers/cable/index.rst
 rename Documentation/networking/device_drivers/{ => cable}/sb1000.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/cellular/index.rst
 rename Documentation/networking/device_drivers/{ => cellular}/qualcomm/rmnet.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/3com/3c509.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/3com/vortex.rst (99%)
 rename Documentation/networking/device_drivers/{ => ethernet}/amazon/ena.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/aquantia/atlantic.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/chelsio/cxgb.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/cirrus/cs89x0.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/davicom/dm9000.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/dec/de4x5.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/dec/dmfe.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/dlink/dl2k.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa2/dpio-driver.rst (97%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa2/ethernet-driver.rst (98%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa2/index.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa2/mac-phy-support.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/dpaa2/overview.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/freescale/gianfar.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/google/gve.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/ethernet/index.rst
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/e100.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/e1000.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/e1000e.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/fm10k.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/i40e.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/iavf.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/ice.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/igb.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/igbvf.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/ixgb.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/ixgbe.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/ixgbevf.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/marvell/octeontx2.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/mellanox/mlx5.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/microsoft/netvsc.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/neterion/s2io.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/neterion/vxge.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/netronome/nfp.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/pensando/ionic.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/smsc/smc9.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/stmicro/stmmac.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/ti/cpsw.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/ti/cpsw_switchdev.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/ti/tlan.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/toshiba/spider_net.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/wifi/index.rst
 rename Documentation/networking/device_drivers/{ => wifi}/intel/ipw2100.rst (100%)
 rename Documentation/networking/device_drivers/{ => wifi}/intel/ipw2200.rst (100%)
Documentation/devicetree/bindings/misc/fsl,qoriq-mc.txt +1 -1
index 9134e9bcca56..b12f9be1251f 100644
@@ -10,7 +10,7 @@ such as network interfaces, crypto accelerator instances, L2 switches,
 etc.
 
 For an overview of the DPAA2 architecture and fsl-mc bus see:
-Documentation/networking/device_drivers/freescale/dpaa2/overview.rst
+Documentation/networking/device_drivers/ethernet/freescale/dpaa2/overview.rst
 
 As described in the above overview, all DPAA2 objects in a DPRC share the
 same hardware "isolation context" and a 10-bit value called an ICID
Documentation/networking/device_drivers/cable/index.rst new file +18 -0
new file mode 100644
index 000000000000..cce3c4392972
@@ -0,0 +1,18 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+Cable Modem Device Drivers
+==========================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   sb1000
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/cable/sb1000.rst renamed from Documentation/networking/device_drivers/sb1000.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/sb1000.rst
rename to Documentation/networking/device_drivers/cable/sb1000.rst
Documentation/networking/device_drivers/cellular/index.rst new file +18 -0
new file mode 100644
index 000000000000..fc1812d3fc70
@@ -0,0 +1,18 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+Cellular Modem Device Drivers
+=============================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   qualcomm/rmnet
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/cellular/qualcomm/rmnet.rst renamed from Documentation/networking/device_drivers/qualcomm/rmnet.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/qualcomm/rmnet.rst
rename to Documentation/networking/device_drivers/cellular/qualcomm/rmnet.rst
Documentation/networking/device_drivers/ethernet/3com/3c509.rst renamed from Documentation/networking/device_drivers/3com/3c509.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/3com/3c509.rst
rename to Documentation/networking/device_drivers/ethernet/3com/3c509.rst
Documentation/networking/device_drivers/ethernet/3com/vortex.rst renamed from Documentation/networking/device_drivers/3com/vortex.rst +0 -2
similarity index 99%
rename from Documentation/networking/device_drivers/3com/vortex.rst
rename to Documentation/networking/device_drivers/ethernet/3com/vortex.rst
index 800add5be338..eab10fc6da5c 100644
@@ -4,8 +4,6 @@
 3Com Vortex device driver
 =========================
 
-Documentation/networking/device_drivers/3com/vortex.rst
-
 Andrew Morton
 
 30 April 2000
Documentation/networking/device_drivers/ethernet/amazon/ena.rst renamed from Documentation/networking/device_drivers/amazon/ena.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/amazon/ena.rst
rename to Documentation/networking/device_drivers/ethernet/amazon/ena.rst
Documentation/networking/device_drivers/ethernet/aquantia/atlantic.rst renamed from Documentation/networking/device_drivers/aquantia/atlantic.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/aquantia/atlantic.rst
rename to Documentation/networking/device_drivers/ethernet/aquantia/atlantic.rst
Documentation/networking/device_drivers/ethernet/chelsio/cxgb.rst renamed from Documentation/networking/device_drivers/chelsio/cxgb.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/chelsio/cxgb.rst
rename to Documentation/networking/device_drivers/ethernet/chelsio/cxgb.rst
Documentation/networking/device_drivers/ethernet/cirrus/cs89x0.rst renamed from Documentation/networking/device_drivers/cirrus/cs89x0.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/cirrus/cs89x0.rst
rename to Documentation/networking/device_drivers/ethernet/cirrus/cs89x0.rst
Documentation/networking/device_drivers/ethernet/davicom/dm9000.rst renamed from Documentation/networking/device_drivers/davicom/dm9000.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/davicom/dm9000.rst
rename to Documentation/networking/device_drivers/ethernet/davicom/dm9000.rst
Documentation/networking/device_drivers/ethernet/dec/de4x5.rst renamed from Documentation/networking/device_drivers/dec/de4x5.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/dec/de4x5.rst
rename to Documentation/networking/device_drivers/ethernet/dec/de4x5.rst
Documentation/networking/device_drivers/ethernet/dec/dmfe.rst renamed from Documentation/networking/device_drivers/dec/dmfe.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/dec/dmfe.rst
rename to Documentation/networking/device_drivers/ethernet/dec/dmfe.rst
Documentation/networking/device_drivers/ethernet/dlink/dl2k.rst renamed from Documentation/networking/device_drivers/dlink/dl2k.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/dlink/dl2k.rst
rename to Documentation/networking/device_drivers/ethernet/dlink/dl2k.rst
Documentation/networking/device_drivers/ethernet/freescale/dpaa.rst renamed from Documentation/networking/device_drivers/freescale/dpaa.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/freescale/dpaa.rst
rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa.rst
Documentation/networking/device_drivers/ethernet/freescale/dpaa2/dpio-driver.rst renamed from Documentation/networking/device_drivers/freescale/dpaa2/dpio-driver.rst +4 -2
similarity index 97%
rename from Documentation/networking/device_drivers/freescale/dpaa2/dpio-driver.rst
rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa2/dpio-driver.rst
index 17dbee1ac53e..c50fd46631e0 100644
@@ -19,8 +19,10 @@ pool management for network interfaces.
 This document provides an overview the Linux DPIO driver, its
 subcomponents, and its APIs.
 
-See Documentation/networking/device_drivers/freescale/dpaa2/overview.rst for
-a general overview of DPAA2 and the general DPAA2 driver architecture in Linux.
+See
+Documentation/networking/device_drivers/ethernet/freescale/dpaa2/overview.rst
+for a general overview of DPAA2 and the general DPAA2 driver architecture
+in Linux.
 
 Driver Overview
 ---------------
Documentation/networking/device_drivers/ethernet/freescale/dpaa2/ethernet-driver.rst renamed from Documentation/networking/device_drivers/freescale/dpaa2/ethernet-driver.rst +2 -1
similarity index 98%
rename from Documentation/networking/device_drivers/freescale/dpaa2/ethernet-driver.rst
rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa2/ethernet-driver.rst
index cb4c9a0c5a17..682f3986c15b 100644
@@ -33,7 +33,8 @@ hardware resources, like queues, do not have a corresponding MC object and
 are treated as internal resources of other objects.
 
 For a more detailed description of the DPAA2 architecture and its object
-abstractions see *Documentation/networking/device_drivers/freescale/dpaa2/overview.rst*.
+abstractions see
+*Documentation/networking/device_drivers/ethernet/freescale/dpaa2/overview.rst*.
 
 Each Linux net device is built on top of a Datapath Network Interface (DPNI)
 object and uses Buffer Pools (DPBPs), I/O Portals (DPIOs) and Concentrators
Documentation/networking/device_drivers/ethernet/freescale/dpaa2/index.rst renamed from Documentation/networking/device_drivers/freescale/dpaa2/index.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/freescale/dpaa2/index.rst
rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa2/index.rst
Documentation/networking/device_drivers/ethernet/freescale/dpaa2/mac-phy-support.rst renamed from Documentation/networking/device_drivers/freescale/dpaa2/mac-phy-support.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/freescale/dpaa2/mac-phy-support.rst
rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa2/mac-phy-support.rst
Documentation/networking/device_drivers/ethernet/freescale/dpaa2/overview.rst renamed from Documentation/networking/device_drivers/freescale/dpaa2/overview.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/freescale/dpaa2/overview.rst
rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa2/overview.rst
Documentation/networking/device_drivers/ethernet/freescale/gianfar.rst renamed from Documentation/networking/device_drivers/freescale/gianfar.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/freescale/gianfar.rst
rename to Documentation/networking/device_drivers/ethernet/freescale/gianfar.rst
Documentation/networking/device_drivers/ethernet/google/gve.rst renamed from Documentation/networking/device_drivers/google/gve.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/google/gve.rst
rename to Documentation/networking/device_drivers/ethernet/google/gve.rst
Documentation/networking/device_drivers/ethernet/index.rst new file +58 -0

58 lines not on this page · raw message

Documentation/networking/device_drivers/ethernet/intel/e100.rst renamed from Documentation/networking/device_drivers/intel/e100.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/e100.rst
rename to Documentation/networking/device_drivers/ethernet/intel/e100.rst
Documentation/networking/device_drivers/ethernet/intel/e1000.rst renamed from Documentation/networking/device_drivers/intel/e1000.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/e1000.rst
rename to Documentation/networking/device_drivers/ethernet/intel/e1000.rst
Documentation/networking/device_drivers/ethernet/intel/e1000e.rst renamed from Documentation/networking/device_drivers/intel/e1000e.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/e1000e.rst
rename to Documentation/networking/device_drivers/ethernet/intel/e1000e.rst
Documentation/networking/device_drivers/ethernet/intel/fm10k.rst renamed from Documentation/networking/device_drivers/intel/fm10k.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/fm10k.rst
rename to Documentation/networking/device_drivers/ethernet/intel/fm10k.rst
Documentation/networking/device_drivers/ethernet/intel/i40e.rst renamed from Documentation/networking/device_drivers/intel/i40e.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/i40e.rst
rename to Documentation/networking/device_drivers/ethernet/intel/i40e.rst
Documentation/networking/device_drivers/ethernet/intel/iavf.rst renamed from Documentation/networking/device_drivers/intel/iavf.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/iavf.rst
rename to Documentation/networking/device_drivers/ethernet/intel/iavf.rst
Documentation/networking/device_drivers/ethernet/intel/ice.rst renamed from Documentation/networking/device_drivers/intel/ice.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ice.rst
rename to Documentation/networking/device_drivers/ethernet/intel/ice.rst
Documentation/networking/device_drivers/ethernet/intel/igb.rst renamed from Documentation/networking/device_drivers/intel/igb.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/igb.rst
rename to Documentation/networking/device_drivers/ethernet/intel/igb.rst
Documentation/networking/device_drivers/ethernet/intel/igbvf.rst renamed from Documentation/networking/device_drivers/intel/igbvf.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/igbvf.rst
rename to Documentation/networking/device_drivers/ethernet/intel/igbvf.rst
Documentation/networking/device_drivers/ethernet/intel/ixgb.rst renamed from Documentation/networking/device_drivers/intel/ixgb.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ixgb.rst
rename to Documentation/networking/device_drivers/ethernet/intel/ixgb.rst
Documentation/networking/device_drivers/ethernet/intel/ixgbe.rst renamed from Documentation/networking/device_drivers/intel/ixgbe.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ixgbe.rst
rename to Documentation/networking/device_drivers/ethernet/intel/ixgbe.rst
Documentation/networking/device_drivers/ethernet/intel/ixgbevf.rst renamed from Documentation/networking/device_drivers/intel/ixgbevf.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ixgbevf.rst
rename to Documentation/networking/device_drivers/ethernet/intel/ixgbevf.rst
Documentation/networking/device_drivers/ethernet/marvell/octeontx2.rst renamed from Documentation/networking/device_drivers/marvell/octeontx2.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/marvell/octeontx2.rst
rename to Documentation/networking/device_drivers/ethernet/marvell/octeontx2.rst
Documentation/networking/device_drivers/ethernet/mellanox/mlx5.rst renamed from Documentation/networking/device_drivers/mellanox/mlx5.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/mellanox/mlx5.rst
rename to Documentation/networking/device_drivers/ethernet/mellanox/mlx5.rst
Documentation/networking/device_drivers/ethernet/microsoft/netvsc.rst renamed from Documentation/networking/device_drivers/microsoft/netvsc.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/microsoft/netvsc.rst
rename to Documentation/networking/device_drivers/ethernet/microsoft/netvsc.rst
Documentation/networking/device_drivers/ethernet/neterion/s2io.rst renamed from Documentation/networking/device_drivers/neterion/s2io.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/neterion/s2io.rst
rename to Documentation/networking/device_drivers/ethernet/neterion/s2io.rst
Documentation/networking/device_drivers/ethernet/neterion/vxge.rst renamed from Documentation/networking/device_drivers/neterion/vxge.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/neterion/vxge.rst
rename to Documentation/networking/device_drivers/ethernet/neterion/vxge.rst
Documentation/networking/device_drivers/ethernet/netronome/nfp.rst renamed from Documentation/networking/device_drivers/netronome/nfp.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/netronome/nfp.rst
rename to Documentation/networking/device_drivers/ethernet/netronome/nfp.rst
Documentation/networking/device_drivers/ethernet/pensando/ionic.rst renamed from Documentation/networking/device_drivers/pensando/ionic.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/pensando/ionic.rst
rename to Documentation/networking/device_drivers/ethernet/pensando/ionic.rst
Documentation/networking/device_drivers/ethernet/smsc/smc9.rst renamed from Documentation/networking/device_drivers/smsc/smc9.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/smsc/smc9.rst
rename to Documentation/networking/device_drivers/ethernet/smsc/smc9.rst
Documentation/networking/device_drivers/ethernet/stmicro/stmmac.rst renamed from Documentation/networking/device_drivers/stmicro/stmmac.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/stmicro/stmmac.rst
rename to Documentation/networking/device_drivers/ethernet/stmicro/stmmac.rst
Documentation/networking/device_drivers/ethernet/ti/cpsw.rst renamed from Documentation/networking/device_drivers/ti/cpsw.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/ti/cpsw.rst
rename to Documentation/networking/device_drivers/ethernet/ti/cpsw.rst
Documentation/networking/device_drivers/ethernet/ti/cpsw_switchdev.rst renamed from Documentation/networking/device_drivers/ti/cpsw_switchdev.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/ti/cpsw_switchdev.rst
rename to Documentation/networking/device_drivers/ethernet/ti/cpsw_switchdev.rst
Documentation/networking/device_drivers/ethernet/ti/tlan.rst renamed from Documentation/networking/device_drivers/ti/tlan.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/ti/tlan.rst
rename to Documentation/networking/device_drivers/ethernet/ti/tlan.rst
Documentation/networking/device_drivers/ethernet/toshiba/spider_net.rst renamed from Documentation/networking/device_drivers/toshiba/spider_net.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/toshiba/spider_net.rst
rename to Documentation/networking/device_drivers/ethernet/toshiba/spider_net.rst
Documentation/networking/device_drivers/index.rst +6 -45

62 lines not on this page · raw message

Documentation/networking/device_drivers/wifi/index.rst new file +19 -0
new file mode 100644
index 000000000000..fb394f5de4a9
@@ -0,0 +1,19 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+Wi-Fi Device Drivers
+====================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   intel/ipw2100
+   intel/ipw2200
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/wifi/intel/ipw2100.rst renamed from Documentation/networking/device_drivers/intel/ipw2100.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ipw2100.rst
rename to Documentation/networking/device_drivers/wifi/intel/ipw2100.rst
Documentation/networking/device_drivers/wifi/intel/ipw2200.rst renamed from Documentation/networking/device_drivers/intel/ipw2200.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ipw2200.rst
rename to Documentation/networking/device_drivers/wifi/intel/ipw2200.rst
MAINTAINERS +33 -33

180 lines not on this page · raw message

drivers/net/Kconfig +1 -1
index c7d310ef1c83..962dcd044f1b 100644
@@ -460,7 +460,7 @@ config NET_SB1000
 
 	  At present this driver only compiles as a module, so say M here if
 	  you have this card. The module will be called sb1000. Then read
-	  <file:Documentation/networking/device_drivers/sb1000.rst> for
+	  <file:Documentation/networking/device_drivers/cable/sb1000.rst> for
 	  information on how to use this module, as it needs special ppp
 	  scripts for establishing a connection. Further documentation
 	  and the necessary scripts can be found at:
drivers/net/ethernet/3com/3c59x.c +2 -2
index 5984b7033999..741c67e546d4 100644
@@ -1149,7 +1149,7 @@ static int vortex_probe1(struct device *gendev, void __iomem *ioaddr, int irq,
 
 	print_info = (vortex_debug > 1);
 	if (print_info)
-		pr_info("See Documentation/networking/device_drivers/3com/vortex.rst\n");
+		pr_info("See Documentation/networking/device_drivers/ethernet/3com/vortex.rst\n");
 
 	pr_info("%s: 3Com %s %s at %p.\n",
 	       print_name,
@@ -1954,7 +1954,7 @@ vortex_error(struct net_device *dev, int status)
 				   dev->name, tx_status);
 			if (tx_status == 0x82) {
 				pr_err("Probably a duplex mismatch.  See "
-						"Documentation/networking/device_drivers/3com/vortex.rst\n");
+						"Documentation/networking/device_drivers/ethernet/3com/vortex.rst\n");
 			}
 			dump_tx_ring(dev);
 		}
drivers/net/ethernet/3com/Kconfig +2 -2
index 7cc259893cb9..c5958c515d06 100644
@@ -76,8 +76,8 @@ config VORTEX
 	  "Hurricane" (3c555/3cSOHO)                           PCI
 
 	  If you have such a card, say Y here.  More specific information is in
-	  <file:Documentation/networking/device_drivers/3com/vortex.rst> and
-	  in the comments at the beginning of
+	  <file:Documentation/networking/device_drivers/ethernet/3com/vortex.rst>
+	  and in the comments at the beginning of
 	  <file:drivers/net/ethernet/3com/3c59x.c>.
 
 	  To compile this support as a module, choose M here.
drivers/net/ethernet/chelsio/Kconfig +1 -1
index 82cdfa51ce37..238246924e0d 100644
@@ -26,7 +26,7 @@ config CHELSIO_T1
 	  This driver supports Chelsio gigabit and 10-gigabit
 	  Ethernet cards. More information about adapter features and
 	  performance tuning is in
-	  <file:Documentation/networking/device_drivers/chelsio/cxgb.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/chelsio/cxgb.rst>.
 
 	  For general information about Chelsio and our products, visit
 	  our website at <http://www.chelsio.com>.
drivers/net/ethernet/cirrus/Kconfig +1 -1
index 8d845f5ee0c5..a0280d26d4cd 100644
@@ -24,7 +24,7 @@ config CS89x0
 	---help---
 	  Support for CS89x0 chipset based Ethernet cards. If you have a
 	  network (Ethernet) card of this type, say Y and read the file
-	  <file:Documentation/networking/device_drivers/cirrus/cs89x0.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/cirrus/cs89x0.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called cs89x0.
drivers/net/ethernet/dec/tulip/Kconfig +2 -2
index 177f36f4b89d..5185cbe11b17 100644
@@ -114,7 +114,7 @@ config DE4X5
 	  These include the DE425, DE434, DE435, DE450 and DE500 models.  If
 	  you have a network card of this type, say Y.  More specific
 	  information is contained in
-	  <file:Documentation/networking/device_drivers/dec/de4x5.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/dec/de4x5.rst>.
 
 	  To compile this driver as a module, choose M here. The module will
 	  be called de4x5.
@@ -138,7 +138,7 @@ config DM9102
 	  This driver is for DM9102(A)/DM9132/DM9801 compatible PCI cards from
 	  Davicom (<http://www.davicom.com.tw/>).  If you have such a network
 	  (Ethernet) card, say Y.  Some information is contained in the file
-	  <file:Documentation/networking/device_drivers/dec/dmfe.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/dec/dmfe.rst>.
 
 	  To compile this driver as a module, choose M here. The module will
 	  be called dmfe.
drivers/net/ethernet/dlink/dl2k.c +1 -9
index 5143722c4419..be6d8a9ada27 100644
@@ -1863,13 +1863,5 @@ static struct pci_driver rio_driver = {
 };
 
 module_pci_driver(rio_driver);
-/*
-
-Compile command:
-
-gcc -D__KERNEL__ -DMODULE -I/usr/src/linux/include -Wall -Wstrict-prototypes -O2 -c dl2k.c
-
-Read Documentation/networking/device_drivers/dlink/dl2k.rst for details.
-
-*/
 
+/* Read Documentation/networking/device_drivers/ethernet/dlink/dl2k.rst. */
drivers/net/ethernet/intel/Kconfig +12 -12
index ad34e4335df2..a6cdd652489d 100644
@@ -34,7 +34,7 @@ config E100
 	  to identify the adapter.
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/e100.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/e100.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called e100.
@@ -50,7 +50,7 @@ config E1000
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/e1000.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/e1000.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called e1000.
@@ -70,7 +70,7 @@ config E1000E
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/e1000e.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/e1000e.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called e1000e.
@@ -98,7 +98,7 @@ config IGB
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/igb.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/igb.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called igb.
@@ -134,7 +134,7 @@ config IGBVF
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/igbvf.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/igbvf.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called igbvf.
@@ -151,7 +151,7 @@ config IXGB
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/ixgb.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/ixgb.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called ixgb.
@@ -170,7 +170,7 @@ config IXGBE
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/ixgbe.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/ixgbe.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called ixgbe.
@@ -222,7 +222,7 @@ config IXGBEVF
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/ixgbevf.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/ixgbevf.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called ixgbevf.  MSI-X interrupt support is required
@@ -249,7 +249,7 @@ config I40E
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/i40e.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/i40e.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called i40e.
@@ -284,7 +284,7 @@ config I40EVF
 	  This driver was formerly named i40evf.
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/iavf.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/iavf.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called iavf.  MSI-X interrupt support is required
@@ -303,7 +303,7 @@ config ICE
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/ice.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/ice.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called ice.
@@ -321,7 +321,7 @@ config FM10K
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/fm10k.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/fm10k.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called fm10k.  MSI-X interrupt support is required
drivers/net/ethernet/neterion/Kconfig +2 -2
index a82a37094579..d5760e7ba262 100644
@@ -27,7 +27,7 @@ config S2IO
 	  on its age.
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/neterion/s2io.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/neterion/s2io.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called s2io.
@@ -42,7 +42,7 @@ config VXGE
 	  labeled as either one, depending on its age.
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/neterion/vxge.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/neterion/vxge.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called vxge.
drivers/net/ethernet/pensando/Kconfig +1 -1
index d25b88f53de4..76f8cc502bf9 100644
@@ -25,7 +25,7 @@ config IONIC
 	  This enables the support for the Pensando family of Ethernet
 	  adapters.  More specific information on this driver can be
 	  found in
-	  <file:Documentation/networking/device_drivers/pensando/ionic.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/pensando/ionic.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called ionic.
drivers/net/ethernet/smsc/Kconfig +2 -2
index 4d2d91ec8b41..599bc68f0290 100644
@@ -28,7 +28,7 @@ config SMC9194
 	  option if you have a DELL laptop with the docking station, or
 	  another SMC9192/9194 based chipset.  Say Y if you want it compiled
 	  into the kernel, and read the file
-	  <file:Documentation/networking/device_drivers/smsc/smc9.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/smsc/smc9.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called smc9194.
@@ -44,7 +44,7 @@ config SMC91X
 	  This is a driver for SMC's 91x series of Ethernet chipsets,
 	  including the SMC91C94 and the SMC91C111. Say Y if you want it
 	  compiled into the kernel, and read the file
-	  <file:Documentation/networking/device_drivers/smsc/smc9.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/smsc/smc9.rst>.
 
 	  This driver is also available as a module ( = code which can be
 	  inserted in and removed from the running kernel whenever you want).
drivers/net/ethernet/ti/Kconfig +1 -1
index 182d10f171f6..308fee33fe7f 100644
@@ -156,7 +156,7 @@ config TLAN
 
 	  Devices currently supported by this driver are Compaq Netelligent,
 	  Compaq NetFlex and Olicom cards.  Please read the file
-	  <file:Documentation/networking/device_drivers/ti/tlan.rst>
+	  <file:Documentation/networking/device_drivers/ethernet/ti/tlan.rst>
 	  for more details.
 
 	  To compile this driver as a module, choose M here. The module
drivers/net/ethernet/ti/tlan.c +1 -1
index 857709828058..583cd2ef7662 100644
@@ -70,7 +70,7 @@ MODULE_DESCRIPTION("Driver for TI ThunderLAN based ethernet PCI adapters");
 MODULE_LICENSE("GPL");
 
 /* Turn on debugging.
- * See Documentation/networking/device_drivers/ti/tlan.rst for details
+ * See Documentation/networking/device_drivers/ethernet/ti/tlan.rst for details
  */
 static  int		debug;
 module_param(debug, int, 0);
drivers/net/wireless/intel/ipw2x00/Kconfig +2 -2
index f42b3cdce611..77603d585051 100644
@@ -16,7 +16,7 @@ config IPW2100
 	  A driver for the Intel PRO/Wireless 2100 Network
 	  Connection 802.11b wireless network adapter.
 
-	  See <file:Documentation/networking/device_drivers/intel/ipw2100.rst>
+	  See <file:Documentation/networking/device_drivers/wifi/intel/ipw2100.rst>
 	  for information on the capabilities currently enabled in this driver
 	  and for tips for debugging issues and problems.
 
@@ -78,7 +78,7 @@ config IPW2200
 	  A driver for the Intel PRO/Wireless 2200BG and 2915ABG Network
 	  Connection adapters.
 
-	  See <file:Documentation/networking/device_drivers/intel/ipw2200.rst>
+	  See <file:Documentation/networking/device_drivers/wifi/intel/ipw2200.rst>
 	  for information on the capabilities currently enabled in this
 	  driver and for tips for debugging issues and problems.
 
drivers/net/wireless/intel/ipw2x00/ipw2100.c +1 -1
index 624fe721e2b5..753dada5a243 100644
@@ -8352,7 +8352,7 @@ static int ipw2100_mod_firmware_load(struct ipw2100_fw *fw)
 	if (IPW2100_FW_MAJOR(h->version) != IPW2100_FW_MAJOR_VERSION) {
 		printk(KERN_WARNING DRV_NAME ": Firmware image not compatible "
 		       "(detected version id of %u). "
-		       "See Documentation/networking/device_drivers/intel/ipw2100.rst\n",
+		       "See Documentation/networking/device_drivers/wifi/intel/ipw2100.rst\n",
 		       h->version);
 		return 1;
 	}
Signature · 1 line
2.26.2
#2 lore raw

RE: [RFC 1/8] docs: networking: reorganize driver documentation again

Quoted 854 lines

-----Original Message-----
From: Jakub Kicinski <[email protected]>
Sent: Thursday, June 11, 2020 10:30
To: [email protected]
Cc: [email protected]; [email protected]; Jakub Kicinski <[email protected]>; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; GR-Linux- [email protected]; [email protected]; Kirsher, Jeffrey T <[email protected]>; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]
Subject: [RFC 1/8] docs: networking: reorganize driver documentation again

Organize driver documentation by device type. Most documents have fairly verbose yet uninformative names, so let users first select a well defined device type, and then search for a particular driver.

While at it rename the section from Vendor drivers to Hardware drivers. This seems more accurate, besides people sometimes refer to out-of-tree drivers as vendor drivers.

--
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]

---
 .../devicetree/bindings/misc/fsl,qoriq-mc.txt |  2 +-
 .../networking/device_drivers/cable/index.rst | 18 +++++
 .../device_drivers/{ => cable}/sb1000.rst     |  0
 .../device_drivers/cellular/index.rst         | 18 +++++
 .../{ => cellular}/qualcomm/rmnet.rst         |  0
 .../{ => ethernet}/3com/3c509.rst             |  0
 .../{ => ethernet}/3com/vortex.rst            |  2 -
 .../{ => ethernet}/amazon/ena.rst             |  0
 .../{ => ethernet}/aquantia/atlantic.rst      |  0
 .../{ => ethernet}/chelsio/cxgb.rst           |  0
 .../{ => ethernet}/cirrus/cs89x0.rst          |  0
 .../{ => ethernet}/davicom/dm9000.rst         |  0
 .../{ => ethernet}/dec/de4x5.rst              |  0
 .../{ => ethernet}/dec/dmfe.rst               |  0
 .../{ => ethernet}/dlink/dl2k.rst             |  0
 .../{ => ethernet}/freescale/dpaa.rst         |  0
 .../freescale/dpaa2/dpio-driver.rst           |  6 +-
 .../freescale/dpaa2/ethernet-driver.rst       |  3 +-
 .../{ => ethernet}/freescale/dpaa2/index.rst  |  0
 .../freescale/dpaa2/mac-phy-support.rst       |  0
 .../freescale/dpaa2/overview.rst              |  0
 .../{ => ethernet}/freescale/gianfar.rst      |  0
 .../{ => ethernet}/google/gve.rst             |  0
 .../device_drivers/ethernet/index.rst         | 58 ++++++++++++++++
 .../{ => ethernet}/intel/e100.rst             |  0
 .../{ => ethernet}/intel/e1000.rst            |  0
 .../{ => ethernet}/intel/e1000e.rst           |  0
 .../{ => ethernet}/intel/fm10k.rst            |  0
 .../{ => ethernet}/intel/i40e.rst             |  0
 .../{ => ethernet}/intel/iavf.rst             |  0
 .../{ => ethernet}/intel/ice.rst              |  0
 .../{ => ethernet}/intel/igb.rst              |  0
 .../{ => ethernet}/intel/igbvf.rst            |  0
 .../{ => ethernet}/intel/ixgb.rst             |  0
 .../{ => ethernet}/intel/ixgbe.rst            |  0
 .../{ => ethernet}/intel/ixgbevf.rst          |  0
 .../{ => ethernet}/marvell/octeontx2.rst      |  0
 .../{ => ethernet}/mellanox/mlx5.rst          |  0
 .../{ => ethernet}/microsoft/netvsc.rst       |  0
 .../{ => ethernet}/neterion/s2io.rst          |  0
 .../{ => ethernet}/neterion/vxge.rst          |  0
 .../{ => ethernet}/netronome/nfp.rst          |  0
 .../{ => ethernet}/pensando/ionic.rst         |  0
 .../{ => ethernet}/smsc/smc9.rst              |  0
 .../{ => ethernet}/stmicro/stmmac.rst         |  0
 .../device_drivers/{ => ethernet}/ti/cpsw.rst |  0
 .../{ => ethernet}/ti/cpsw_switchdev.rst      |  0
 .../device_drivers/{ => ethernet}/ti/tlan.rst |  0
 .../{ => ethernet}/toshiba/spider_net.rst     |  0
 .../networking/device_drivers/index.rst       | 51 ++------------
 .../networking/device_drivers/wifi/index.rst  | 19 ++++++
 .../{ => wifi}/intel/ipw2100.rst              |  0
 .../{ => wifi}/intel/ipw2200.rst              |  0
 MAINTAINERS                                   | 66 +++++++++----------
 drivers/net/Kconfig                           |  2 +-
 drivers/net/ethernet/3com/3c59x.c             |  4 +-
 drivers/net/ethernet/3com/Kconfig             |  4 +-
 drivers/net/ethernet/chelsio/Kconfig          |  2 +-
 drivers/net/ethernet/cirrus/Kconfig           |  2 +-
 drivers/net/ethernet/dec/tulip/Kconfig        |  4 +-
 drivers/net/ethernet/dlink/dl2k.c             | 10 +--
 drivers/net/ethernet/intel/Kconfig            | 24 +++----
 drivers/net/ethernet/neterion/Kconfig         |  4 +-
 drivers/net/ethernet/pensando/Kconfig         |  2 +-
 drivers/net/ethernet/smsc/Kconfig             |  4 +-
 drivers/net/ethernet/ti/Kconfig               |  2 +-
 drivers/net/ethernet/ti/tlan.c                |  2 +-
 drivers/net/wireless/intel/ipw2x00/Kconfig    |  4 +-
 drivers/net/wireless/intel/ipw2x00/ipw2100.c  |  2 +-
 69 files changed, 191 insertions(+), 124 deletions(-)
 create mode 100644 Documentation/networking/device_drivers/cable/index.rst
 rename Documentation/networking/device_drivers/{ => cable}/sb1000.rst
(100%)
 create mode 100644
Documentation/networking/device_drivers/cellular/index.rst
 rename Documentation/networking/device_drivers/{ =>
cellular}/qualcomm/rmnet.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/3com/3c509.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/3com/vortex.rst (99%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/amazon/ena.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/aquantia/atlantic.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/chelsio/cxgb.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/cirrus/cs89x0.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/davicom/dm9000.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/dec/de4x5.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/dec/dmfe.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/dlink/dl2k.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/freescale/dpaa.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/freescale/dpaa2/dpio-driver.rst (97%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/freescale/dpaa2/ethernet-driver.rst (98%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/freescale/dpaa2/index.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/freescale/dpaa2/mac-phy-support.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/freescale/dpaa2/overview.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/freescale/gianfar.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/google/gve.rst (100%)
 create mode 100644
Documentation/networking/device_drivers/ethernet/index.rst
 rename Documentation/networking/device_drivers/{ =>
ethernet}/intel/e100.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/intel/e1000.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/intel/e1000e.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/intel/fm10k.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/i40e.rst
(100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/iavf.rst
(100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/ice.rst
(100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/igb.rst
(100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/intel/igbvf.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/intel/ixgb.rst
(100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/intel/ixgbe.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/intel/ixgbevf.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/marvell/octeontx2.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/mellanox/mlx5.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/microsoft/netvsc.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/neterion/s2io.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/neterion/vxge.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/netronome/nfp.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/pensando/ionic.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/smsc/smc9.rst (100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/stmicro/stmmac.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/ti/cpsw.rst
(100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/ti/cpsw_switchdev.rst (100%)
 rename Documentation/networking/device_drivers/{ => ethernet}/ti/tlan.rst
(100%)
 rename Documentation/networking/device_drivers/{ =>
ethernet}/toshiba/spider_net.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/wifi/index.rst
 rename Documentation/networking/device_drivers/{ => wifi}/intel/ipw2100.rst
(100%)
 rename Documentation/networking/device_drivers/{ => wifi}/intel/ipw2200.rst

(100%)

Documentation/devicetree/bindings/misc/fsl,qoriq-mc.txt +1 -1
index 9134e9bcca56..b12f9be1251f 100644
@@ -10,7 +10,7 @@ such as network interfaces, crypto accelerator instances,
 L2 switches,
 etc.
 
 For an overview of the DPAA2 architecture and fsl-mc bus see:
-Documentation/networking/device_drivers/freescale/dpaa2/overview.rst
+Documentation/networking/device_drivers/ethernet/freescale/dpaa2/overview.

rst

As described in the above overview, all DPAA2 objects in a DPRC share the same hardware "isolation context" and a 10-bit value called an ICID

Documentation/networking/device_drivers/cable/index.rst new file +18 -0
new file mode 100644
index 000000000000..cce3c4392972
@@ -0,0 +1,18 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+Cable Modem Device Drivers
+==========================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   sb1000
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/cable/sb1000.rst renamed from Documentation/networking/device_drivers/sb1000.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/sb1000.rst
rename to Documentation/networking/device_drivers/cable/sb1000.rst
Documentation/networking/device_drivers/cellular/index.rst new file +18 -0
new file mode 100644
index 000000000000..fc1812d3fc70
@@ -0,0 +1,18 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+Cellular Modem Device Drivers
+=============================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   qualcomm/rmnet
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/cellular/qualcomm/rmnet.rst renamed from Documentation/networking/device_drivers/qualcomm/rmnet.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/qualcomm/rmnet.rst

rename to Documentation/networking/device_drivers/cellular/qualcomm/rmnet.rst

Documentation/networking/device_drivers/ethernet/3com/3c509.rst renamed from Documentation/networking/device_drivers/3com/3c509.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/3com/3c509.rst
rename to Documentation/networking/device_drivers/ethernet/3com/3c509.rst
Documentation/networking/device_drivers/ethernet/3com/vortex.rst renamed from Documentation/networking/device_drivers/3com/vortex.rst +0 -2
similarity index 99%
rename from Documentation/networking/device_drivers/3com/vortex.rst
rename to Documentation/networking/device_drivers/ethernet/3com/vortex.rst
index 800add5be338..eab10fc6da5c 100644
@@ -4,8 +4,6 @@
 3Com Vortex device driver
 =========================
 
-Documentation/networking/device_drivers/3com/vortex.rst
-
 Andrew Morton
 
 30 April 2000
Documentation/networking/device_drivers/ethernet/amazon/ena.rst renamed from Documentation/networking/device_drivers/amazon/ena.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/amazon/ena.rst
rename to Documentation/networking/device_drivers/ethernet/amazon/ena.rst
Documentation/networking/device_drivers/ethernet/aquantia/atlantic.rst renamed from Documentation/networking/device_drivers/aquantia/atlantic.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/aquantia/atlantic.rst

rename to Documentation/networking/device_drivers/ethernet/aquantia/atlantic.rst

Documentation/networking/device_drivers/ethernet/chelsio/cxgb.rst renamed from Documentation/networking/device_drivers/chelsio/cxgb.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/chelsio/cxgb.rst
rename to Documentation/networking/device_drivers/ethernet/chelsio/cxgb.rst
Documentation/networking/device_drivers/ethernet/cirrus/cs89x0.rst renamed from Documentation/networking/device_drivers/cirrus/cs89x0.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/cirrus/cs89x0.rst
rename to Documentation/networking/device_drivers/ethernet/cirrus/cs89x0.rst
Documentation/networking/device_drivers/ethernet/davicom/dm9000.rst renamed from Documentation/networking/device_drivers/davicom/dm9000.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/davicom/dm9000.rst

rename to Documentation/networking/device_drivers/ethernet/davicom/dm9000.rst

Documentation/networking/device_drivers/ethernet/dec/de4x5.rst renamed from Documentation/networking/device_drivers/dec/de4x5.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/dec/de4x5.rst
rename to Documentation/networking/device_drivers/ethernet/dec/de4x5.rst
Documentation/networking/device_drivers/ethernet/dec/dmfe.rst renamed from Documentation/networking/device_drivers/dec/dmfe.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/dec/dmfe.rst
rename to Documentation/networking/device_drivers/ethernet/dec/dmfe.rst
Documentation/networking/device_drivers/ethernet/dlink/dl2k.rst renamed from Documentation/networking/device_drivers/dlink/dl2k.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/dlink/dl2k.rst
rename to Documentation/networking/device_drivers/ethernet/dlink/dl2k.rst
Documentation/networking/device_drivers/ethernet/freescale/dpaa.rst renamed from Documentation/networking/device_drivers/freescale/dpaa.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/freescale/dpaa.rst

rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa.rst

(quoted diff) +0 -0

driver.rst b/Documentation/networking/device_drivers/ethernet/freescale/dpaa2/dpio- driver.rst
similarity index 97%
rename from Documentation/networking/device_drivers/freescale/dpaa2/dpio- driver.rst
rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa2/dpio- driver.rst
index 17dbee1ac53e..c50fd46631e0 100644
--- a/Documentation/networking/device_drivers/freescale/dpaa2/dpio-driver.rst
+++
b/Documentation/networking/device_drivers/ethernet/freescale/dpaa2/dpio- driver.rst

Documentation/networking/device_drivers/ethernet/freescale/dpaa.rst renamed from Documentation/networking/device_drivers/freescale/dpaa.rst +0 -1
@@ -19,8 +19,10 @@ pool management for network interfaces.
 This document provides an overview the Linux DPIO driver, its
 subcomponents, and its APIs.
 
-See Documentation/networking/device_drivers/freescale/dpaa2/overview.rst

for
-a general overview of DPAA2 and the general DPAA2 driver architecture in Linux.

Documentation/networking/device_drivers/ethernet/freescale/dpaa.rst renamed from Documentation/networking/device_drivers/freescale/dpaa.rst +2 -0
+See
+Documentation/networking/device_drivers/ethernet/freescale/dpaa2/overview.

rst

Documentation/networking/device_drivers/ethernet/freescale/dpaa.rst renamed from Documentation/networking/device_drivers/freescale/dpaa.rst +2 -0
+for a general overview of DPAA2 and the general DPAA2 driver architecture
+in Linux.
 
 Driver Overview
 ---------------
(quoted diff) +0 -0

driver.rst b/Documentation/networking/device_drivers/ethernet/freescale/dpaa2/ethernet- driver.rst
similarity index 98%
rename from Documentation/networking/device_drivers/freescale/dpaa2/ethernet-driver.rst rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa2/ethernet- driver.rst
index cb4c9a0c5a17..682f3986c15b 100644
--- a/Documentation/networking/device_drivers/freescale/dpaa2/ethernet- driver.rst
+++
b/Documentation/networking/device_drivers/ethernet/freescale/dpaa2/ethernet- driver.rst

(quoted diff) +0 -0
@@ -33,7 +33,8 @@ hardware resources, like queues, do not have a

corresponding MC object and
are treated as internal resources of other objects.

For a more detailed description of the DPAA2 architecture and its object
-abstractions see *Documentation/networking/device_drivers/freescale/dpaa2/overview.rst*.

(quoted diff) +2 -0
+abstractions see
+*Documentation/networking/device_drivers/ethernet/freescale/dpaa2/overvie

w.rst*.

Each Linux net device is built on top of a Datapath Network Interface (DPNI) object and uses Buffer Pools (DPBPs), I/O Portals (DPIOs) and Concentrators

Documentation/networking/device_drivers/ethernet/freescale/dpaa2/index.rst renamed from Documentation/networking/device_drivers/freescale/dpaa2/index.rst +0 -0
similarity index 100%

rename from Documentation/networking/device_drivers/freescale/dpaa2/index.rst rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa2/index.rst

(quoted diff) +0 -0

support.rst b/Documentation/networking/device_drivers/ethernet/freescale/dpaa2/mac-phy- support.rst
similarity index 100%
rename from Documentation/networking/device_drivers/freescale/dpaa2/mac- phy-support.rst
rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa2/mac-phy- support.rst
diff --git a/Documentation/networking/device_drivers/freescale/dpaa2/overview.rst b/Documentation/networking/device_drivers/ethernet/freescale/dpaa2/overview .rst
similarity index 100%
rename from Documentation/networking/device_drivers/freescale/dpaa2/overview.rst rename to Documentation/networking/device_drivers/ethernet/freescale/dpaa2/overview.rs t

Documentation/networking/device_drivers/ethernet/freescale/gianfar.rst renamed from Documentation/networking/device_drivers/freescale/gianfar.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/freescale/gianfar.rst

rename to Documentation/networking/device_drivers/ethernet/freescale/gianfar.rst

Documentation/networking/device_drivers/ethernet/google/gve.rst renamed from Documentation/networking/device_drivers/google/gve.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/google/gve.rst
rename to Documentation/networking/device_drivers/ethernet/google/gve.rst
Documentation/networking/device_drivers/ethernet/index.rst new file +58 -0
new file mode 100644
index 000000000000..fd3873024da8
@@ -0,0 +1,58 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+Ethernet Device Drivers
+=======================
+
+Device drivers for Ethernet and Ethernet-based virtual function devices.
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   3com/3c509
+   3com/vortex
+   amazon/ena
+   aquantia/atlantic
+   chelsio/cxgb
+   cirrus/cs89x0
+   dlink/dl2k
+   davicom/dm9000
+   dec/de4x5
+   dec/dmfe
+   freescale/dpaa
+   freescale/dpaa2/index
+   freescale/gianfar
+   google/gve
+   intel/e100
+   intel/e1000
+   intel/e1000e
+   intel/fm10k
+   intel/igb
+   intel/igbvf
+   intel/ixgb
+   intel/ixgbe
+   intel/ixgbevf
+   intel/i40e
+   intel/iavf
+   intel/ice
+   marvell/octeontx2
+   mellanox/mlx5
+   microsoft/netvsc
+   neterion/s2io
+   neterion/vxge
+   netronome/nfp
+   pensando/ionic
+   smsc/smc9
+   stmicro/stmmac
+   ti/cpsw
+   ti/cpsw_switchdev
+   ti/tlan
+   toshiba/spider_net
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/ethernet/intel/e100.rst renamed from Documentation/networking/device_drivers/intel/e100.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/e100.rst
rename to Documentation/networking/device_drivers/ethernet/intel/e100.rst
Documentation/networking/device_drivers/ethernet/intel/e1000.rst renamed from Documentation/networking/device_drivers/intel/e1000.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/e1000.rst
rename to Documentation/networking/device_drivers/ethernet/intel/e1000.rst
Documentation/networking/device_drivers/ethernet/intel/e1000e.rst renamed from Documentation/networking/device_drivers/intel/e1000e.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/e1000e.rst
rename to Documentation/networking/device_drivers/ethernet/intel/e1000e.rst
Documentation/networking/device_drivers/ethernet/intel/fm10k.rst renamed from Documentation/networking/device_drivers/intel/fm10k.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/fm10k.rst
rename to Documentation/networking/device_drivers/ethernet/intel/fm10k.rst
Documentation/networking/device_drivers/ethernet/intel/i40e.rst renamed from Documentation/networking/device_drivers/intel/i40e.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/i40e.rst
rename to Documentation/networking/device_drivers/ethernet/intel/i40e.rst
Documentation/networking/device_drivers/ethernet/intel/iavf.rst renamed from Documentation/networking/device_drivers/intel/iavf.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/iavf.rst
rename to Documentation/networking/device_drivers/ethernet/intel/iavf.rst
Documentation/networking/device_drivers/ethernet/intel/ice.rst renamed from Documentation/networking/device_drivers/intel/ice.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ice.rst
rename to Documentation/networking/device_drivers/ethernet/intel/ice.rst
Documentation/networking/device_drivers/ethernet/intel/igb.rst renamed from Documentation/networking/device_drivers/intel/igb.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/igb.rst
rename to Documentation/networking/device_drivers/ethernet/intel/igb.rst
Documentation/networking/device_drivers/ethernet/intel/igbvf.rst renamed from Documentation/networking/device_drivers/intel/igbvf.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/igbvf.rst
rename to Documentation/networking/device_drivers/ethernet/intel/igbvf.rst
Documentation/networking/device_drivers/ethernet/intel/ixgb.rst renamed from Documentation/networking/device_drivers/intel/ixgb.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ixgb.rst
rename to Documentation/networking/device_drivers/ethernet/intel/ixgb.rst
Documentation/networking/device_drivers/ethernet/intel/ixgbe.rst renamed from Documentation/networking/device_drivers/intel/ixgbe.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ixgbe.rst
rename to Documentation/networking/device_drivers/ethernet/intel/ixgbe.rst
Documentation/networking/device_drivers/ethernet/intel/ixgbevf.rst renamed from Documentation/networking/device_drivers/intel/ixgbevf.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ixgbevf.rst
rename to Documentation/networking/device_drivers/ethernet/intel/ixgbevf.rst
Documentation/networking/device_drivers/ethernet/marvell/octeontx2.rst renamed from Documentation/networking/device_drivers/marvell/octeontx2.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/marvell/octeontx2.rst

rename to Documentation/networking/device_drivers/ethernet/marvell/octeontx2.rst

Documentation/networking/device_drivers/ethernet/mellanox/mlx5.rst renamed from Documentation/networking/device_drivers/mellanox/mlx5.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/mellanox/mlx5.rst

rename to Documentation/networking/device_drivers/ethernet/mellanox/mlx5.rst

Documentation/networking/device_drivers/ethernet/microsoft/netvsc.rst renamed from Documentation/networking/device_drivers/microsoft/netvsc.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/microsoft/netvsc.rst

rename to Documentation/networking/device_drivers/ethernet/microsoft/netvsc.rst

Documentation/networking/device_drivers/ethernet/neterion/s2io.rst renamed from Documentation/networking/device_drivers/neterion/s2io.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/neterion/s2io.rst
rename to Documentation/networking/device_drivers/ethernet/neterion/s2io.rst
Documentation/networking/device_drivers/ethernet/neterion/vxge.rst renamed from Documentation/networking/device_drivers/neterion/vxge.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/neterion/vxge.rst
rename to Documentation/networking/device_drivers/ethernet/neterion/vxge.rst
Documentation/networking/device_drivers/ethernet/netronome/nfp.rst renamed from Documentation/networking/device_drivers/netronome/nfp.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/netronome/nfp.rst

rename to Documentation/networking/device_drivers/ethernet/netronome/nfp.rst

Documentation/networking/device_drivers/ethernet/pensando/ionic.rst renamed from Documentation/networking/device_drivers/pensando/ionic.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/pensando/ionic.rst

rename to Documentation/networking/device_drivers/ethernet/pensando/ionic.rst

Documentation/networking/device_drivers/ethernet/smsc/smc9.rst renamed from Documentation/networking/device_drivers/smsc/smc9.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/smsc/smc9.rst
rename to Documentation/networking/device_drivers/ethernet/smsc/smc9.rst
Documentation/networking/device_drivers/ethernet/stmicro/stmmac.rst renamed from Documentation/networking/device_drivers/stmicro/stmmac.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/stmicro/stmmac.rst

rename to Documentation/networking/device_drivers/ethernet/stmicro/stmmac.rst

Documentation/networking/device_drivers/ethernet/ti/cpsw.rst renamed from Documentation/networking/device_drivers/ti/cpsw.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/ti/cpsw.rst
rename to Documentation/networking/device_drivers/ethernet/ti/cpsw.rst
Documentation/networking/device_drivers/ethernet/ti/cpsw_switchdev.rst renamed from Documentation/networking/device_drivers/ti/cpsw_switchdev.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/ti/cpsw_switchdev.rst

rename to Documentation/networking/device_drivers/ethernet/ti/cpsw_switchdev.rst

Documentation/networking/device_drivers/ethernet/ti/tlan.rst renamed from Documentation/networking/device_drivers/ti/tlan.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/ti/tlan.rst
rename to Documentation/networking/device_drivers/ethernet/ti/tlan.rst
Documentation/networking/device_drivers/ethernet/toshiba/spider_net.rst renamed from Documentation/networking/device_drivers/toshiba/spider_net.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/toshiba/spider_net.rst

rename to Documentation/networking/device_drivers/ethernet/toshiba/spider_net.rst

Documentation/networking/device_drivers/index.rst +6 -45
index e18dad11bc72..2d4817fc6a29 100644
@@ -1,56 +1,17 @@
 .. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
 
-Vendor Device Drivers
-=====================
+Hardware Device Drivers
+=======================
 
 Contents:
 
 .. toctree::
    :maxdepth: 2
 
-   freescale/dpaa2/index
-   intel/e100
-   intel/e1000
-   intel/e1000e
-   intel/fm10k
-   intel/igb
-   intel/igbvf
-   intel/ixgb
-   intel/ixgbe
-   intel/ixgbevf
-   intel/i40e
-   intel/iavf
-   intel/ice
-   google/gve
-   marvell/octeontx2
-   mellanox/mlx5
-   netronome/nfp
-   pensando/ionic
-   stmicro/stmmac
-   3com/3c509
-   3com/vortex
-   amazon/ena
-   aquantia/atlantic
-   chelsio/cxgb
-   cirrus/cs89x0
-   davicom/dm9000
-   dec/de4x5
-   dec/dmfe
-   dlink/dl2k
-   freescale/dpaa
-   freescale/gianfar
-   intel/ipw2100
-   intel/ipw2200
-   microsoft/netvsc
-   neterion/s2io
-   neterion/vxge
-   qualcomm/rmnet
-   sb1000
-   smsc/smc9
-   ti/cpsw_switchdev
-   ti/cpsw
-   ti/tlan
-   toshiba/spider_net
+   cable/index
+   cellular/index
+   ethernet/index
+   wifi/index
 
 .. only::  subproject and html
 
Documentation/networking/device_drivers/wifi/index.rst new file +19 -0
new file mode 100644
index 000000000000..fb394f5de4a9
@@ -0,0 +1,19 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+Wi-Fi Device Drivers
+====================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   intel/ipw2100
+   intel/ipw2200
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/wifi/intel/ipw2100.rst renamed from Documentation/networking/device_drivers/intel/ipw2100.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ipw2100.rst
rename to Documentation/networking/device_drivers/wifi/intel/ipw2100.rst
Documentation/networking/device_drivers/wifi/intel/ipw2200.rst renamed from Documentation/networking/device_drivers/intel/ipw2200.rst +0 -0
similarity index 100%
rename from Documentation/networking/device_drivers/intel/ipw2200.rst
rename to Documentation/networking/device_drivers/wifi/intel/ipw2200.rst
MAINTAINERS +4 -5
index f08f290df174..154a6d34257e 100644
@@ -147,7 +147,7 @@ Maintainers List
 M:	Steffen Klassert <[email protected]>
 L:	[email protected]
 S:	Odd Fixes
-F:	Documentation/networking/device_drivers/3com/vortex.rst
+F:	Documentation/networking/device_drivers/ethernet/3com/vortex.rst
 F:	drivers/net/ethernet/3com/3c59x.c
 
 3CR990 NETWORK DRIVER
@@ -816,7 +816,7 @@ R:	Saeed Bishara <[email protected]>
 R:	Zorik Machulsky <[email protected]>
 L:	[email protected]
 S:	Supported
-F:	Documentation/networking/device_drivers/amazon/ena.rst
+F:	Documentation/networking/device_drivers/ethernet/amazon/ena.rst
 F:	drivers/net/ethernet/amazon/
 
 AMAZON RDMA EFA DRIVER
@@ -1295,7 +1295,7 @@ L:	[email protected]
 S:	Supported
 W:	https://www.marvell.com/
 Q:	http://patchwork.ozlabs.org/project/netdev/list/
-F:	Documentation/networking/device_drivers/aquantia/atlantic.rst
+F:	Documentation/networking/device_drivers/ethernet/aquantia/atlantic.rst
 F:	drivers/net/ethernet/aquantia/atlantic/
 
 AQUANTIA ETHERNET DRIVER PTP SUBSYSTEM
@@ -4733,7 +4733,7 @@ F:	net/ax25/sysctl_net_ax25.c
 DAVICOM FAST ETHERNET (DMFE) NETWORK DRIVER
 L:	[email protected]
 S:	Orphan
-F:	Documentation/networking/device_drivers/dec/dmfe.rst
+F:	Documentation/networking/device_drivers/ethernet/dec/dmfe.rst
 F:	drivers/net/ethernet/dec/tulip/dmfe.c
 
 DC390/AM53C974 SCSI driver
@@ -5221,8 +5221,8 @@ M:	Ioana Ciornei <[email protected]>
 M:	Ioana Radulescu <[email protected]>
 L:	[email protected]
 S:	Maintained
-F:	Documentation/networking/device_drivers/freescale/dpaa2/ethernet-

driver.rst
-F: Documentation/networking/device_drivers/freescale/dpaa2/mac-phy-
support.rst
+F:
Documentation/networking/device_drivers/ethernet/freescale/dpaa2/ethe
rnet-driver.rst
+F:
Documentation/networking/device_drivers/ethernet/freescale/dpaa2/mac

MAINTAINERS +4 -15
-phy-support.rst
 F:	drivers/net/ethernet/freescale/dpaa2/Kconfig
 F:	drivers/net/ethernet/freescale/dpaa2/Makefile
 F:	drivers/net/ethernet/freescale/dpaa2/dpaa2-eth*
@@ -7282,7 +7282,7 @@ R:	Sagi Shahar <[email protected]>
 R:	Jon Olson <[email protected]>
 L:	[email protected]
 S:	Supported
-F:	Documentation/networking/device_drivers/google/gve.rst
+F:	Documentation/networking/device_drivers/ethernet/google/gve.rst
 F:	drivers/net/ethernet/google
 
 GPD POCKET FAN DRIVER
@@ -7945,7 +7945,7 @@ S:	Supported
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/hyperv/linux.git
 F:	Documentation/ABI/stable/sysfs-bus-vmbus
 F:	Documentation/ABI/testing/debugfs-hyperv
-F:	Documentation/networking/device_drivers/microsoft/netvsc.rst
+F:	Documentation/networking/device_drivers/ethernet/microsoft/netvsc.rst
 F:	arch/x86/hyperv
 F:	arch/x86/include/asm/hyperv-tlfs.h
 F:	arch/x86/include/asm/mshyperv.h
@@ -8626,18 +8626,18 @@ W:	http://e1000.sourceforge.net/
 Q:	http://patchwork.ozlabs.org/project/intel-wired-lan/list/
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/jkirsher/net-queue.git
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/jkirsher/next-queue.git
-F:	Documentation/networking/device_drivers/intel/e100.rst
-F:	Documentation/networking/device_drivers/intel/e1000.rst
-F:	Documentation/networking/device_drivers/intel/e1000e.rst
-F:	Documentation/networking/device_drivers/intel/fm10k.rst
-F:	Documentation/networking/device_drivers/intel/i40e.rst
-F:	Documentation/networking/device_drivers/intel/iavf.rst
-F:	Documentation/networking/device_drivers/intel/ice.rst
-F:	Documentation/networking/device_drivers/intel/igb.rst
-F:	Documentation/networking/device_drivers/intel/igbvf.rst
-F:	Documentation/networking/device_drivers/intel/ixgb.rst
-F:	Documentation/networking/device_drivers/intel/ixgbe.rst
-F:	Documentation/networking/device_drivers/intel/ixgbevf.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/e100.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/e1000.rst

MAINTAINERS W: http://e1000.sourceforge.net/ · line 8640

Quoted 10 lines
MAINTAINERS +10 -0
+F:	Documentation/networking/device_drivers/ethernet/intel/e1000e.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/fm10k.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/i40e.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/iavf.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/ice.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/igb.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/igbvf.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/ixgb.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/ixgbe.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/ixgbevf.rst

[Kirsher, Jeffrey T]

With this patch, the above MAINTAIERS entries can be reduced to a single line. This can now become:

F: Documentation/networking/device_drivers/ethernet/intel/*

No need to list out all the documented files now that I support/maintain all documentation in the above folder.

Quoted 510 lines
MAINTAINERS +0 -0
 F:	drivers/net/ethernet/intel/
 F:	drivers/net/ethernet/intel/*/
 F:	include/linux/avf/virtchnl.h
@@ -8828,8 +8828,8 @@ INTEL PRO/WIRELESS 2100, 2200BG, 2915ABG

NETWORK CONNECTION SUPPORT
M: Stanislav Yakovlev <[email protected]>
L: [email protected]
S: Maintained

MAINTAINERS +8 -8
-F:	Documentation/networking/device_drivers/intel/ipw2100.rst
-F:	Documentation/networking/device_drivers/intel/ipw2200.rst
+F:	Documentation/networking/device_drivers/wifi/intel/ipw2100.rst
+F:	Documentation/networking/device_drivers/wifi/intel/ipw2200.rst
 F:	drivers/net/wireless/intel/ipw2x00/
 
 INTEL PSTATE DRIVER
@@ -10331,7 +10331,7 @@ M:	Geetha sowjanya <[email protected]>
 M:	Jerin Jacob <[email protected]>
 L:	[email protected]
 S:	Supported
-F:	Documentation/networking/device_drivers/marvell/octeontx2.rst
+F:	Documentation/networking/device_drivers/ethernet/marvell/octeontx2.rst
 F:	drivers/net/ethernet/marvell/octeontx2/af/
 
 MARVELL SOC MMC/SD/SDIO CONTROLLER DRIVER
@@ -11001,7 +11001,7 @@ L:	[email protected]
 S:	Supported
 W:	http://www.mellanox.com
 Q:	http://patchwork.ozlabs.org/project/netdev/list/
-F:	Documentation/networking/device_drivers/mellanox/
+F:	Documentation/networking/device_drivers/ethernet/mellanox/
 F:	drivers/net/ethernet/mellanox/mlx5/core/
 F:	include/linux/mlx5/
 
@@ -11784,8 +11784,8 @@ NETERION 10GbE DRIVERS (s2io/vxge)
 M:	Jon Mason <[email protected]>
 L:	[email protected]
 S:	Supported
-F:	Documentation/networking/device_drivers/neterion/s2io.rst
-F:	Documentation/networking/device_drivers/neterion/vxge.rst
+F:	Documentation/networking/device_drivers/ethernet/neterion/s2io.rst
+F:	Documentation/networking/device_drivers/ethernet/neterion/vxge.rst
 F:	drivers/net/ethernet/neterion/
 
 NETFILTER
@@ -13336,7 +13336,7 @@ M:	Shannon Nelson <[email protected]>
 M:	Pensando Drivers <[email protected]>
 L:	[email protected]
 S:	Supported
-F:	Documentation/networking/device_drivers/pensando/ionic.rst
+F:	Documentation/networking/device_drivers/ethernet/pensando/ionic.rst
 F:	drivers/net/ethernet/pensando/
 
 PER-CPU MEMORY ALLOCATOR
@@ -14018,7 +14018,7 @@ QLOGIC QLA3XXX NETWORK DRIVER
 M:	[email protected]
 L:	[email protected]
 S:	Supported
-F:	Documentation/networking/device_drivers/qlogic/LICENSE.qla3xxx
+F:
 	Documentation/networking/device_drivers/ethernet/qlogic/LICENSE.qla3x

xx
F: drivers/net/ethernet/qlogic/qla3xxx.*

QLOGIC QLA4XXX iSCSI DRIVER

MAINTAINERS +0 -0
@@ -14069,7 +14069,7 @@ M:	Laurentiu Tudor

<[email protected]>
L: [email protected]
S: Maintained
F: Documentation/devicetree/bindings/misc/fsl,qoriq-mc.txt

MAINTAINERS +1 -1
-F:	Documentation/networking/device_drivers/freescale/dpaa2/overview.rst
+F:

Documentation/networking/device_drivers/ethernet/freescale/dpaa2/over
view.rst
F: drivers/bus/fsl-mc/

QT1010 MEDIA DRIVER

MAINTAINERS +0 -0
@@ -14173,7 +14173,7 @@ M:	Subash Abhinov Kasiviswanathan

<[email protected]>
M: Sean Tranchetti <[email protected]>
L: [email protected]
S: Maintained

MAINTAINERS +2 -2
-F:	Documentation/networking/device_drivers/qualcomm/rmnet.rst
+F:	Documentation/networking/device_drivers/cellular/qualcomm/rmnet.rst
 F:	drivers/net/ethernet/qualcomm/rmnet/
 F:	include/linux/if_rmnet.h
@@ -16043,7 +16043,7 @@ SPIDERNET NETWORK DRIVER for CELL
 M:	Ishizaki Kou <[email protected]>
 L:	[email protected]
 S:	Supported
-F:	Documentation/networking/device_drivers/toshiba/spider_net.rst
+F:
 	Documentation/networking/device_drivers/ethernet/toshiba/spider_net.rs

t
F: drivers/net/ethernet/toshiba/spider_net*

SPMI SUBSYSTEM

MAINTAINERS +2 -2
@@ -16270,7 +16270,7 @@ M:	Jose Abreu <[email protected]>
 L:	[email protected]
 S:	Supported
 W:	http://www.stlinux.com
-F:	Documentation/networking/device_drivers/stmicro/
+F:	Documentation/networking/device_drivers/ethernet/stmicro/
 F:	drivers/net/ethernet/stmicro/stmmac/
 
 SUN3/3X
@@ -17158,7 +17158,7 @@ M:	Samuel Chessman <[email protected]>
 L:	[email protected] (subscribers-only)
 S:	Maintained
 W:	http://sourceforge.net/projects/tlan/
-F:	Documentation/networking/device_drivers/ti/tlan.rst
+F:	Documentation/networking/device_drivers/ethernet/ti/tlan.rst
 F:	drivers/net/ethernet/ti/tlan.*
 
 TM6000 VIDEO4LINUX DRIVER
drivers/net/Kconfig +1 -1
index c7d310ef1c83..962dcd044f1b 100644
@@ -460,7 +460,7 @@ config NET_SB1000
 
 	  At present this driver only compiles as a module, so say M here if
 	  you have this card. The module will be called sb1000. Then read
-	  <file:Documentation/networking/device_drivers/sb1000.rst> for
+	  <file:Documentation/networking/device_drivers/cable/sb1000.rst> for
 	  information on how to use this module, as it needs special ppp
 	  scripts for establishing a connection. Further documentation
 	  and the necessary scripts can be found at:
drivers/net/ethernet/3com/3c59x.c +1 -1
index 5984b7033999..741c67e546d4 100644
@@ -1149,7 +1149,7 @@ static int vortex_probe1(struct device *gendev, void
 __iomem *ioaddr, int irq,
 
 	print_info = (vortex_debug > 1);
 	if (print_info)
-		pr_info("See
 Documentation/networking/device_drivers/3com/vortex.rst\n");
+		pr_info("See
 Documentation/networking/device_drivers/ethernet/3com/vortex.rst\n");
drivers/net/ethernet/3com/3c59x.c +1 -1
 	pr_info("%s: 3Com %s %s at %p.\n",
 	       print_name,
@@ -1954,7 +1954,7 @@ vortex_error(struct net_device *dev, int status)
 				   dev->name, tx_status);
 			if (tx_status == 0x82) {
 				pr_err("Probably a duplex mismatch.  See "
-
 	"Documentation/networking/device_drivers/3com/vortex.rst\n");
+
 	"Documentation/networking/device_drivers/ethernet/3com/vortex.rst\n")
 ;
drivers/net/ethernet/3com/3c59x.c +0 -0
 			}
 			dump_tx_ring(dev);
 		}
drivers/net/ethernet/3com/Kconfig +1 -2
index 7cc259893cb9..c5958c515d06 100644
@@ -76,8 +76,8 @@ config VORTEX
 	  "Hurricane" (3c555/3cSOHO)                           PCI
 
 	  If you have such a card, say Y here.  More specific information is in
-	  <file:Documentation/networking/device_drivers/3com/vortex.rst> and
-	  in the comments at the beginning of
+

<file:Documentation/networking/device_drivers/ethernet/3com/vortex.rst>

drivers/net/ethernet/3com/Kconfig +1 -0
+	  and in the comments at the beginning of
 	  <file:drivers/net/ethernet/3com/3c59x.c>.
 
 	  To compile this support as a module, choose M here.
drivers/net/ethernet/chelsio/Kconfig +1 -1
index 82cdfa51ce37..238246924e0d 100644
@@ -26,7 +26,7 @@ config CHELSIO_T1
 	  This driver supports Chelsio gigabit and 10-gigabit
 	  Ethernet cards. More information about adapter features and
 	  performance tuning is in
-	  <file:Documentation/networking/device_drivers/chelsio/cxgb.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/chelsio/cxgb.rst>.

drivers/net/ethernet/chelsio/Kconfig +0 -0
 	  For general information about Chelsio and our products, visit
 	  our website at <http://www.chelsio.com>.
drivers/net/ethernet/cirrus/Kconfig +1 -1
index 8d845f5ee0c5..a0280d26d4cd 100644
@@ -24,7 +24,7 @@ config CS89x0
 	---help---
 	  Support for CS89x0 chipset based Ethernet cards. If you have a
 	  network (Ethernet) card of this type, say Y and read the file
-	  <file:Documentation/networking/device_drivers/cirrus/cs89x0.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/cirrus/cs89x0.rst>.

drivers/net/ethernet/cirrus/Kconfig +0 -0
 	  To compile this driver as a module, choose M here. The module
 	  will be called cs89x0.
drivers/net/ethernet/dec/tulip/Kconfig +1 -1
index 177f36f4b89d..5185cbe11b17 100644
@@ -114,7 +114,7 @@ config DE4X5
 	  These include the DE425, DE434, DE435, DE450 and DE500 models.  If
 	  you have a network card of this type, say Y.  More specific
 	  information is contained in
-	  <file:Documentation/networking/device_drivers/dec/de4x5.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/dec/de4x5.rst>.

drivers/net/ethernet/dec/tulip/Kconfig +0 -0
 	  To compile this driver as a module, choose M here. The module will
 	  be called de4x5.
@@ -138,7 +138,7 @@ config DM9102
 	  This driver is for DM9102(A)/DM9132/DM9801 compatible PCI cards

from
Davicom (<http://www.davicom.com.tw/>). If you have such a
network

drivers/net/ethernet/dec/tulip/Kconfig +1 -1
 	  (Ethernet) card, say Y.  Some information is contained in the file
-	  <file:Documentation/networking/device_drivers/dec/dmfe.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/dec/dmfe.rst>.

drivers/net/ethernet/dec/tulip/Kconfig +0 -0
 	  To compile this driver as a module, choose M here. The module will
 	  be called dmfe.
drivers/net/ethernet/dlink/dl2k.c +1 -10
index 5143722c4419..be6d8a9ada27 100644
@@ -1863,13 +1863,5 @@ static struct pci_driver rio_driver = {
 };
 
 module_pci_driver(rio_driver);
-/*
-
-Compile command:
-
-gcc -D__KERNEL__ -DMODULE -I/usr/src/linux/include -Wall -Wstrict-prototypes
-O2 -c dl2k.c
-
-Read Documentation/networking/device_drivers/dlink/dl2k.rst for details.
-
-*/
 
+/* Read Documentation/networking/device_drivers/ethernet/dlink/dl2k.rst. */
drivers/net/ethernet/intel/Kconfig +1 -1
index ad34e4335df2..a6cdd652489d 100644
@@ -34,7 +34,7 @@ config E100
 	  to identify the adapter.
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/e100.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/intel/e100.rst>.

drivers/net/ethernet/intel/Kconfig +1 -1
 	  To compile this driver as a module, choose M here. The module
 	  will be called e100.
@@ -50,7 +50,7 @@ config E1000
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/e1000.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/intel/e1000.rst>.

drivers/net/ethernet/intel/Kconfig +1 -1
 	  To compile this driver as a module, choose M here. The module
 	  will be called e1000.
@@ -70,7 +70,7 @@ config E1000E
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/e1000e.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/intel/e1000e.rst>.

drivers/net/ethernet/intel/Kconfig +2 -2
 	  To compile this driver as a module, choose M here. The module
 	  will be called e1000e.
@@ -98,7 +98,7 @@ config IGB
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/igb.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/igb.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called igb.
@@ -134,7 +134,7 @@ config IGBVF
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/igbvf.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/intel/igbvf.rst>.

drivers/net/ethernet/intel/Kconfig +1 -1
 	  To compile this driver as a module, choose M here. The module
 	  will be called igbvf.
@@ -151,7 +151,7 @@ config IXGB
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/ixgb.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/intel/ixgb.rst>.

drivers/net/ethernet/intel/Kconfig +1 -1
 	  To compile this driver as a module, choose M here. The module
 	  will be called ixgb.
@@ -170,7 +170,7 @@ config IXGBE
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/ixgbe.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/intel/ixgbe.rst>.

drivers/net/ethernet/intel/Kconfig +1 -1
 	  To compile this driver as a module, choose M here. The module
 	  will be called ixgbe.
@@ -222,7 +222,7 @@ config IXGBEVF
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/ixgbevf.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/intel/ixgbevf.rst>.

drivers/net/ethernet/intel/Kconfig +1 -1
 	  To compile this driver as a module, choose M here. The module
 	  will be called ixgbevf.  MSI-X interrupt support is required
@@ -249,7 +249,7 @@ config I40E
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/i40e.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/intel/i40e.rst>.

drivers/net/ethernet/intel/Kconfig +3 -3
 	  To compile this driver as a module, choose M here. The module
 	  will be called i40e.
@@ -284,7 +284,7 @@ config I40EVF
 	  This driver was formerly named i40evf.
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/iavf.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/iavf.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called iavf.  MSI-X interrupt support is required
@@ -303,7 +303,7 @@ config ICE
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/ice.rst>.
+	  <file:Documentation/networking/device_drivers/ethernet/intel/ice.rst>.
 
 	  To compile this driver as a module, choose M here. The module
 	  will be called ice.
@@ -321,7 +321,7 @@ config FM10K
 	  <http://support.intel.com>
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/intel/fm10k.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/intel/fm10k.rst>.

drivers/net/ethernet/intel/Kconfig +0 -0
 	  To compile this driver as a module, choose M here. The module
 	  will be called fm10k.  MSI-X interrupt support is required
drivers/net/ethernet/neterion/Kconfig +1 -1
index a82a37094579..d5760e7ba262 100644
@@ -27,7 +27,7 @@ config S2IO
 	  on its age.
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/neterion/s2io.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/neterion/s2io.rst>.

drivers/net/ethernet/neterion/Kconfig +1 -1
 	  To compile this driver as a module, choose M here. The module
 	  will be called s2io.
@@ -42,7 +42,7 @@ config VXGE
 	  labeled as either one, depending on its age.
 
 	  More specific information on configuring the driver is in
-	  <file:Documentation/networking/device_drivers/neterion/vxge.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/neterion/vxge.rst>.

drivers/net/ethernet/neterion/Kconfig +0 -0
 	  To compile this driver as a module, choose M here. The module
 	  will be called vxge.
drivers/net/ethernet/pensando/Kconfig +1 -1
index d25b88f53de4..76f8cc502bf9 100644
@@ -25,7 +25,7 @@ config IONIC
 	  This enables the support for the Pensando family of Ethernet
 	  adapters.  More specific information on this driver can be
 	  found in
-	  <file:Documentation/networking/device_drivers/pensando/ionic.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/pensando/ionic.rst>.

drivers/net/ethernet/pensando/Kconfig +0 -0
 	  To compile this driver as a module, choose M here. The module
 	  will be called ionic.
drivers/net/ethernet/smsc/Kconfig +1 -1
index 4d2d91ec8b41..599bc68f0290 100644
@@ -28,7 +28,7 @@ config SMC9194
 	  option if you have a DELL laptop with the docking station, or
 	  another SMC9192/9194 based chipset.  Say Y if you want it compiled
 	  into the kernel, and read the file
-	  <file:Documentation/networking/device_drivers/smsc/smc9.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/smsc/smc9.rst>.

drivers/net/ethernet/smsc/Kconfig +1 -1
 	  To compile this driver as a module, choose M here. The module
 	  will be called smc9194.
@@ -44,7 +44,7 @@ config SMC91X
 	  This is a driver for SMC's 91x series of Ethernet chipsets,
 	  including the SMC91C94 and the SMC91C111. Say Y if you want it
 	  compiled into the kernel, and read the file
-	  <file:Documentation/networking/device_drivers/smsc/smc9.rst>.
+

<file:Documentation/networking/device_drivers/ethernet/smsc/smc9.rst>.

drivers/net/ethernet/smsc/Kconfig +0 -0
 	  This driver is also available as a module ( = code which can be
 	  inserted in and removed from the running kernel whenever you want).
drivers/net/ethernet/ti/Kconfig +1 -1
index 182d10f171f6..308fee33fe7f 100644
@@ -156,7 +156,7 @@ config TLAN
 
 	  Devices currently supported by this driver are Compaq Netelligent,
 	  Compaq NetFlex and Olicom cards.  Please read the file
-	  <file:Documentation/networking/device_drivers/ti/tlan.rst>
+	  <file:Documentation/networking/device_drivers/ethernet/ti/tlan.rst>
 	  for more details.
 
 	  To compile this driver as a module, choose M here. The module
drivers/net/ethernet/ti/tlan.c +1 -1
index 857709828058..583cd2ef7662 100644
@@ -70,7 +70,7 @@ MODULE_DESCRIPTION("Driver for TI ThunderLAN based
 ethernet PCI adapters");
 MODULE_LICENSE("GPL");
 
 /* Turn on debugging.
- * See Documentation/networking/device_drivers/ti/tlan.rst for details
+ * See Documentation/networking/device_drivers/ethernet/ti/tlan.rst for details
  */
 static  int		debug;

module_param(debug, int, 0);

drivers/net/wireless/intel/ipw2x00/Kconfig +1 -1
index f42b3cdce611..77603d585051 100644
@@ -16,7 +16,7 @@ config IPW2100
 	  A driver for the Intel PRO/Wireless 2100 Network
 	  Connection 802.11b wireless network adapter.
 
-	  See <file:Documentation/networking/device_drivers/intel/ipw2100.rst>
+	  See

<file:Documentation/networking/device_drivers/wifi/intel/ipw2100.rst>

drivers/net/wireless/intel/ipw2x00/Kconfig +1 -1
 	  for information on the capabilities currently enabled in this driver
 	  and for tips for debugging issues and problems.
@@ -78,7 +78,7 @@ config IPW2200
 	  A driver for the Intel PRO/Wireless 2200BG and 2915ABG Network
 	  Connection adapters.
 
-	  See <file:Documentation/networking/device_drivers/intel/ipw2200.rst>
+	  See

<file:Documentation/networking/device_drivers/wifi/intel/ipw2200.rst>

drivers/net/wireless/intel/ipw2x00/Kconfig +0 -0
 	  for information on the capabilities currently enabled in this
 	  driver and for tips for debugging issues and problems.
drivers/net/wireless/intel/ipw2x00/ipw2100.c +0 -0
index 624fe721e2b5..753dada5a243 100644
@@ -8352,7 +8352,7 @@ static int ipw2100_mod_firmware_load(struct
 ipw2100_fw *fw)
 	if (IPW2100_FW_MAJOR(h->version) !=
 IPW2100_FW_MAJOR_VERSION) {
 		printk(KERN_WARNING DRV_NAME ": Firmware image not

compatible "

drivers/net/wireless/intel/ipw2x00/ipw2100.c +0 -1
 		       "(detected version id of %u). "
-		       "See

Documentation/networking/device_drivers/intel/ipw2100.rst\n",

drivers/net/wireless/intel/ipw2x00/ipw2100.c +1 -0
+		       "See

Documentation/networking/device_drivers/wifi/intel/ipw2100.rst\n",

drivers/net/wireless/intel/ipw2x00/ipw2100.c +0 -1
 		       h->version);
 		return 1;
 	}
--

2.26.2

author maintainer
#3 lore raw

Re: [RFC 1/8] docs: networking: reorganize driver documentation again

Quoted 30 lines · Jeffrey T
Quoted 18 lines
MAINTAINERS +2 -12
@@ -8626,18 +8626,18 @@ W:	http://e1000.sourceforge.net/
 Q:	http://patchwork.ozlabs.org/project/intel-wired-lan/list/
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/jkirsher/net-queue.git
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/jkirsher/next-queue.git
-F:	Documentation/networking/device_drivers/intel/e100.rst
-F:	Documentation/networking/device_drivers/intel/e1000.rst
-F:	Documentation/networking/device_drivers/intel/e1000e.rst
-F:	Documentation/networking/device_drivers/intel/fm10k.rst
-F:	Documentation/networking/device_drivers/intel/i40e.rst
-F:	Documentation/networking/device_drivers/intel/iavf.rst
-F:	Documentation/networking/device_drivers/intel/ice.rst
-F:	Documentation/networking/device_drivers/intel/igb.rst
-F:	Documentation/networking/device_drivers/intel/igbvf.rst
-F:	Documentation/networking/device_drivers/intel/ixgb.rst
-F:	Documentation/networking/device_drivers/intel/ixgbe.rst
-F:	Documentation/networking/device_drivers/intel/ixgbevf.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/e100.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/e1000.rst

MAINTAINERS W: http://e1000.sourceforge.net/ · line 8640

Quoted 10 lines
MAINTAINERS +10 -0
+F:	Documentation/networking/device_drivers/ethernet/intel/e1000e.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/fm10k.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/i40e.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/iavf.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/ice.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/igb.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/igbvf.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/ixgb.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/ixgbe.rst
+F:	Documentation/networking/device_drivers/ethernet/intel/ixgbevf.rst  

[Kirsher, Jeffrey T]

Quoted 5 lines

With this patch, the above MAINTAIERS entries can be reduced to a single line. This can now become:

F: Documentation/networking/device_drivers/ethernet/intel/*

No need to list out all the documented files now that I support/maintain all documentation in the above folder.

Ah, good point, the Wi-Fi is no longer there!

#4 lore raw

Re: [RFC 1/8] docs: networking: reorganize driver documentation again

In reply to Kirsher, Jeffrey T
Quoted 19 lines · Jeffrey T
Quoted 19 lines

-----Original Message-----
From: Jakub Kicinski <[email protected]>
Sent: Thursday, June 11, 2020 10:30
To: [email protected]
Cc: [email protected]; [email protected]; Jakub Kicinski <[email protected]>; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; GR-Linux- [email protected]; [email protected]; Kirsher, Jeffrey T <[email protected]>; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]
Subject: [RFC 1/8] docs: networking: reorganize driver documentation again

Organize driver documentation by device type. Most documents have fairly verbose yet uninformative names, so let users first select a well defined device type, and then search for a particular driver.

Quoted 5 lines
Quoted 5 lines

While at it rename the section from Vendor drivers to Hardware drivers. This seems more accurate, besides people sometimes refer to out-of-tree drivers as vendor drivers.

How much of it is still relevant and useful?

The last time I checked, lots of this had bad advice about settings. And there was lots of drivers documenting what was generic Linux functionality

And still there were references to old commands like ifconfig or ifenslave.

author maintainer
#5 lore raw

Re: [RFC 1/8] docs: networking: reorganize driver documentation again

Quoted 11 lines · On Thu, 11 Jun 2020 15:18:42 -0700 Stephen Hemminger wrote:
Quoted 10 lines
Quoted 10 lines

Organize driver documentation by device type. Most documents have fairly verbose yet uninformative names, so let users first select a well defined device type, and then search for a particular driver.

While at it rename the section from Vendor drivers to Hardware drivers. This seems more accurate, besides people sometimes refer to out-of-tree drivers as vendor drivers.

Quoted 7 lines

How much of it is still relevant and useful?

The last time I checked, lots of this had bad advice about settings. And there was lots of drivers documenting what was generic Linux functionality

And still there were references to old commands like ifconfig or ifenslave.

For general documentation I hope now that it's slightly de-cluttered it's more likely folks (including myself, time allowing) will be more inclined to clean up / contribute. I haven't looked in detail, yet.

As for the vendor docs - I guess that the obsolescence of the docs/ instructions goes hand in hand with obsolescence of the HW itself.

#6 lore raw

RE: [RFC 1/8] docs: networking: reorganize driver documentation again

Quoted 31 lines

-----Original Message-----
From: Jakub Kicinski <[email protected]>
Sent: Thursday, June 11, 2020 16:09
To: Stephen Hemminger <[email protected]>
Cc: Kirsher, Jeffrey T <[email protected]>; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]; [email protected]
Subject: Re: [RFC 1/8] docs: networking: reorganize driver documentation again

Quoted 17 lines · On Thu, 11 Jun 2020 15:18:42 -0700 Stephen Hemminger wrote:
Quoted 10 lines
Quoted 10 lines

Organize driver documentation by device type. Most documents have fairly verbose yet uninformative names, so let users first select a well defined device type, and then search for a particular driver.

While at it rename the section from Vendor drivers to Hardware drivers. This seems more accurate, besides people sometimes refer to out-of-tree drivers as vendor drivers.

How much of it is still relevant and useful?

The last time I checked, lots of this had bad advice about settings. And there was lots of drivers documenting what was generic Linux functionality

Quoted 5 lines
Quoted 1 line

And still there were references to old commands like ifconfig or ifenslave.

For general documentation I hope now that it's slightly de-cluttered it's more likely folks (including myself, time allowing) will be more inclined to clean up / contribute. I haven't looked in detail, yet.

[Kirsher, Jeffrey T]

I agree, I have been meaning to "organize" the networking documentation for the last year, but was not finding the time. So thank you! This will also make it easier to review and update the current documentation.

Quoted 3 lines

As for the vendor docs - I guess that the obsolescence of the docs/ instructions goes hand in hand with obsolescence of the HW itself.

Acked-by on v1 1/8
#7 lore raw

Re: [RFC 1/8] docs: networking: reorganize driver documentation again

In reply to Jakub Kicinski
Quoted 10 lines · Jakub Kicinski

Organize driver documentation by device type. Most documents have fairly verbose yet uninformative names, so let users first select a well defined device type, and then search for a particular driver.

While at it rename the section from Vendor drivers to Hardware drivers. This seems more accurate, besides people sometimes refer to out-of-tree drivers as vendor drivers.

Quoted 9 lines

--
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]
CC: [email protected]

I'm fine with the Pensando ionic changes.
Thanks,
sln

Quoted 10 lines

---

author maintainer
#8 lore raw

RFC 2/8 docs: networking: move z8530 to the hw driver section

In reply to Jakub Kicinski

Move z8530 docs to hamradio and wan subdirectories.

--
CC: [email protected]
CC: [email protected]

---
 .../device_drivers/hamradio/index.rst          | 18 ++++++++++++++++++
 .../{ => device_drivers/hamradio}/z8530drv.rst |  0
 .../networking/device_drivers/index.rst        |  2 ++
 .../networking/device_drivers/wan/index.rst    | 18 ++++++++++++++++++
 .../{ => device_drivers/wan}/z8530book.rst     |  0
 Documentation/networking/index.rst             |  2 --
 MAINTAINERS                                    |  2 +-
 drivers/net/hamradio/Kconfig                   |  8 +++++---
 drivers/net/hamradio/scc.c                     |  2 +-
 9 files changed, 45 insertions(+), 7 deletions(-)
 create mode 100644 Documentation/networking/device_drivers/hamradio/index.rst
 rename Documentation/networking/{ => device_drivers/hamradio}/z8530drv.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/wan/index.rst
 rename Documentation/networking/{ => device_drivers/wan}/z8530book.rst (100%)
Documentation/networking/device_drivers/hamradio/index.rst new file +18 -0
new file mode 100644
index 000000000000..df03a5acbfa7
@@ -0,0 +1,18 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+Amateur Radio Device Drivers
+============================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   z8530drv
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/hamradio/z8530drv.rst renamed from Documentation/networking/z8530drv.rst +0 -0
similarity index 100%
rename from Documentation/networking/z8530drv.rst
rename to Documentation/networking/device_drivers/hamradio/z8530drv.rst
Documentation/networking/device_drivers/index.rst +2 -0
index 2d4817fc6a29..5497e3ae1ca9 100644
@@ -11,6 +11,8 @@ Hardware Device Drivers
    cable/index
    cellular/index
    ethernet/index
+   hamradio/index
+   wan/index
    wifi/index
 
 .. only::  subproject and html
Documentation/networking/device_drivers/wan/index.rst new file +18 -0
new file mode 100644
index 000000000000..9d9ae94f00b4
@@ -0,0 +1,18 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+Classic WAN Device Drivers
+==========================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   z8530book
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/wan/z8530book.rst renamed from Documentation/networking/z8530book.rst +0 -0
similarity index 100%
rename from Documentation/networking/z8530book.rst
rename to Documentation/networking/device_drivers/wan/z8530book.rst
Documentation/networking/index.rst +0 -2
index 0186e276690a..718e04e3f7ed 100644
@@ -20,7 +20,6 @@ Linux Networking Documentation
    ieee802154
    j1939
    kapi
-   z8530book
    msg_zerocopy
    failover
    net_dim
@@ -122,7 +121,6 @@ Linux Networking Documentation
    xfrm_proc
    xfrm_sync
    xfrm_sysctl
-   z8530drv
 
 .. only::  subproject and html
 
MAINTAINERS +1 -1
index 154a6d34257e..4d31e9401b84 100644
@@ -18842,7 +18842,7 @@ L:	[email protected]
 S:	Maintained
 W:	http://yaina.de/jreuter/
 W:	http://www.qsl.net/dl1bke/
-F:	Documentation/networking/z8530drv.rst
+F:	Documentation/networking/device_drivers/hamradio/z8530drv.rst
 F:	drivers/net/hamradio/*scc.c
 F:	drivers/net/hamradio/z8530.h
 
drivers/net/hamradio/Kconfig +5 -3
index f4500f04147d..6aaca62940d0 100644
@@ -84,8 +84,9 @@ config SCC
 	---help---
 	  These cards are used to connect your Linux box to an amateur radio
 	  in order to communicate with other computers. If you want to use
-	  this, read <file:Documentation/networking/z8530drv.rst> and the
-	  AX25-HOWTO, available from
+	  this, read
+	  <file:Documentation/networking/device_drivers/hamradio/z8530drv.rst>
+	  and the AX25-HOWTO, available from
 	  <http://www.tldp.org/docs.html#howto>. Also make sure to say Y
 	  to "Amateur Radio AX.25 Level 2" support.
 
@@ -98,7 +99,8 @@ config SCC_DELAY
 	help
 	  Say Y here if you experience problems with the SCC driver not
 	  working properly; please read
-	  <file:Documentation/networking/z8530drv.rst> for details.
+	  <file:Documentation/networking/device_drivers/hamradio/z8530drv.rst>
+	  for details.
 
 	  If unsure, say N.
 
drivers/net/hamradio/scc.c +1 -1
index 33fdd55c6122..1e915871baa7 100644
@@ -7,7 +7,7 @@
  *            ------------------
  *
  * You can find a subset of the documentation in 
- * Documentation/networking/z8530drv.rst.
+ * Documentation/networking/device_drivers/wan/z8530drv.rst.
  */
 
 /*
Signature · 1 line
2.26.2
author maintainer
#9 lore raw

RFC 3/8 docs: networking: move baycom to the hw driver section

In reply to Jakub Kicinski

Move baycom to hamradio.

--
CC: [email protected]

---
 .../networking/{ => device_drivers/hamradio}/baycom.rst   | 0
 .../networking/device_drivers/hamradio/index.rst          | 1 +
 Documentation/networking/index.rst                        | 1 -
 drivers/net/hamradio/Kconfig                              | 8 ++++----
 4 files changed, 5 insertions(+), 5 deletions(-)
 rename Documentation/networking/{ => device_drivers/hamradio}/baycom.rst (100%)
Documentation/networking/device_drivers/hamradio/baycom.rst renamed from Documentation/networking/baycom.rst +0 -0
similarity index 100%
rename from Documentation/networking/baycom.rst
rename to Documentation/networking/device_drivers/hamradio/baycom.rst
Documentation/networking/device_drivers/hamradio/index.rst +1 -0
index df03a5acbfa7..7e731732057b 100644
@@ -8,6 +8,7 @@ Amateur Radio Device Drivers
 .. toctree::
    :maxdepth: 2
 
+   baycom
    z8530drv
 
 .. only::  subproject and html
Documentation/networking/index.rst +0 -1
index 718e04e3f7ed..76831e9d7c9a 100644
@@ -43,7 +43,6 @@ Linux Networking Documentation
    arcnet
    atm
    ax25
-   baycom
    bonding
    cdc_mbim
    cops
drivers/net/hamradio/Kconfig +4 -4
index 6aaca62940d0..8e63afc8a2e6 100644
@@ -129,7 +129,7 @@ config BAYCOM_SER_FDX
 	  your serial interface chip. To configure the driver, use the sethdlc
 	  utility available in the standard ax25 utilities package. For
 	  information on the modems, see <http://www.baycom.de/> and
-	  <file:Documentation/networking/baycom.rst>.
+	  <file:Documentation/networking/device_drivers/hamradio/baycom.rst>.
 
 	  To compile this driver as a module, choose M here: the module
 	  will be called baycom_ser_fdx.  This is recommended.
@@ -147,7 +147,7 @@ config BAYCOM_SER_HDX
 	  the driver, use the sethdlc utility available in the standard ax25
 	  utilities package. For information on the modems, see
 	  <http://www.baycom.de/> and
-	  <file:Documentation/networking/baycom.rst>.
+	  <file:Documentation/networking/device_drivers/hamradio/baycom.rst>.
 
 	  To compile this driver as a module, choose M here: the module
 	  will be called baycom_ser_hdx.  This is recommended.
@@ -162,7 +162,7 @@ config BAYCOM_PAR
 	  par96 designs. To configure the driver, use the sethdlc utility
 	  available in the standard ax25 utilities package. For information on
 	  the modems, see <http://www.baycom.de/> and the file
-	  <file:Documentation/networking/baycom.rst>.
+	  <file:Documentation/networking/device_drivers/hamradio/baycom.rst>.
 
 	  To compile this driver as a module, choose M here: the module
 	  will be called baycom_par.  This is recommended.
@@ -177,7 +177,7 @@ config BAYCOM_EPP
 	  designs. To configure the driver, use the sethdlc utility available
 	  in the standard ax25 utilities package. For information on the
 	  modems, see <http://www.baycom.de/> and the file
-	  <file:Documentation/networking/baycom.rst>.
+	  <file:Documentation/networking/device_drivers/hamradio/baycom.rst>.
 
 	  To compile this driver as a module, choose M here: the module
 	  will be called baycom_epp.  This is recommended.
Signature · 1 line
2.26.2
author maintainer
#10 lore raw

RFC 4/8 docs: networking: move ray_cs to the hw driver section

In reply to Jakub Kicinski

Move ray_cs into Wi-Fi driver docs subdirectory.

---
 Documentation/networking/device_drivers/wifi/index.rst        | 1 +
 Documentation/networking/{ => device_drivers/wifi}/ray_cs.rst | 0
 Documentation/networking/index.rst                            | 1 -
 drivers/net/wireless/Kconfig                                  | 3 ++-
 4 files changed, 3 insertions(+), 2 deletions(-)
 rename Documentation/networking/{ => device_drivers/wifi}/ray_cs.rst (100%)
Documentation/networking/device_drivers/wifi/index.rst +1 -0
index fb394f5de4a9..bf91a87c7acf 100644
@@ -10,6 +10,7 @@ Wi-Fi Device Drivers
 
    intel/ipw2100
    intel/ipw2200
+   ray_cs
 
 .. only::  subproject and html
 
Documentation/networking/device_drivers/wifi/ray_cs.rst renamed from Documentation/networking/ray_cs.rst +0 -0
similarity index 100%
rename from Documentation/networking/ray_cs.rst
rename to Documentation/networking/device_drivers/wifi/ray_cs.rst
Documentation/networking/index.rst +0 -1
index 76831e9d7c9a..9f8230c325af 100644
@@ -95,7 +95,6 @@ Linux Networking Documentation
    ppp_generic
    proc_net_tcp
    radiotap-headers
-   ray_cs
    rds
    regulatory
    rxrpc
drivers/net/wireless/Kconfig +2 -1
index 15b0ad171f4c..7e91ec8afafc 100644
@@ -57,7 +57,8 @@ config PCMCIA_RAYCS
 	---help---
 	  Say Y here if you intend to attach an Aviator/Raytheon PCMCIA
 	  (PC-card) wireless Ethernet networking card to your computer.
-	  Please read the file <file:Documentation/networking/ray_cs.rst> for
+	  Please read the file
+	  <file:Documentation/networking/device_drivers/wifi/ray_cs.rst> for
 	  details.
 
 	  To compile this driver as a module, choose M here: the module will be
Signature · 1 line
2.26.2
author maintainer
#11 lore raw

RFC 5/8 docs: networking: move remaining Ethernet driver docs to the hw section

In reply to Jakub Kicinski

Move docs for hinic and altera_tse under device_drivers/ethernet.

--
CC: [email protected]

---
 .../{ => device_drivers/ethernet/altera}/altera_tse.rst         | 0
 .../networking/{ => device_drivers/ethernet/huawei}/hinic.rst   | 0
 Documentation/networking/device_drivers/ethernet/index.rst      | 2 ++
 Documentation/networking/index.rst                              | 2 --
 MAINTAINERS                                                     | 2 +-
 5 files changed, 3 insertions(+), 3 deletions(-)
 rename Documentation/networking/{ => device_drivers/ethernet/altera}/altera_tse.rst (100%)
 rename Documentation/networking/{ => device_drivers/ethernet/huawei}/hinic.rst (100%)
Documentation/networking/device_drivers/ethernet/altera/altera_tse.rst renamed from Documentation/networking/altera_tse.rst +0 -0
similarity index 100%
rename from Documentation/networking/altera_tse.rst
rename to Documentation/networking/device_drivers/ethernet/altera/altera_tse.rst
Documentation/networking/device_drivers/ethernet/huawei/hinic.rst renamed from Documentation/networking/hinic.rst +0 -0
similarity index 100%
rename from Documentation/networking/hinic.rst
rename to Documentation/networking/device_drivers/ethernet/huawei/hinic.rst
Documentation/networking/device_drivers/ethernet/index.rst +2 -0
index fd3873024da8..cbb75a1818c0 100644
@@ -13,6 +13,7 @@ Device drivers for Ethernet and Ethernet-based virtual function devices.
    3com/3c509
    3com/vortex
    amazon/ena
+   altera/altera_tse
    aquantia/atlantic
    chelsio/cxgb
    cirrus/cs89x0
@@ -24,6 +25,7 @@ Device drivers for Ethernet and Ethernet-based virtual function devices.
    freescale/dpaa2/index
    freescale/gianfar
    google/gve
+   huawei/hinic
    intel/e100
    intel/e1000
    intel/e1000e
Documentation/networking/index.rst +0 -2
index 9f8230c325af..9bc8ecc79d94 100644
@@ -38,7 +38,6 @@ Linux Networking Documentation
    nfc
    6lowpan
    6pack
-   altera_tse
    arcnet-hardware
    arcnet
    atm
@@ -62,7 +61,6 @@ Linux Networking Documentation
    generic_netlink
    gen_stats
    gtp
-   hinic
    ila
    ipddp
    ip_dynaddr
MAINTAINERS +1 -1
index 4d31e9401b84..ab1b55a1f50e 100644
@@ -7893,7 +7893,7 @@ HUAWEI ETHERNET DRIVER
 M:	Bin Luo <[email protected]>
 L:	[email protected]
 S:	Supported
-F:	Documentation/networking/hinic.rst
+F:	Documentation/networking/device_drivers/ethernet/huawei/hinic.rst
 F:	drivers/net/ethernet/huawei/hinic/
 
 HUGETLB FILESYSTEM
Signature · 1 line
2.26.2
author maintainer
#12 lore raw

RFC 6/8 docs: networking: move AppleTalk / LocalTalk drivers to the hw driver section

In reply to Jakub Kicinski

Move docs for cops and ltpc under device_drivers/appletalk.

---
 .../{ => device_drivers/appletalk}/cops.rst   |  0
 .../device_drivers/appletalk/index.rst        | 19 +++++++++++++++++++
 .../{ => device_drivers/appletalk}/ltpc.rst   |  0
 .../networking/device_drivers/index.rst       |  1 +
 Documentation/networking/index.rst            |  2 --
 drivers/net/appletalk/Kconfig                 |  3 ++-
 6 files changed, 22 insertions(+), 3 deletions(-)
 rename Documentation/networking/{ => device_drivers/appletalk}/cops.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/appletalk/index.rst
 rename Documentation/networking/{ => device_drivers/appletalk}/ltpc.rst (100%)
Documentation/networking/device_drivers/appletalk/cops.rst renamed from Documentation/networking/cops.rst +0 -0
similarity index 100%
rename from Documentation/networking/cops.rst
rename to Documentation/networking/device_drivers/appletalk/cops.rst
Documentation/networking/device_drivers/appletalk/index.rst new file +19 -0
new file mode 100644
index 000000000000..de7507f02037
@@ -0,0 +1,19 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+AppleTalk Device Drivers
+========================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   cops
+   ltpc
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/appletalk/ltpc.rst renamed from Documentation/networking/ltpc.rst +0 -0
similarity index 100%
rename from Documentation/networking/ltpc.rst
rename to Documentation/networking/device_drivers/appletalk/ltpc.rst
Documentation/networking/device_drivers/index.rst +1 -0
index 5497e3ae1ca9..3995e2179aa0 100644
@@ -8,6 +8,7 @@ Hardware Device Drivers
 .. toctree::
    :maxdepth: 2
 
+   appletalk/index
    cable/index
    cellular/index
    ethernet/index
Documentation/networking/index.rst +0 -2
index 9bc8ecc79d94..eb616ac48094 100644
@@ -44,7 +44,6 @@ Linux Networking Documentation
    ax25
    bonding
    cdc_mbim
-   cops
    cxacru
    dccp
    dctcp
@@ -73,7 +72,6 @@ Linux Networking Documentation
    kcm
    l2tp
    lapb-module
-   ltpc
    mac80211-injection
    mpls-sysctl
    multiqueue
drivers/net/appletalk/Kconfig +2 -1
index 10589a82263b..ef45ac8992b6 100644
@@ -59,7 +59,8 @@ config COPS
 	  package. This driver is experimental, which means that it may not
 	  work. This driver will only work if you choose "AppleTalk DDP"
 	  networking support, above.
-	  Please read the file <file:Documentation/networking/cops.rst>.
+	  Please read the file
+	  <file:Documentation/networking/device_drivers/appletalk/cops.rst>.
 
 config COPS_DAYNA
 	bool "Dayna firmware support"
Signature · 1 line
2.26.2
author maintainer
#13 lore raw

RFC 7/8 docs: networking: move ATM drivers to the hw driver section

In reply to Jakub Kicinski

Move docs for cxacru, fore200e and iphase under device_drivers/atm.

--
CC: [email protected]
CC: [email protected]
CC: [email protected]

---
 .../{ => device_drivers/atm}/cxacru-cf.py     |  0
 .../{ => device_drivers/atm}/cxacru.rst       |  0
 .../{ => device_drivers/atm}/fore200e.rst     |  0
 .../networking/device_drivers/atm/index.rst   | 20 +++++++++++++++++++
 .../{ => device_drivers/atm}/iphase.rst       |  0
 .../networking/device_drivers/index.rst       |  1 +
 Documentation/networking/index.rst            |  3 ---
 drivers/atm/Kconfig                           |  8 +++++---
 8 files changed, 26 insertions(+), 6 deletions(-)
 rename Documentation/networking/{ => device_drivers/atm}/cxacru-cf.py (100%)
 rename Documentation/networking/{ => device_drivers/atm}/cxacru.rst (100%)
 rename Documentation/networking/{ => device_drivers/atm}/fore200e.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/atm/index.rst
 rename Documentation/networking/{ => device_drivers/atm}/iphase.rst (100%)
Documentation/networking/device_drivers/atm/cxacru-cf.py renamed from Documentation/networking/cxacru-cf.py +0 -0
similarity index 100%
rename from Documentation/networking/cxacru-cf.py
rename to Documentation/networking/device_drivers/atm/cxacru-cf.py
Documentation/networking/device_drivers/atm/cxacru.rst renamed from Documentation/networking/cxacru.rst +0 -0
similarity index 100%
rename from Documentation/networking/cxacru.rst
rename to Documentation/networking/device_drivers/atm/cxacru.rst
Documentation/networking/device_drivers/atm/fore200e.rst renamed from Documentation/networking/fore200e.rst +0 -0
similarity index 100%
rename from Documentation/networking/fore200e.rst
rename to Documentation/networking/device_drivers/atm/fore200e.rst
Documentation/networking/device_drivers/atm/index.rst new file +20 -0
new file mode 100644
index 000000000000..7b593f031a60
@@ -0,0 +1,20 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+Asynchronous Transfer Mode (ATM) Device Drivers
+===============================================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   cxacru
+   fore200e
+   iphase
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/atm/iphase.rst renamed from Documentation/networking/iphase.rst +0 -0
similarity index 100%
rename from Documentation/networking/iphase.rst
rename to Documentation/networking/device_drivers/atm/iphase.rst
Documentation/networking/device_drivers/index.rst +1 -0
index 3995e2179aa0..d6a73e4592e0 100644
@@ -9,6 +9,7 @@ Hardware Device Drivers
    :maxdepth: 2
 
    appletalk/index
+   atm/index
    cable/index
    cellular/index
    ethernet/index
Documentation/networking/index.rst +0 -3
index eb616ac48094..f48f1d19caff 100644
@@ -44,7 +44,6 @@ Linux Networking Documentation
    ax25
    bonding
    cdc_mbim
-   cxacru
    dccp
    dctcp
    decnet
@@ -54,7 +53,6 @@ Linux Networking Documentation
    eql
    fib_trie
    filter
-   fore200e
    framerelay
    generic-hdlc
    generic_netlink
@@ -63,7 +61,6 @@ Linux Networking Documentation
    ila
    ipddp
    ip_dynaddr
-   iphase
    ipsec
    ip-sysctl
    ipv6
drivers/atm/Kconfig +5 -3
index cfb0d16b60ad..55faab07b522 100644
@@ -306,8 +306,9 @@ config ATM_IA
 	  for more info about the cards. Say Y (or M to compile as a module
 	  named iphase) here if you have one of these cards.
 
-	  See the file <file:Documentation/networking/iphase.rst> for further
-	  details.
+	  See the file
+	  <file:Documentation/networking/device_drivers/atm/iphase.rst>
+	  for further details.
 
 config ATM_IA_DEBUG
 	bool "Enable debugging messages"
@@ -336,7 +337,8 @@ config ATM_FORE200E
 	  on PCI and SBUS hosts. Say Y (or M to compile as a module
 	  named fore_200e) here if you have one of these ATM adapters.
 
-	  See the file <file:Documentation/networking/fore200e.rst> for
+	  See the file
+	  <file:Documentation/networking/device_drivers/atm/fore200e.rst> for
 	  further details.
 
 config ATM_FORE200E_USE_TASKLET
Signature · 1 line
2.26.2
author maintainer
#14 lore raw

RFC 8/8 docs: networking: move FDDI drivers to the hw driver section

In reply to Jakub Kicinski

Move docs for defza and skfp under device_drivers/fddi.

--
CC: [email protected]

---
 .../{ => device_drivers/fddi}/defza.rst       |  0
 .../networking/device_drivers/fddi/index.rst  | 19 +++++++++++++++++++
 .../{ => device_drivers/fddi}/skfp.rst        |  0
 .../networking/device_drivers/index.rst       |  1 +
 Documentation/networking/index.rst            |  2 --
 drivers/net/fddi/Kconfig                      |  4 ++--
 6 files changed, 22 insertions(+), 4 deletions(-)
 rename Documentation/networking/{ => device_drivers/fddi}/defza.rst (100%)
 create mode 100644 Documentation/networking/device_drivers/fddi/index.rst
 rename Documentation/networking/{ => device_drivers/fddi}/skfp.rst (100%)
Documentation/networking/device_drivers/fddi/defza.rst renamed from Documentation/networking/defza.rst +0 -0
similarity index 100%
rename from Documentation/networking/defza.rst
rename to Documentation/networking/device_drivers/fddi/defza.rst
Documentation/networking/device_drivers/fddi/index.rst new file +19 -0
new file mode 100644
index 000000000000..0b75294e6c8b
@@ -0,0 +1,19 @@
+.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+
+Fiber Distributed Data Interface (FDDI) Device Drivers
+======================================================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   defza
+   skfp
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/networking/device_drivers/fddi/skfp.rst renamed from Documentation/networking/skfp.rst +0 -0
similarity index 100%
rename from Documentation/networking/skfp.rst
rename to Documentation/networking/device_drivers/fddi/skfp.rst
Documentation/networking/device_drivers/index.rst +1 -0
index d6a73e4592e0..a3113ffd7a16 100644
@@ -13,6 +13,7 @@ Hardware Device Drivers
    cable/index
    cellular/index
    ethernet/index
+   fddi/index
    hamradio/index
    wan/index
    wifi/index
Documentation/networking/index.rst +0 -2
index f48f1d19caff..c29496fff81c 100644
@@ -47,7 +47,6 @@ Linux Networking Documentation
    dccp
    dctcp
    decnet
-   defza
    dns_resolver
    driver
    eql
@@ -94,7 +93,6 @@ Linux Networking Documentation
    sctp
    secid
    seg6-sysctl
-   skfp
    strparser
    switchdev
    tc-actions-env-rules
drivers/net/fddi/Kconfig +2 -2
index da4f58eed08f..1cca61293577 100644
@@ -77,8 +77,8 @@ config SKFP
 	  - Netelligent 100 FDDI SAS UTP
 	  - Netelligent 100 FDDI SAS Fibre MIC
 
-	  Read <file:Documentation/networking/skfp.rst> for information about
-	  the driver.
+	  Read <file:Documentation/networking/device_drivers/fddi/skfp.rst>
+	  for information about the driver.
 
 	  Questions concerning this driver can be addressed to:
 	  <[email protected]>
Signature · 1 line
2.26.2