summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMauro Carvalho Chehab <mchehab+samsung@kernel.org>2019-06-18 17:05:38 -0400
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>2019-06-20 08:28:36 -0400
commitecefae6db042283bf88ef3777f2381b18df8ed46 (patch)
tree5177129d720add73008eeadd6581fab7c27f5233
parent743344a952fcebee9ca4d783807cf1f03f933baf (diff)
docs: usb: rename files to .rst and add them to drivers-api
While there are a mix of things here, most of the stuff were written from Kernel developer's PoV. So, add them to the driver-api book. A follow up for this patch would be to move documents from there that are specific to sysadmins, adding them to the admin-guide. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> Acked-by: Johan Hovold <johan@kernel.org> Acked-by: Felipe Balbi <felipe.balbi@linux.intel.com> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
-rw-r--r--Documentation/index.rst1
-rw-r--r--Documentation/index.rst.rej10
-rw-r--r--Documentation/usb/acm.rst (renamed from Documentation/usb/acm.txt)0
-rw-r--r--Documentation/usb/authorization.rst (renamed from Documentation/usb/authorization.txt)0
-rw-r--r--Documentation/usb/chipidea.rst (renamed from Documentation/usb/chipidea.txt)0
-rw-r--r--Documentation/usb/dwc3.rst (renamed from Documentation/usb/dwc3.txt)0
-rw-r--r--Documentation/usb/ehci.rst (renamed from Documentation/usb/ehci.txt)0
-rw-r--r--Documentation/usb/functionfs.rst (renamed from Documentation/usb/functionfs.txt)0
-rw-r--r--Documentation/usb/gadget-testing.rst (renamed from Documentation/usb/gadget-testing.txt)4
-rw-r--r--Documentation/usb/gadget_configfs.rst (renamed from Documentation/usb/gadget_configfs.txt)0
-rw-r--r--Documentation/usb/gadget_hid.rst (renamed from Documentation/usb/gadget_hid.txt)0
-rw-r--r--Documentation/usb/gadget_multi.rst (renamed from Documentation/usb/gadget_multi.txt)0
-rw-r--r--Documentation/usb/gadget_printer.rst (renamed from Documentation/usb/gadget_printer.txt)0
-rw-r--r--Documentation/usb/gadget_serial.rst (renamed from Documentation/usb/gadget_serial.txt)0
-rw-r--r--Documentation/usb/index.rst39
-rw-r--r--Documentation/usb/iuu_phoenix.rst (renamed from Documentation/usb/iuu_phoenix.txt)0
-rw-r--r--Documentation/usb/mass-storage.rst (renamed from Documentation/usb/mass-storage.txt)0
-rw-r--r--Documentation/usb/misc_usbsevseg.rst (renamed from Documentation/usb/misc_usbsevseg.txt)0
-rw-r--r--Documentation/usb/mtouchusb.rst (renamed from Documentation/usb/mtouchusb.txt)0
-rw-r--r--Documentation/usb/ohci.rst (renamed from Documentation/usb/ohci.txt)0
-rw-r--r--Documentation/usb/rio.rst (renamed from Documentation/usb/rio.txt)0
-rw-r--r--Documentation/usb/text_files.rst29
-rw-r--r--Documentation/usb/usb-help.rst (renamed from Documentation/usb/usb-help.txt)0
-rw-r--r--Documentation/usb/usb-serial.rst (renamed from Documentation/usb/usb-serial.txt)0
-rw-r--r--Documentation/usb/usbip_protocol.rst (renamed from Documentation/usb/usbip_protocol.txt)0
-rw-r--r--Documentation/usb/usbmon.rst (renamed from Documentation/usb/usbmon.txt)0
-rw-r--r--Documentation/usb/wusb-design-overview.rst (renamed from Documentation/usb/WUSB-Design-overview.txt)0
-rw-r--r--MAINTAINERS12
-rw-r--r--drivers/usb/Kconfig2
-rw-r--r--drivers/usb/class/Kconfig2
-rw-r--r--drivers/usb/gadget/Kconfig6
-rw-r--r--drivers/usb/gadget/function/f_mass_storage.c2
-rw-r--r--drivers/usb/gadget/legacy/Kconfig6
-rw-r--r--drivers/usb/host/Kconfig2
-rw-r--r--drivers/usb/misc/Kconfig2
-rw-r--r--drivers/usb/mon/Kconfig2
-rw-r--r--drivers/usb/serial/Kconfig10
-rw-r--r--drivers/usb/serial/belkin_sa.c2
-rw-r--r--drivers/usb/serial/belkin_sa.h2
-rw-r--r--drivers/usb/serial/cypress_m8.c2
-rw-r--r--drivers/usb/serial/empeg.c2
-rw-r--r--drivers/usb/serial/ftdi_sio.c2
-rw-r--r--drivers/usb/serial/ir-usb.c2
-rw-r--r--drivers/usb/serial/keyspan_pda.c2
-rw-r--r--drivers/usb/serial/omninet.c2
-rw-r--r--drivers/usb/serial/oti6858.c2
-rw-r--r--drivers/usb/serial/pl2303.c2
-rw-r--r--drivers/usb/serial/usb-serial.c2
-rw-r--r--drivers/usb/serial/visor.c2
-rw-r--r--drivers/usb/serial/visor.h2
-rw-r--r--drivers/usb/serial/whiteheat.c2
-rw-r--r--drivers/usb/serial/whiteheat.h2
52 files changed, 119 insertions, 40 deletions
diff --git a/Documentation/index.rst b/Documentation/index.rst
index a7566ef62411..91055adde327 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -101,6 +101,7 @@ needed).
101 filesystems/index 101 filesystems/index
102 vm/index 102 vm/index
103 bpf/index 103 bpf/index
104 usb/index
104 misc-devices/index 105 misc-devices/index
105 106
106Architecture-specific documentation 107Architecture-specific documentation
diff --git a/Documentation/index.rst.rej b/Documentation/index.rst.rej
new file mode 100644
index 000000000000..b1af6eab22f3
--- /dev/null
+++ b/Documentation/index.rst.rej
@@ -0,0 +1,10 @@
1--- Documentation/index.rst
2+++ Documentation/index.rst
3@@ -103,6 +103,7 @@ needed).
4 vm/index
5 bpf/index
6 PCI/index
7+ usb/index
8 misc-devices/index
9
10 Architecture-specific documentation
diff --git a/Documentation/usb/acm.txt b/Documentation/usb/acm.rst
index e8bda98e9b51..e8bda98e9b51 100644
--- a/Documentation/usb/acm.txt
+++ b/Documentation/usb/acm.rst
diff --git a/Documentation/usb/authorization.txt b/Documentation/usb/authorization.rst
index 9e53909d04c2..9e53909d04c2 100644
--- a/Documentation/usb/authorization.txt
+++ b/Documentation/usb/authorization.rst
diff --git a/Documentation/usb/chipidea.txt b/Documentation/usb/chipidea.rst
index 68473abe2823..68473abe2823 100644
--- a/Documentation/usb/chipidea.txt
+++ b/Documentation/usb/chipidea.rst
diff --git a/Documentation/usb/dwc3.txt b/Documentation/usb/dwc3.rst
index f94a7ba16573..f94a7ba16573 100644
--- a/Documentation/usb/dwc3.txt
+++ b/Documentation/usb/dwc3.rst
diff --git a/Documentation/usb/ehci.txt b/Documentation/usb/ehci.rst
index 31f650e7c1b4..31f650e7c1b4 100644
--- a/Documentation/usb/ehci.txt
+++ b/Documentation/usb/ehci.rst
diff --git a/Documentation/usb/functionfs.txt b/Documentation/usb/functionfs.rst
index 7fdc6d840ac5..7fdc6d840ac5 100644
--- a/Documentation/usb/functionfs.txt
+++ b/Documentation/usb/functionfs.rst
diff --git a/Documentation/usb/gadget-testing.txt b/Documentation/usb/gadget-testing.rst
index 7d7f2340af42..2eeb3e9299e4 100644
--- a/Documentation/usb/gadget-testing.txt
+++ b/Documentation/usb/gadget-testing.rst
@@ -254,7 +254,7 @@ Device:
254- connect the gadget to a host, preferably not the one used 254- connect the gadget to a host, preferably not the one used
255 to control the gadget 255 to control the gadget
256- run a program which writes to /dev/hidg<N>, e.g. 256- run a program which writes to /dev/hidg<N>, e.g.
257 a userspace program found in Documentation/usb/gadget_hid.txt:: 257 a userspace program found in Documentation/usb/gadget_hid.rst::
258 258
259 $ ./hid_gadget_test /dev/hidg0 keyboard 259 $ ./hid_gadget_test /dev/hidg0 keyboard
260 260
@@ -886,7 +886,7 @@ host::
886 # cat /dev/usb/lp0 886 # cat /dev/usb/lp0
887 887
888More advanced testing can be done with the prn_example 888More advanced testing can be done with the prn_example
889described in Documentation/usb/gadget_printer.txt. 889described in Documentation/usb/gadget_printer.rst.
890 890
891 891
89220. UAC1 function (virtual ALSA card, using u_audio API) 89220. UAC1 function (virtual ALSA card, using u_audio API)
diff --git a/Documentation/usb/gadget_configfs.txt b/Documentation/usb/gadget_configfs.rst
index 54fb08baae22..54fb08baae22 100644
--- a/Documentation/usb/gadget_configfs.txt
+++ b/Documentation/usb/gadget_configfs.rst
diff --git a/Documentation/usb/gadget_hid.txt b/Documentation/usb/gadget_hid.rst
index 098d563040cc..098d563040cc 100644
--- a/Documentation/usb/gadget_hid.txt
+++ b/Documentation/usb/gadget_hid.rst
diff --git a/Documentation/usb/gadget_multi.txt b/Documentation/usb/gadget_multi.rst
index 9806b55af301..9806b55af301 100644
--- a/Documentation/usb/gadget_multi.txt
+++ b/Documentation/usb/gadget_multi.rst
diff --git a/Documentation/usb/gadget_printer.txt b/Documentation/usb/gadget_printer.rst
index 5e5516c69075..5e5516c69075 100644
--- a/Documentation/usb/gadget_printer.txt
+++ b/Documentation/usb/gadget_printer.rst
diff --git a/Documentation/usb/gadget_serial.txt b/Documentation/usb/gadget_serial.rst
index dce8bc1fb1f2..dce8bc1fb1f2 100644
--- a/Documentation/usb/gadget_serial.txt
+++ b/Documentation/usb/gadget_serial.rst
diff --git a/Documentation/usb/index.rst b/Documentation/usb/index.rst
new file mode 100644
index 000000000000..e55386a4abfb
--- /dev/null
+++ b/Documentation/usb/index.rst
@@ -0,0 +1,39 @@
1===========
2USB support
3===========
4
5.. toctree::
6 :maxdepth: 1
7
8 acm
9 authorization
10 chipidea
11 dwc3
12 ehci
13 functionfs
14 gadget_configfs
15 gadget_hid
16 gadget_multi
17 gadget_printer
18 gadget_serial
19 gadget-testing
20 iuu_phoenix
21 mass-storage
22 misc_usbsevseg
23 mtouchusb
24 ohci
25 rio
26 usbip_protocol
27 usbmon
28 usb-serial
29 wusb-design-overview
30
31 usb-help
32 text_files
33
34.. only:: subproject and html
35
36 Indices
37 =======
38
39 * :ref:`genindex`
diff --git a/Documentation/usb/iuu_phoenix.txt b/Documentation/usb/iuu_phoenix.rst
index b76268728450..b76268728450 100644
--- a/Documentation/usb/iuu_phoenix.txt
+++ b/Documentation/usb/iuu_phoenix.rst
diff --git a/Documentation/usb/mass-storage.txt b/Documentation/usb/mass-storage.rst
index d181b47c3cb6..d181b47c3cb6 100644
--- a/Documentation/usb/mass-storage.txt
+++ b/Documentation/usb/mass-storage.rst
diff --git a/Documentation/usb/misc_usbsevseg.txt b/Documentation/usb/misc_usbsevseg.rst
index 6274aee083ed..6274aee083ed 100644
--- a/Documentation/usb/misc_usbsevseg.txt
+++ b/Documentation/usb/misc_usbsevseg.rst
diff --git a/Documentation/usb/mtouchusb.txt b/Documentation/usb/mtouchusb.rst
index d1111b74bf75..d1111b74bf75 100644
--- a/Documentation/usb/mtouchusb.txt
+++ b/Documentation/usb/mtouchusb.rst
diff --git a/Documentation/usb/ohci.txt b/Documentation/usb/ohci.rst
index bb3c49719e6b..bb3c49719e6b 100644
--- a/Documentation/usb/ohci.txt
+++ b/Documentation/usb/ohci.rst
diff --git a/Documentation/usb/rio.txt b/Documentation/usb/rio.rst
index ea73475471db..ea73475471db 100644
--- a/Documentation/usb/rio.txt
+++ b/Documentation/usb/rio.rst
diff --git a/Documentation/usb/text_files.rst b/Documentation/usb/text_files.rst
new file mode 100644
index 000000000000..6a8d3fcf64b6
--- /dev/null
+++ b/Documentation/usb/text_files.rst
@@ -0,0 +1,29 @@
1Linux CDC ACM inf
2-----------------
3
4.. include:: linux-cdc-acm.inf
5 :literal:
6
7Linux inf
8---------
9
10.. include:: linux.inf
11 :literal:
12
13USB devfs drop permissions source
14---------------------------------
15
16.. literalinclude:: usbdevfs-drop-permissions.c
17 :language: c
18
19WUSB command line script to manipulate auth credentials
20-------------------------------------------------------
21
22.. literalinclude:: wusb-cbaf
23 :language: shell
24
25Credits
26-------
27
28.. include:: CREDITS
29 :literal:
diff --git a/Documentation/usb/usb-help.txt b/Documentation/usb/usb-help.rst
index dc23ecd4d802..dc23ecd4d802 100644
--- a/Documentation/usb/usb-help.txt
+++ b/Documentation/usb/usb-help.rst
diff --git a/Documentation/usb/usb-serial.txt b/Documentation/usb/usb-serial.rst
index 8fa7dbd3da9a..8fa7dbd3da9a 100644
--- a/Documentation/usb/usb-serial.txt
+++ b/Documentation/usb/usb-serial.rst
diff --git a/Documentation/usb/usbip_protocol.txt b/Documentation/usb/usbip_protocol.rst
index 988c832166cd..988c832166cd 100644
--- a/Documentation/usb/usbip_protocol.txt
+++ b/Documentation/usb/usbip_protocol.rst
diff --git a/Documentation/usb/usbmon.txt b/Documentation/usb/usbmon.rst
index b0bd51080799..b0bd51080799 100644
--- a/Documentation/usb/usbmon.txt
+++ b/Documentation/usb/usbmon.rst
diff --git a/Documentation/usb/WUSB-Design-overview.txt b/Documentation/usb/wusb-design-overview.rst
index dc5e21609bb5..dc5e21609bb5 100644
--- a/Documentation/usb/WUSB-Design-overview.txt
+++ b/Documentation/usb/wusb-design-overview.rst
diff --git a/MAINTAINERS b/MAINTAINERS
index 57f496cff999..8e9d6ea73c35 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -3751,7 +3751,7 @@ F: scripts/extract-cert.c
3751CERTIFIED WIRELESS USB (WUSB) SUBSYSTEM: 3751CERTIFIED WIRELESS USB (WUSB) SUBSYSTEM:
3752L: linux-usb@vger.kernel.org 3752L: linux-usb@vger.kernel.org
3753S: Orphan 3753S: Orphan
3754F: Documentation/usb/WUSB-Design-overview.txt 3754F: Documentation/usb/wusb-design-overview.rst
3755F: Documentation/usb/wusb-cbaf 3755F: Documentation/usb/wusb-cbaf
3756F: drivers/usb/host/hwa-hc.c 3756F: drivers/usb/host/hwa-hc.c
3757F: drivers/usb/host/whci/ 3757F: drivers/usb/host/whci/
@@ -16238,7 +16238,7 @@ USB ACM DRIVER
16238M: Oliver Neukum <oneukum@suse.com> 16238M: Oliver Neukum <oneukum@suse.com>
16239L: linux-usb@vger.kernel.org 16239L: linux-usb@vger.kernel.org
16240S: Maintained 16240S: Maintained
16241F: Documentation/usb/acm.txt 16241F: Documentation/usb/acm.rst
16242F: drivers/usb/class/cdc-acm.* 16242F: drivers/usb/class/cdc-acm.*
16243 16243
16244USB AR5523 WIRELESS DRIVER 16244USB AR5523 WIRELESS DRIVER
@@ -16291,7 +16291,7 @@ USB EHCI DRIVER
16291M: Alan Stern <stern@rowland.harvard.edu> 16291M: Alan Stern <stern@rowland.harvard.edu>
16292L: linux-usb@vger.kernel.org 16292L: linux-usb@vger.kernel.org
16293S: Maintained 16293S: Maintained
16294F: Documentation/usb/ehci.txt 16294F: Documentation/usb/ehci.rst
16295F: drivers/usb/host/ehci* 16295F: drivers/usb/host/ehci*
16296 16296
16297USB GADGET/PERIPHERAL SUBSYSTEM 16297USB GADGET/PERIPHERAL SUBSYSTEM
@@ -16365,7 +16365,7 @@ USB OHCI DRIVER
16365M: Alan Stern <stern@rowland.harvard.edu> 16365M: Alan Stern <stern@rowland.harvard.edu>
16366L: linux-usb@vger.kernel.org 16366L: linux-usb@vger.kernel.org
16367S: Maintained 16367S: Maintained
16368F: Documentation/usb/ohci.txt 16368F: Documentation/usb/ohci.rst
16369F: drivers/usb/host/ohci* 16369F: drivers/usb/host/ohci*
16370 16370
16371USB OTG FSM (Finite State Machine) 16371USB OTG FSM (Finite State Machine)
@@ -16381,7 +16381,7 @@ M: Shuah Khan <shuah@kernel.org>
16381M: Shuah Khan <skhan@linuxfoundation.org> 16381M: Shuah Khan <skhan@linuxfoundation.org>
16382L: linux-usb@vger.kernel.org 16382L: linux-usb@vger.kernel.org
16383S: Maintained 16383S: Maintained
16384F: Documentation/usb/usbip_protocol.txt 16384F: Documentation/usb/usbip_protocol.rst
16385F: drivers/usb/usbip/ 16385F: drivers/usb/usbip/
16386F: tools/usb/usbip/ 16386F: tools/usb/usbip/
16387F: tools/testing/selftests/drivers/usb/usbip/ 16387F: tools/testing/selftests/drivers/usb/usbip/
@@ -16429,7 +16429,7 @@ M: Johan Hovold <johan@kernel.org>
16429L: linux-usb@vger.kernel.org 16429L: linux-usb@vger.kernel.org
16430T: git git://git.kernel.org/pub/scm/linux/kernel/git/johan/usb-serial.git 16430T: git git://git.kernel.org/pub/scm/linux/kernel/git/johan/usb-serial.git
16431S: Maintained 16431S: Maintained
16432F: Documentation/usb/usb-serial.txt 16432F: Documentation/usb/usb-serial.rst
16433F: drivers/usb/serial/ 16433F: drivers/usb/serial/
16434F: include/linux/usb/serial.h 16434F: include/linux/usb/serial.h
16435 16435
diff --git a/drivers/usb/Kconfig b/drivers/usb/Kconfig
index e4b27413f528..94573fb68304 100644
--- a/drivers/usb/Kconfig
+++ b/drivers/usb/Kconfig
@@ -74,7 +74,7 @@ config USB
74 After choosing your HCD, then select drivers for the USB peripherals 74 After choosing your HCD, then select drivers for the USB peripherals
75 you'll be using. You may want to check out the information provided 75 you'll be using. You may want to check out the information provided
76 in <file:Documentation/usb/> and especially the links given in 76 in <file:Documentation/usb/> and especially the links given in
77 <file:Documentation/usb/usb-help.txt>. 77 <file:Documentation/usb/usb-help.rst>.
78 78
79 To compile this driver as a module, choose M here: the 79 To compile this driver as a module, choose M here: the
80 module will be called usbcore. 80 module will be called usbcore.
diff --git a/drivers/usb/class/Kconfig b/drivers/usb/class/Kconfig
index 52f3a531a82f..f8a798900093 100644
--- a/drivers/usb/class/Kconfig
+++ b/drivers/usb/class/Kconfig
@@ -10,7 +10,7 @@ config USB_ACM
10 ---help--- 10 ---help---
11 This driver supports USB modems and ISDN adapters which support the 11 This driver supports USB modems and ISDN adapters which support the
12 Communication Device Class Abstract Control Model interface. 12 Communication Device Class Abstract Control Model interface.
13 Please read <file:Documentation/usb/acm.txt> for details. 13 Please read <file:Documentation/usb/acm.rst> for details.
14 14
15 If your modem only reports "Cls=ff(vend.)" in the descriptors in 15 If your modem only reports "Cls=ff(vend.)" in the descriptors in
16 /sys/kernel/debug/usb/devices, then your modem will not work with this 16 /sys/kernel/debug/usb/devices, then your modem will not work with this
diff --git a/drivers/usb/gadget/Kconfig b/drivers/usb/gadget/Kconfig
index ec189d7855a0..02ff850278b1 100644
--- a/drivers/usb/gadget/Kconfig
+++ b/drivers/usb/gadget/Kconfig
@@ -228,7 +228,7 @@ config USB_CONFIGFS
228 specified simply by creating appropriate directories in configfs. 228 specified simply by creating appropriate directories in configfs.
229 Associating functions with configurations is done by creating 229 Associating functions with configurations is done by creating
230 appropriate symbolic links. 230 appropriate symbolic links.
231 For more information see Documentation/usb/gadget_configfs.txt. 231 For more information see Documentation/usb/gadget_configfs.rst.
232 232
233config USB_CONFIGFS_SERIAL 233config USB_CONFIGFS_SERIAL
234 bool "Generic serial bulk in/out" 234 bool "Generic serial bulk in/out"
@@ -441,7 +441,7 @@ config USB_CONFIGFS_F_HID
441 The HID function driver provides generic emulation of USB 441 The HID function driver provides generic emulation of USB
442 Human Interface Devices (HID). 442 Human Interface Devices (HID).
443 443
444 For more information, see Documentation/usb/gadget_hid.txt. 444 For more information, see Documentation/usb/gadget_hid.rst.
445 445
446config USB_CONFIGFS_F_UVC 446config USB_CONFIGFS_F_UVC
447 bool "USB Webcam function" 447 bool "USB Webcam function"
@@ -466,7 +466,7 @@ config USB_CONFIGFS_F_PRINTER
466 receive or send printer data. It can use ioctl calls to 466 receive or send printer data. It can use ioctl calls to
467 the device file to get or set printer status. 467 the device file to get or set printer status.
468 468
469 For more information, see Documentation/usb/gadget_printer.txt 469 For more information, see Documentation/usb/gadget_printer.rst
470 which includes sample code for accessing the device file. 470 which includes sample code for accessing the device file.
471 471
472config USB_CONFIGFS_F_TCM 472config USB_CONFIGFS_F_TCM
diff --git a/drivers/usb/gadget/function/f_mass_storage.c b/drivers/usb/gadget/function/f_mass_storage.c
index 043f97ad8f22..29cc5693e05c 100644
--- a/drivers/usb/gadget/function/f_mass_storage.c
+++ b/drivers/usb/gadget/function/f_mass_storage.c
@@ -47,7 +47,7 @@
47 * 47 *
48 * For more information about MSF and in particular its module 48 * For more information about MSF and in particular its module
49 * parameters and sysfs interface read the 49 * parameters and sysfs interface read the
50 * <Documentation/usb/mass-storage.txt> file. 50 * <Documentation/usb/mass-storage.rst> file.
51 */ 51 */
52 52
53/* 53/*
diff --git a/drivers/usb/gadget/legacy/Kconfig b/drivers/usb/gadget/legacy/Kconfig
index 94fc3c462930..69ff7f8c86f5 100644
--- a/drivers/usb/gadget/legacy/Kconfig
+++ b/drivers/usb/gadget/legacy/Kconfig
@@ -287,7 +287,7 @@ config USB_G_SERIAL
287 Say "y" to link the driver statically, or "m" to build a 287 Say "y" to link the driver statically, or "m" to build a
288 dynamically linked module called "g_serial". 288 dynamically linked module called "g_serial".
289 289
290 For more information, see Documentation/usb/gadget_serial.txt 290 For more information, see Documentation/usb/gadget_serial.rst
291 which includes instructions and a "driver info file" needed to 291 which includes instructions and a "driver info file" needed to
292 make MS-Windows work with CDC ACM. 292 make MS-Windows work with CDC ACM.
293 293
@@ -321,7 +321,7 @@ config USB_G_PRINTER
321 Say "y" to link the driver statically, or "m" to build a 321 Say "y" to link the driver statically, or "m" to build a
322 dynamically linked module called "g_printer". 322 dynamically linked module called "g_printer".
323 323
324 For more information, see Documentation/usb/gadget_printer.txt 324 For more information, see Documentation/usb/gadget_printer.rst
325 which includes sample code for accessing the device file. 325 which includes sample code for accessing the device file.
326 326
327if TTY 327if TTY
@@ -436,7 +436,7 @@ config USB_G_HID
436 The HID gadget driver provides generic emulation of USB 436 The HID gadget driver provides generic emulation of USB
437 Human Interface Devices (HID). 437 Human Interface Devices (HID).
438 438
439 For more information, see Documentation/usb/gadget_hid.txt which 439 For more information, see Documentation/usb/gadget_hid.rst which
440 includes sample code for accessing the device files. 440 includes sample code for accessing the device files.
441 441
442 Say "y" to link the driver statically, or "m" to build a 442 Say "y" to link the driver statically, or "m" to build a
diff --git a/drivers/usb/host/Kconfig b/drivers/usb/host/Kconfig
index fb3406ea8592..40b5de597112 100644
--- a/drivers/usb/host/Kconfig
+++ b/drivers/usb/host/Kconfig
@@ -114,7 +114,7 @@ config USB_EHCI_HCD
114 Controller Driver or UHCI (for Via motherboards) Host Controller 114 Controller Driver or UHCI (for Via motherboards) Host Controller
115 Driver too. 115 Driver too.
116 116
117 You may want to read <file:Documentation/usb/ehci.txt>. 117 You may want to read <file:Documentation/usb/ehci.rst>.
118 118
119 To compile this driver as a module, choose M here: the 119 To compile this driver as a module, choose M here: the
120 module will be called ehci-hcd. 120 module will be called ehci-hcd.
diff --git a/drivers/usb/misc/Kconfig b/drivers/usb/misc/Kconfig
index c97f270338bf..a829cd0ef5f3 100644
--- a/drivers/usb/misc/Kconfig
+++ b/drivers/usb/misc/Kconfig
@@ -51,7 +51,7 @@ config USB_RIO500
51 tristate "USB Diamond Rio500 support" 51 tristate "USB Diamond Rio500 support"
52 help 52 help
53 Say Y here if you want to connect a USB Rio500 mp3 player to your 53 Say Y here if you want to connect a USB Rio500 mp3 player to your
54 computer's USB port. Please read <file:Documentation/usb/rio.txt> 54 computer's USB port. Please read <file:Documentation/usb/rio.rst>
55 for more information. 55 for more information.
56 56
57 To compile this driver as a module, choose M here: the 57 To compile this driver as a module, choose M here: the
diff --git a/drivers/usb/mon/Kconfig b/drivers/usb/mon/Kconfig
index 48f1b2dadb24..ffc7cd422874 100644
--- a/drivers/usb/mon/Kconfig
+++ b/drivers/usb/mon/Kconfig
@@ -8,6 +8,6 @@ config USB_MON
8 help 8 help
9 If you select this option, a component which captures the USB traffic 9 If you select this option, a component which captures the USB traffic
10 between peripheral-specific drivers and HC drivers will be built. 10 between peripheral-specific drivers and HC drivers will be built.
11 For more information, see <file:Documentation/usb/usbmon.txt>. 11 For more information, see <file:Documentation/usb/usbmon.rst>.
12 12
13 If unsure, say Y, if allowed, otherwise M. 13 If unsure, say Y, if allowed, otherwise M.
diff --git a/drivers/usb/serial/Kconfig b/drivers/usb/serial/Kconfig
index 7d031911d04e..67279c6bce33 100644
--- a/drivers/usb/serial/Kconfig
+++ b/drivers/usb/serial/Kconfig
@@ -11,7 +11,7 @@ menuconfig USB_SERIAL
11 ports, or acts like a serial device, and you want to connect it to 11 ports, or acts like a serial device, and you want to connect it to
12 your USB bus. 12 your USB bus.
13 13
14 Please read <file:Documentation/usb/usb-serial.txt> for more 14 Please read <file:Documentation/usb/usb-serial.rst> for more
15 information on the specifics of the different devices that are 15 information on the specifics of the different devices that are
16 supported, and on how to use them. 16 supported, and on how to use them.
17 17
@@ -47,7 +47,7 @@ config USB_SERIAL_GENERIC
47 bool "USB Generic Serial Driver" 47 bool "USB Generic Serial Driver"
48 help 48 help
49 Say Y here if you want to use the generic USB serial driver. Please 49 Say Y here if you want to use the generic USB serial driver. Please
50 read <file:Documentation/usb/usb-serial.txt> for more information on 50 read <file:Documentation/usb/usb-serial.rst> for more information on
51 using this driver. It is recommended that the "USB Serial converter 51 using this driver. It is recommended that the "USB Serial converter
52 support" be compiled as a module for this driver to be used 52 support" be compiled as a module for this driver to be used
53 properly. 53 properly.
@@ -163,7 +163,7 @@ config USB_SERIAL_EMPEG
163 help 163 help
164 Say Y here if you want to connect to your Empeg empeg-car Mark I/II 164 Say Y here if you want to connect to your Empeg empeg-car Mark I/II
165 mp3 player via USB. The driver uses a single ttyUSB{0,1,2,...} 165 mp3 player via USB. The driver uses a single ttyUSB{0,1,2,...}
166 device node. See <file:Documentation/usb/usb-serial.txt> for more 166 device node. See <file:Documentation/usb/usb-serial.rst> for more
167 tidbits of information. 167 tidbits of information.
168 168
169 To compile this driver as a module, choose M here: the 169 To compile this driver as a module, choose M here: the
@@ -199,7 +199,7 @@ config USB_SERIAL_IPAQ
199 Say Y here if you want to connect to your Compaq iPAQ, HP Jornada 199 Say Y here if you want to connect to your Compaq iPAQ, HP Jornada
200 or any other PDA running Windows CE 3.0 or PocketPC 2002 200 or any other PDA running Windows CE 3.0 or PocketPC 2002
201 using a USB cradle/cable. For information on using the driver, 201 using a USB cradle/cable. For information on using the driver,
202 read <file:Documentation/usb/usb-serial.txt>. 202 read <file:Documentation/usb/usb-serial.rst>.
203 203
204 To compile this driver as a module, choose M here: the 204 To compile this driver as a module, choose M here: the
205 module will be called ipaq. 205 module will be called ipaq.
@@ -334,7 +334,7 @@ config USB_SERIAL_KLSI
334 adapter sold by Palm Inc. for use with their Palm III and Palm V 334 adapter sold by Palm Inc. for use with their Palm III and Palm V
335 series PDAs. 335 series PDAs.
336 336
337 Please read <file:Documentation/usb/usb-serial.txt> for more 337 Please read <file:Documentation/usb/usb-serial.rst> for more
338 information. 338 information.
339 339
340 To compile this driver as a module, choose M here: the 340 To compile this driver as a module, choose M here: the
diff --git a/drivers/usb/serial/belkin_sa.c b/drivers/usb/serial/belkin_sa.c
index c1235d5b9fba..9bb123ab9bc9 100644
--- a/drivers/usb/serial/belkin_sa.c
+++ b/drivers/usb/serial/belkin_sa.c
@@ -10,7 +10,7 @@
10 * and associated source files. Please see the usb/serial files for 10 * and associated source files. Please see the usb/serial files for
11 * individual credits and copyrights. 11 * individual credits and copyrights.
12 * 12 *
13 * See Documentation/usb/usb-serial.txt for more information on using this 13 * See Documentation/usb/usb-serial.rst for more information on using this
14 * driver 14 * driver
15 * 15 *
16 * TODO: 16 * TODO:
diff --git a/drivers/usb/serial/belkin_sa.h b/drivers/usb/serial/belkin_sa.h
index 51bc06287603..a13a98d284f2 100644
--- a/drivers/usb/serial/belkin_sa.h
+++ b/drivers/usb/serial/belkin_sa.h
@@ -9,7 +9,7 @@
9 * and associated source files. Please see the usb/serial files for 9 * and associated source files. Please see the usb/serial files for
10 * individual credits and copyrights. 10 * individual credits and copyrights.
11 * 11 *
12 * See Documentation/usb/usb-serial.txt for more information on using this 12 * See Documentation/usb/usb-serial.rst for more information on using this
13 * driver 13 * driver
14 * 14 *
15 * 12-Mar-2001 gkh 15 * 12-Mar-2001 gkh
diff --git a/drivers/usb/serial/cypress_m8.c b/drivers/usb/serial/cypress_m8.c
index 72d3ae1ebc64..216edd5826ca 100644
--- a/drivers/usb/serial/cypress_m8.c
+++ b/drivers/usb/serial/cypress_m8.c
@@ -7,7 +7,7 @@
7 * Copyright (C) 2003,2004 7 * Copyright (C) 2003,2004
8 * Neil Whelchel (koyama@firstlight.net) 8 * Neil Whelchel (koyama@firstlight.net)
9 * 9 *
10 * See Documentation/usb/usb-serial.txt for more information on using this 10 * See Documentation/usb/usb-serial.rst for more information on using this
11 * driver 11 * driver
12 * 12 *
13 * See http://geocities.com/i0xox0i for information on this driver and the 13 * See http://geocities.com/i0xox0i for information on this driver and the
diff --git a/drivers/usb/serial/empeg.c b/drivers/usb/serial/empeg.c
index d680bec62547..405e835e93dd 100644
--- a/drivers/usb/serial/empeg.c
+++ b/drivers/usb/serial/empeg.c
@@ -8,7 +8,7 @@
8 * Copyright (C) 1999 - 2001 8 * Copyright (C) 1999 - 2001
9 * Greg Kroah-Hartman (greg@kroah.com) 9 * Greg Kroah-Hartman (greg@kroah.com)
10 * 10 *
11 * See Documentation/usb/usb-serial.txt for more information on using this 11 * See Documentation/usb/usb-serial.rst for more information on using this
12 * driver 12 * driver
13 */ 13 */
14 14
diff --git a/drivers/usb/serial/ftdi_sio.c b/drivers/usb/serial/ftdi_sio.c
index 1d8461ae2c34..8b15bbf545d4 100644
--- a/drivers/usb/serial/ftdi_sio.c
+++ b/drivers/usb/serial/ftdi_sio.c
@@ -10,7 +10,7 @@
10 * Copyright (C) 2002 10 * Copyright (C) 2002
11 * Kuba Ober (kuba@mareimbrium.org) 11 * Kuba Ober (kuba@mareimbrium.org)
12 * 12 *
13 * See Documentation/usb/usb-serial.txt for more information on using this 13 * See Documentation/usb/usb-serial.rst for more information on using this
14 * driver 14 * driver
15 * 15 *
16 * See http://ftdi-usb-sio.sourceforge.net for up to date testing info 16 * See http://ftdi-usb-sio.sourceforge.net for up to date testing info
diff --git a/drivers/usb/serial/ir-usb.c b/drivers/usb/serial/ir-usb.c
index 7643716b5299..302eb9530859 100644
--- a/drivers/usb/serial/ir-usb.c
+++ b/drivers/usb/serial/ir-usb.c
@@ -16,7 +16,7 @@
16 * was written by Roman Weissgaerber <weissg@vienna.at>, Dag Brattli 16 * was written by Roman Weissgaerber <weissg@vienna.at>, Dag Brattli
17 * <dag@brattli.net>, and Jean Tourrilhes <jt@hpl.hp.com> 17 * <dag@brattli.net>, and Jean Tourrilhes <jt@hpl.hp.com>
18 * 18 *
19 * See Documentation/usb/usb-serial.txt for more information on using this 19 * See Documentation/usb/usb-serial.rst for more information on using this
20 * driver 20 * driver
21 */ 21 */
22 22
diff --git a/drivers/usb/serial/keyspan_pda.c b/drivers/usb/serial/keyspan_pda.c
index 38d43c4b7ce5..bf988f77d400 100644
--- a/drivers/usb/serial/keyspan_pda.c
+++ b/drivers/usb/serial/keyspan_pda.c
@@ -6,7 +6,7 @@
6 * Copyright (C) 1999, 2000 Brian Warner <warner@lothar.com> 6 * Copyright (C) 1999, 2000 Brian Warner <warner@lothar.com>
7 * Copyright (C) 2000 Al Borchers <borchers@steinerpoint.com> 7 * Copyright (C) 2000 Al Borchers <borchers@steinerpoint.com>
8 * 8 *
9 * See Documentation/usb/usb-serial.txt for more information on using this 9 * See Documentation/usb/usb-serial.rst for more information on using this
10 * driver 10 * driver
11 */ 11 */
12 12
diff --git a/drivers/usb/serial/omninet.c b/drivers/usb/serial/omninet.c
index e51c9464ea42..5b6e982a9376 100644
--- a/drivers/usb/serial/omninet.c
+++ b/drivers/usb/serial/omninet.c
@@ -4,7 +4,7 @@
4 * 4 *
5 * Copyright (C) 2013,2017 Johan Hovold <johan@kernel.org> 5 * Copyright (C) 2013,2017 Johan Hovold <johan@kernel.org>
6 * 6 *
7 * See Documentation/usb/usb-serial.txt for more information on using this 7 * See Documentation/usb/usb-serial.rst for more information on using this
8 * driver 8 * driver
9 * 9 *
10 * Please report both successes and troubles to the author at omninet@kroah.com 10 * Please report both successes and troubles to the author at omninet@kroah.com
diff --git a/drivers/usb/serial/oti6858.c b/drivers/usb/serial/oti6858.c
index 38ae0fc826cc..8151dd7a45e8 100644
--- a/drivers/usb/serial/oti6858.c
+++ b/drivers/usb/serial/oti6858.c
@@ -22,7 +22,7 @@
22 * So, THIS CODE CAN DESTROY OTi-6858 AND ANY OTHER DEVICES, THAT ARE 22 * So, THIS CODE CAN DESTROY OTi-6858 AND ANY OTHER DEVICES, THAT ARE
23 * CONNECTED TO IT! 23 * CONNECTED TO IT!
24 * 24 *
25 * See Documentation/usb/usb-serial.txt for more information on using this 25 * See Documentation/usb/usb-serial.rst for more information on using this
26 * driver 26 * driver
27 * 27 *
28 * TODO: 28 * TODO:
diff --git a/drivers/usb/serial/pl2303.c b/drivers/usb/serial/pl2303.c
index d7abde14b3cf..9d27b76c5c6e 100644
--- a/drivers/usb/serial/pl2303.c
+++ b/drivers/usb/serial/pl2303.c
@@ -7,7 +7,7 @@
7 * 7 *
8 * Original driver for 2.2.x by anonymous 8 * Original driver for 2.2.x by anonymous
9 * 9 *
10 * See Documentation/usb/usb-serial.txt for more information on using this 10 * See Documentation/usb/usb-serial.rst for more information on using this
11 * driver 11 * driver
12 */ 12 */
13 13
diff --git a/drivers/usb/serial/usb-serial.c b/drivers/usb/serial/usb-serial.c
index 676c296103a2..a3179fea38c8 100644
--- a/drivers/usb/serial/usb-serial.c
+++ b/drivers/usb/serial/usb-serial.c
@@ -10,7 +10,7 @@
10 * This driver was originally based on the ACM driver by Armin Fuerst (which was 10 * This driver was originally based on the ACM driver by Armin Fuerst (which was
11 * based on a driver by Brad Keryan) 11 * based on a driver by Brad Keryan)
12 * 12 *
13 * See Documentation/usb/usb-serial.txt for more information on using this 13 * See Documentation/usb/usb-serial.rst for more information on using this
14 * driver 14 * driver
15 */ 15 */
16 16
diff --git a/drivers/usb/serial/visor.c b/drivers/usb/serial/visor.c
index 8ddbecc25d89..4412834db21c 100644
--- a/drivers/usb/serial/visor.c
+++ b/drivers/usb/serial/visor.c
@@ -6,7 +6,7 @@
6 * Copyright (C) 1999 - 2004 6 * Copyright (C) 1999 - 2004
7 * Greg Kroah-Hartman (greg@kroah.com) 7 * Greg Kroah-Hartman (greg@kroah.com)
8 * 8 *
9 * See Documentation/usb/usb-serial.txt for more information on using this 9 * See Documentation/usb/usb-serial.rst for more information on using this
10 * driver 10 * driver
11 * 11 *
12 */ 12 */
diff --git a/drivers/usb/serial/visor.h b/drivers/usb/serial/visor.h
index fe290243f1ce..4bd69d047036 100644
--- a/drivers/usb/serial/visor.h
+++ b/drivers/usb/serial/visor.h
@@ -5,7 +5,7 @@
5 * Copyright (C) 1999 - 2003 5 * Copyright (C) 1999 - 2003
6 * Greg Kroah-Hartman (greg@kroah.com) 6 * Greg Kroah-Hartman (greg@kroah.com)
7 * 7 *
8 * See Documentation/usb/usb-serial.txt for more information on using this 8 * See Documentation/usb/usb-serial.rst for more information on using this
9 * driver. 9 * driver.
10 * 10 *
11 */ 11 */
diff --git a/drivers/usb/serial/whiteheat.c b/drivers/usb/serial/whiteheat.c
index aefd84f88b59..79314d8c94a4 100644
--- a/drivers/usb/serial/whiteheat.c
+++ b/drivers/usb/serial/whiteheat.c
@@ -8,7 +8,7 @@
8 * Copyright (C) 1999 - 2001 8 * Copyright (C) 1999 - 2001
9 * Greg Kroah-Hartman (greg@kroah.com) 9 * Greg Kroah-Hartman (greg@kroah.com)
10 * 10 *
11 * See Documentation/usb/usb-serial.txt for more information on using this 11 * See Documentation/usb/usb-serial.rst for more information on using this
12 * driver 12 * driver
13 */ 13 */
14 14
diff --git a/drivers/usb/serial/whiteheat.h b/drivers/usb/serial/whiteheat.h
index 72c1b0cf4063..00398149cd8d 100644
--- a/drivers/usb/serial/whiteheat.h
+++ b/drivers/usb/serial/whiteheat.h
@@ -8,7 +8,7 @@
8 * Copyright (C) 1999, 2000 8 * Copyright (C) 1999, 2000
9 * Greg Kroah-Hartman (greg@kroah.com) 9 * Greg Kroah-Hartman (greg@kroah.com)
10 * 10 *
11 * See Documentation/usb/usb-serial.txt for more information on using this 11 * See Documentation/usb/usb-serial.rst for more information on using this
12 * driver 12 * driver
13 * 13 *
14 */ 14 */