[PATCH 02/22] docs-rst: convert usb docbooks to ReST
markus.heiser at darmarit.de
Thu Mar 30 00:48:40 PDT 2017
Am 29.03.2017 um 20:54 schrieb Mauro Carvalho Chehab <mchehab at s-opensource.com>:
> As we're moving out of DocBook, let's convert the remaining
> USB docbooks to ReST.
> The transformation itself on this patch is a no-brainer
> conversion using pandoc.
right, its a no-brainer ;-) I'am not very happy with this
conversions, some examples see below.
I recommend to use a more elaborate conversion as starting point,
e.g. from my sphkerneldoc project:
Since these DocBooks hasn't been changed in the last month, the linked reST
should be up to date.
> +Kernel Mode Gadget API
> +Gadget drivers declare themselves through a *struct
> +usb\_gadget\_driver*, which is responsible for most parts of enumeration
> +for a *struct usb\_gadget*. The response to a set\_configuration usually
> +involves enabling one or more of the *struct usb\_ep* objects exposed by
> +the gadget, and submitting one or more *struct usb\_request* buffers to
quoting of all underlines is not needed.
> +!Iinclude/linux/usb/composite.h !Edrivers/usb/gadget/composite.c
> +Composite Device Functions
> +At this writing, a few of the current gadget drivers have been converted
> +to this framework. Near-term plans include converting all of them,
> +except for "gadgetfs".
> +Peripheral Controller Drivers
I guess we miss some documentation here.
-- Markus --
More information about the linux-rpi-kernel