docs: usb: rename files to .rst and add them to drivers-api
authorMauro Carvalho Chehab <mchehab+samsung@kernel.org>
Tue, 18 Jun 2019 21:05:38 +0000 (18:05 -0300)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Thu, 20 Jun 2019 12:28:36 +0000 (14:28 +0200)
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>
52 files changed:
Documentation/index.rst
Documentation/index.rst.rej [new file with mode: 0644]
Documentation/usb/acm.rst [moved from Documentation/usb/acm.txt with 100% similarity]
Documentation/usb/authorization.rst [moved from Documentation/usb/authorization.txt with 100% similarity]
Documentation/usb/chipidea.rst [moved from Documentation/usb/chipidea.txt with 100% similarity]
Documentation/usb/dwc3.rst [moved from Documentation/usb/dwc3.txt with 100% similarity]
Documentation/usb/ehci.rst [moved from Documentation/usb/ehci.txt with 100% similarity]
Documentation/usb/functionfs.rst [moved from Documentation/usb/functionfs.txt with 100% similarity]
Documentation/usb/gadget-testing.rst [moved from Documentation/usb/gadget-testing.txt with 99% similarity]
Documentation/usb/gadget_configfs.rst [moved from Documentation/usb/gadget_configfs.txt with 100% similarity]
Documentation/usb/gadget_hid.rst [moved from Documentation/usb/gadget_hid.txt with 100% similarity]
Documentation/usb/gadget_multi.rst [moved from Documentation/usb/gadget_multi.txt with 100% similarity]
Documentation/usb/gadget_printer.rst [moved from Documentation/usb/gadget_printer.txt with 100% similarity]
Documentation/usb/gadget_serial.rst [moved from Documentation/usb/gadget_serial.txt with 100% similarity]
Documentation/usb/index.rst [new file with mode: 0644]
Documentation/usb/iuu_phoenix.rst [moved from Documentation/usb/iuu_phoenix.txt with 100% similarity]
Documentation/usb/mass-storage.rst [moved from Documentation/usb/mass-storage.txt with 100% similarity]
Documentation/usb/misc_usbsevseg.rst [moved from Documentation/usb/misc_usbsevseg.txt with 100% similarity]
Documentation/usb/mtouchusb.rst [moved from Documentation/usb/mtouchusb.txt with 100% similarity]
Documentation/usb/ohci.rst [moved from Documentation/usb/ohci.txt with 100% similarity]
Documentation/usb/rio.rst [moved from Documentation/usb/rio.txt with 100% similarity]
Documentation/usb/text_files.rst [new file with mode: 0644]
Documentation/usb/usb-help.rst [moved from Documentation/usb/usb-help.txt with 100% similarity]
Documentation/usb/usb-serial.rst [moved from Documentation/usb/usb-serial.txt with 100% similarity]
Documentation/usb/usbip_protocol.rst [moved from Documentation/usb/usbip_protocol.txt with 100% similarity]
Documentation/usb/usbmon.rst [moved from Documentation/usb/usbmon.txt with 100% similarity]
Documentation/usb/wusb-design-overview.rst [moved from Documentation/usb/WUSB-Design-overview.txt with 100% similarity]
MAINTAINERS
drivers/usb/Kconfig
drivers/usb/class/Kconfig
drivers/usb/gadget/Kconfig
drivers/usb/gadget/function/f_mass_storage.c
drivers/usb/gadget/legacy/Kconfig
drivers/usb/host/Kconfig
drivers/usb/misc/Kconfig
drivers/usb/mon/Kconfig
drivers/usb/serial/Kconfig
drivers/usb/serial/belkin_sa.c
drivers/usb/serial/belkin_sa.h
drivers/usb/serial/cypress_m8.c
drivers/usb/serial/empeg.c
drivers/usb/serial/ftdi_sio.c
drivers/usb/serial/ir-usb.c
drivers/usb/serial/keyspan_pda.c
drivers/usb/serial/omninet.c
drivers/usb/serial/oti6858.c
drivers/usb/serial/pl2303.c
drivers/usb/serial/usb-serial.c
drivers/usb/serial/visor.c
drivers/usb/serial/visor.h
drivers/usb/serial/whiteheat.c
drivers/usb/serial/whiteheat.h

index a7566ef..91055ad 100644 (file)
@@ -101,6 +101,7 @@ needed).
    filesystems/index
    vm/index
    bpf/index
+   usb/index
    misc-devices/index
 
 Architecture-specific documentation
diff --git a/Documentation/index.rst.rej b/Documentation/index.rst.rej
new file mode 100644 (file)
index 0000000..b1af6ea
--- /dev/null
@@ -0,0 +1,10 @@
+--- Documentation/index.rst
++++ Documentation/index.rst
+@@ -103,6 +103,7 @@ needed).
+    vm/index
+    bpf/index
+    PCI/index
++   usb/index
+    misc-devices/index
+ Architecture-specific documentation
similarity index 99%
rename from Documentation/usb/gadget-testing.txt
rename to Documentation/usb/gadget-testing.rst
index 7d7f234..2eeb3e9 100644 (file)
@@ -254,7 +254,7 @@ Device:
 - connect the gadget to a host, preferably not the one used
   to control the gadget
 - run a program which writes to /dev/hidg<N>, e.g.
-  a userspace program found in Documentation/usb/gadget_hid.txt::
+  a userspace program found in Documentation/usb/gadget_hid.rst::
 
        $ ./hid_gadget_test /dev/hidg0 keyboard
 
@@ -886,7 +886,7 @@ host::
        # cat /dev/usb/lp0
 
 More advanced testing can be done with the prn_example
-described in Documentation/usb/gadget_printer.txt.
+described in Documentation/usb/gadget_printer.rst.
 
 
 20. UAC1 function (virtual ALSA card, using u_audio API)
diff --git a/Documentation/usb/index.rst b/Documentation/usb/index.rst
new file mode 100644 (file)
index 0000000..e55386a
--- /dev/null
@@ -0,0 +1,39 @@
+===========
+USB support
+===========
+
+.. toctree::
+    :maxdepth: 1
+
+    acm
+    authorization
+    chipidea
+    dwc3
+    ehci
+    functionfs
+    gadget_configfs
+    gadget_hid
+    gadget_multi
+    gadget_printer
+    gadget_serial
+    gadget-testing
+    iuu_phoenix
+    mass-storage
+    misc_usbsevseg
+    mtouchusb
+    ohci
+    rio
+    usbip_protocol
+    usbmon
+    usb-serial
+    wusb-design-overview
+
+    usb-help
+    text_files
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/usb/text_files.rst b/Documentation/usb/text_files.rst
new file mode 100644 (file)
index 0000000..6a8d3fc
--- /dev/null
@@ -0,0 +1,29 @@
+Linux CDC ACM inf
+-----------------
+
+.. include:: linux-cdc-acm.inf
+    :literal:
+
+Linux inf
+---------
+
+.. include:: linux.inf
+    :literal:
+
+USB devfs drop permissions source
+---------------------------------
+
+.. literalinclude:: usbdevfs-drop-permissions.c
+    :language: c
+
+WUSB command line script to manipulate auth credentials
+-------------------------------------------------------
+
+.. literalinclude:: wusb-cbaf
+   :language: shell
+
+Credits
+-------
+
+.. include:: CREDITS
+    :literal:
index 57f496c..8e9d6ea 100644 (file)
@@ -3751,7 +3751,7 @@ F:        scripts/extract-cert.c
 CERTIFIED WIRELESS USB (WUSB) SUBSYSTEM:
 L:     linux-usb@vger.kernel.org
 S:     Orphan
-F:     Documentation/usb/WUSB-Design-overview.txt
+F:     Documentation/usb/wusb-design-overview.rst
 F:     Documentation/usb/wusb-cbaf
 F:     drivers/usb/host/hwa-hc.c
 F:     drivers/usb/host/whci/
@@ -16238,7 +16238,7 @@ USB ACM DRIVER
 M:     Oliver Neukum <oneukum@suse.com>
 L:     linux-usb@vger.kernel.org
 S:     Maintained
-F:     Documentation/usb/acm.txt
+F:     Documentation/usb/acm.rst
 F:     drivers/usb/class/cdc-acm.*
 
 USB AR5523 WIRELESS DRIVER
@@ -16291,7 +16291,7 @@ USB EHCI DRIVER
 M:     Alan Stern <stern@rowland.harvard.edu>
 L:     linux-usb@vger.kernel.org
 S:     Maintained
-F:     Documentation/usb/ehci.txt
+F:     Documentation/usb/ehci.rst
 F:     drivers/usb/host/ehci*
 
 USB GADGET/PERIPHERAL SUBSYSTEM
@@ -16365,7 +16365,7 @@ USB OHCI DRIVER
 M:     Alan Stern <stern@rowland.harvard.edu>
 L:     linux-usb@vger.kernel.org
 S:     Maintained
-F:     Documentation/usb/ohci.txt
+F:     Documentation/usb/ohci.rst
 F:     drivers/usb/host/ohci*
 
 USB OTG FSM (Finite State Machine)
@@ -16381,7 +16381,7 @@ M:      Shuah Khan <shuah@kernel.org>
 M:     Shuah Khan <skhan@linuxfoundation.org>
 L:     linux-usb@vger.kernel.org
 S:     Maintained
-F:     Documentation/usb/usbip_protocol.txt
+F:     Documentation/usb/usbip_protocol.rst
 F:     drivers/usb/usbip/
 F:     tools/usb/usbip/
 F:     tools/testing/selftests/drivers/usb/usbip/
@@ -16429,7 +16429,7 @@ M:      Johan Hovold <johan@kernel.org>
 L:     linux-usb@vger.kernel.org
 T:     git git://git.kernel.org/pub/scm/linux/kernel/git/johan/usb-serial.git
 S:     Maintained
-F:     Documentation/usb/usb-serial.txt
+F:     Documentation/usb/usb-serial.rst
 F:     drivers/usb/serial/
 F:     include/linux/usb/serial.h
 
index e4b2741..94573fb 100644 (file)
@@ -74,7 +74,7 @@ config USB
          After choosing your HCD, then select drivers for the USB peripherals
          you'll be using.  You may want to check out the information provided
          in <file:Documentation/usb/> and especially the links given in
-         <file:Documentation/usb/usb-help.txt>.
+         <file:Documentation/usb/usb-help.rst>.
 
          To compile this driver as a module, choose M here: the
          module will be called usbcore.
index 52f3a53..f8a7989 100644 (file)
@@ -10,7 +10,7 @@ config USB_ACM
        ---help---
          This driver supports USB modems and ISDN adapters which support the
          Communication Device Class Abstract Control Model interface.
-         Please read <file:Documentation/usb/acm.txt> for details.
+         Please read <file:Documentation/usb/acm.rst> for details.
 
          If your modem only reports "Cls=ff(vend.)" in the descriptors in
          /sys/kernel/debug/usb/devices, then your modem will not work with this
index ec189d7..02ff850 100644 (file)
@@ -228,7 +228,7 @@ config USB_CONFIGFS
          specified simply by creating appropriate directories in configfs.
          Associating functions with configurations is done by creating
          appropriate symbolic links.
-         For more information see Documentation/usb/gadget_configfs.txt.
+         For more information see Documentation/usb/gadget_configfs.rst.
 
 config USB_CONFIGFS_SERIAL
        bool "Generic serial bulk in/out"
@@ -441,7 +441,7 @@ config USB_CONFIGFS_F_HID
          The HID function driver provides generic emulation of USB
          Human Interface Devices (HID).
 
-         For more information, see Documentation/usb/gadget_hid.txt.
+         For more information, see Documentation/usb/gadget_hid.rst.
 
 config USB_CONFIGFS_F_UVC
        bool "USB Webcam function"
@@ -466,7 +466,7 @@ config USB_CONFIGFS_F_PRINTER
          receive or send printer data. It can use ioctl calls to
          the device file to get or set printer status.
 
-         For more information, see Documentation/usb/gadget_printer.txt
+         For more information, see Documentation/usb/gadget_printer.rst
          which includes sample code for accessing the device file.
 
 config USB_CONFIGFS_F_TCM
index 043f97a..29cc569 100644 (file)
@@ -47,7 +47,7 @@
  *
  * For more information about MSF and in particular its module
  * parameters and sysfs interface read the
- * <Documentation/usb/mass-storage.txt> file.
+ * <Documentation/usb/mass-storage.rst> file.
  */
 
 /*
index 94fc3c4..69ff7f8 100644 (file)
@@ -287,7 +287,7 @@ config USB_G_SERIAL
          Say "y" to link the driver statically, or "m" to build a
          dynamically linked module called "g_serial".
 
-         For more information, see Documentation/usb/gadget_serial.txt
+         For more information, see Documentation/usb/gadget_serial.rst
          which includes instructions and a "driver info file" needed to
          make MS-Windows work with CDC ACM.
 
@@ -321,7 +321,7 @@ config USB_G_PRINTER
          Say "y" to link the driver statically, or "m" to build a
          dynamically linked module called "g_printer".
 
-         For more information, see Documentation/usb/gadget_printer.txt
+         For more information, see Documentation/usb/gadget_printer.rst
          which includes sample code for accessing the device file.
 
 if TTY
@@ -436,7 +436,7 @@ config USB_G_HID
          The HID gadget driver provides generic emulation of USB
          Human Interface Devices (HID).
 
-         For more information, see Documentation/usb/gadget_hid.txt which
+         For more information, see Documentation/usb/gadget_hid.rst which
          includes sample code for accessing the device files.
 
          Say "y" to link the driver statically, or "m" to build a
index fb3406e..40b5de5 100644 (file)
@@ -114,7 +114,7 @@ config USB_EHCI_HCD
          Controller Driver or UHCI (for Via motherboards) Host Controller
          Driver too.
 
-         You may want to read <file:Documentation/usb/ehci.txt>.
+         You may want to read <file:Documentation/usb/ehci.rst>.
 
          To compile this driver as a module, choose M here: the
          module will be called ehci-hcd.
index c97f270..a829cd0 100644 (file)
@@ -51,7 +51,7 @@ config USB_RIO500
        tristate "USB Diamond Rio500 support"
        help
          Say Y here if you want to connect a USB Rio500 mp3 player to your
-         computer's USB port. Please read <file:Documentation/usb/rio.txt>
+         computer's USB port. Please read <file:Documentation/usb/rio.rst>
          for more information.
 
          To compile this driver as a module, choose M here: the
index 48f1b2d..ffc7cd4 100644 (file)
@@ -8,6 +8,6 @@ config USB_MON
        help
          If you select this option, a component which captures the USB traffic
          between peripheral-specific drivers and HC drivers will be built.
-         For more information, see <file:Documentation/usb/usbmon.txt>.
+         For more information, see <file:Documentation/usb/usbmon.rst>.
 
          If unsure, say Y, if allowed, otherwise M.
index 7d03191..67279c6 100644 (file)
@@ -11,7 +11,7 @@ menuconfig USB_SERIAL
          ports, or acts like a serial device, and you want to connect it to
          your USB bus.
 
-         Please read <file:Documentation/usb/usb-serial.txt> for more
+         Please read <file:Documentation/usb/usb-serial.rst> for more
          information on the specifics of the different devices that are
          supported, and on how to use them.
 
@@ -47,7 +47,7 @@ config USB_SERIAL_GENERIC
        bool "USB Generic Serial Driver"
        help
          Say Y here if you want to use the generic USB serial driver.  Please
-         read <file:Documentation/usb/usb-serial.txt> for more information on
+         read <file:Documentation/usb/usb-serial.rst> for more information on
          using this driver.  It is recommended that the "USB Serial converter
          support" be compiled as a module for this driver to be used
          properly.
@@ -163,7 +163,7 @@ config USB_SERIAL_EMPEG
        help
          Say Y here if you want to connect to your Empeg empeg-car Mark I/II
          mp3 player via USB.  The driver uses a single ttyUSB{0,1,2,...}
-         device node.  See <file:Documentation/usb/usb-serial.txt> for more
+         device node.  See <file:Documentation/usb/usb-serial.rst> for more
          tidbits of information.
 
          To compile this driver as a module, choose M here: the
@@ -199,7 +199,7 @@ config USB_SERIAL_IPAQ
          Say Y here if you want to connect to your Compaq iPAQ, HP Jornada
          or any other PDA running Windows CE 3.0 or PocketPC 2002
          using a USB cradle/cable. For information on using the driver,
-         read <file:Documentation/usb/usb-serial.txt>.
+         read <file:Documentation/usb/usb-serial.rst>.
 
          To compile this driver as a module, choose M here: the
          module will be called ipaq.
@@ -334,7 +334,7 @@ config USB_SERIAL_KLSI
          adapter sold by Palm Inc. for use with their Palm III and Palm V
          series PDAs.
 
-         Please read <file:Documentation/usb/usb-serial.txt> for more
+         Please read <file:Documentation/usb/usb-serial.rst> for more
          information.
 
          To compile this driver as a module, choose M here: the
index c1235d5..9bb123a 100644 (file)
@@ -10,7 +10,7 @@
  *  and associated source files.  Please see the usb/serial files for
  *  individual credits and copyrights.
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  *
  * TODO:
index 51bc062..a13a98d 100644 (file)
@@ -9,7 +9,7 @@
  *  and associated source files.  Please see the usb/serial files for
  *  individual credits and copyrights.
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  *
  * 12-Mar-2001 gkh
index 72d3ae1..216edd5 100644 (file)
@@ -7,7 +7,7 @@
  *     Copyright (C) 2003,2004
  *         Neil Whelchel (koyama@firstlight.net)
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  *
  * See http://geocities.com/i0xox0i for information on this driver and the
index d680bec..405e835 100644 (file)
@@ -8,7 +8,7 @@
  *     Copyright (C) 1999 - 2001
  *         Greg Kroah-Hartman (greg@kroah.com)
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  */
 
index 1d8461a..8b15bbf 100644 (file)
@@ -10,7 +10,7 @@
  *     Copyright (C) 2002
  *         Kuba Ober (kuba@mareimbrium.org)
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  *
  * See http://ftdi-usb-sio.sourceforge.net for up to date testing info
index 7643716..302eb95 100644 (file)
@@ -16,7 +16,7 @@
  * was written by Roman Weissgaerber <weissg@vienna.at>, Dag Brattli
  * <dag@brattli.net>, and Jean Tourrilhes <jt@hpl.hp.com>
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  */
 
index 38d43c4..bf988f7 100644 (file)
@@ -6,7 +6,7 @@
  * Copyright (C) 1999, 2000 Brian Warner       <warner@lothar.com>
  * Copyright (C) 2000 Al Borchers              <borchers@steinerpoint.com>
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  */
 
index e51c946..5b6e982 100644 (file)
@@ -4,7 +4,7 @@
  *
  * Copyright (C) 2013,2017 Johan Hovold <johan@kernel.org>
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  *
  * Please report both successes and troubles to the author at omninet@kroah.com
index 38ae0fc..8151dd7 100644 (file)
@@ -22,7 +22,7 @@
  * So, THIS CODE CAN DESTROY OTi-6858 AND ANY OTHER DEVICES, THAT ARE
  * CONNECTED TO IT!
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  *
  * TODO:
index d7abde1..9d27b76 100644 (file)
@@ -7,7 +7,7 @@
  *
  * Original driver for 2.2.x by anonymous
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  */
 
index 676c296..a3179fe 100644 (file)
@@ -10,7 +10,7 @@
  * This driver was originally based on the ACM driver by Armin Fuerst (which was
  * based on a driver by Brad Keryan)
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  */
 
index 8ddbecc..4412834 100644 (file)
@@ -6,7 +6,7 @@
  *     Copyright (C) 1999 - 2004
  *         Greg Kroah-Hartman (greg@kroah.com)
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  *
  */
index fe29024..4bd69d0 100644 (file)
@@ -5,7 +5,7 @@
  *     Copyright (C) 1999 - 2003
  *         Greg Kroah-Hartman (greg@kroah.com)
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver.
  *
  */
index aefd84f..79314d8 100644 (file)
@@ -8,7 +8,7 @@
  *     Copyright (C) 1999 - 2001
  *         Greg Kroah-Hartman (greg@kroah.com)
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  */
 
index 72c1b0c..0039814 100644 (file)
@@ -8,7 +8,7 @@
  *      Copyright (C) 1999, 2000
  *          Greg Kroah-Hartman (greg@kroah.com)
  *
- * See Documentation/usb/usb-serial.txt for more information on using this
+ * See Documentation/usb/usb-serial.rst for more information on using this
  * driver
  *
  */