Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756968AbdDRDLg (ORCPT ); Mon, 17 Apr 2017 23:11:36 -0400 Received: from mail-pf0-f194.google.com ([209.85.192.194]:36429 "EHLO mail-pf0-f194.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1756194AbdDRDLb (ORCPT ); Mon, 17 Apr 2017 23:11:31 -0400 Date: Mon, 17 Apr 2017 20:11:27 -0700 From: Dmitry Torokhov To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , Jonathan Corbet , linux-kernel@vger.kernel.org Subject: Re: [PATCH 2/4] input: xpad.rst: Don't use literal blocks inside footnotes Message-ID: <20170418031127.GC39414@dtor-ws> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 3863 Lines: 96 On Mon, Apr 17, 2017 at 09:46:14AM -0300, Mauro Carvalho Chehab wrote: > Unfortunately, Sphinx (or LaTeX) can't handle literal blocks > inside footnotes. So, just use normal text for the two > literal code-blocks that documents the output of > /sys/kernel/debug/usb/devices for xpad devices. > > Signed-off-by: Mauro Carvalho Chehab Applied, thank you. > --- > Documentation/input/devices/xpad.rst | 51 ++++++++++++++++++------------------ > 1 file changed, 25 insertions(+), 26 deletions(-) > > diff --git a/Documentation/input/devices/xpad.rst b/Documentation/input/devices/xpad.rst > index e19669fe5a80..c7c4e154bd34 100644 > --- a/Documentation/input/devices/xpad.rst > +++ b/Documentation/input/devices/xpad.rst > @@ -138,15 +138,37 @@ Driver Installation > > Once you have the adapter cable, if needed, and the controller connected > the xpad module should be auto loaded. To confirm you can cat > -/sys/kernel/debug/usb/devices. There should be an entry like the one at the end [4]_. > +/sys/kernel/debug/usb/devices. There should be an entry like those: > > +.. code-block:: none > + :caption: dump from InterAct PowerPad Pro (Germany) > + > + T: Bus=01 Lev=03 Prnt=04 Port=00 Cnt=01 Dev#= 5 Spd=12 MxCh= 0 > + D: Ver= 1.10 Cls=00(>ifc ) Sub=00 Prot=00 MxPS=32 #Cfgs= 1 > + P: Vendor=05fd ProdID=107a Rev= 1.00 > + C:* #Ifs= 1 Cfg#= 1 Atr=80 MxPwr=100mA > + I: If#= 0 Alt= 0 #EPs= 2 Cls=58(unk. ) Sub=42 Prot=00 Driver=(none) > + E: Ad=81(I) Atr=03(Int.) MxPS= 32 Ivl= 10ms > + E: Ad=02(O) Atr=03(Int.) MxPS= 32 Ivl= 10ms > + > +.. code-block:: none > + :caption: dump from Redoctane Xbox Dance Pad (US) > + > + T: Bus=01 Lev=02 Prnt=09 Port=00 Cnt=01 Dev#= 10 Spd=12 MxCh= 0 > + D: Ver= 1.10 Cls=00(>ifc ) Sub=00 Prot=00 MxPS= 8 #Cfgs= 1 > + P: Vendor=0c12 ProdID=8809 Rev= 0.01 > + S: Product=XBOX DDR > + C:* #Ifs= 1 Cfg#= 1 Atr=80 MxPwr=100mA > + I: If#= 0 Alt= 0 #EPs= 2 Cls=58(unk. ) Sub=42 Prot=00 Driver=xpad > + E: Ad=82(I) Atr=03(Int.) MxPS= 32 Ivl=4ms > + E: Ad=02(O) Atr=03(Int.) MxPS= 32 Ivl=4ms > > > Supported Controllers > ===================== > > For a full list of supported controllers and associated vendor and product > -IDs see the xpad_device[] array[6]. > +IDs see the xpad_device[] array\ [4]_. > > As of the historic version 0.0.6 (2006-10-10) the following devices > were supported:: > @@ -202,30 +224,7 @@ References > .. [1] http://euc.jp/periphs/xbox-controller.ja.html (ITO Takayuki) > .. [2] http://xpad.xbox-scene.com/ > .. [3] http://www.markosweb.com/www/xboxhackz.com/ > -.. [4] /sys/kernel/debug/usb/devices - dump from InterAct PowerPad Pro (Germany): > - > - :: > - > - T: Bus=01 Lev=03 Prnt=04 Port=00 Cnt=01 Dev#= 5 Spd=12 MxCh= 0 > - D: Ver= 1.10 Cls=00(>ifc ) Sub=00 Prot=00 MxPS=32 #Cfgs= 1 > - P: Vendor=05fd ProdID=107a Rev= 1.00 > - C:* #Ifs= 1 Cfg#= 1 Atr=80 MxPwr=100mA > - I: If#= 0 Alt= 0 #EPs= 2 Cls=58(unk. ) Sub=42 Prot=00 Driver=(none) > - E: Ad=81(I) Atr=03(Int.) MxPS= 32 Ivl= 10ms > - E: Ad=02(O) Atr=03(Int.) MxPS= 32 Ivl= 10ms > -.. [5] /sys/kernel/debug/usb/devices - dump from Redoctane Xbox Dance Pad (US): > - > - :: > - > - T: Bus=01 Lev=02 Prnt=09 Port=00 Cnt=01 Dev#= 10 Spd=12 MxCh= 0 > - D: Ver= 1.10 Cls=00(>ifc ) Sub=00 Prot=00 MxPS= 8 #Cfgs= 1 > - P: Vendor=0c12 ProdID=8809 Rev= 0.01 > - S: Product=XBOX DDR > - C:* #Ifs= 1 Cfg#= 1 Atr=80 MxPwr=100mA > - I: If#= 0 Alt= 0 #EPs= 2 Cls=58(unk. ) Sub=42 Prot=00 Driver=xpad > - E: Ad=82(I) Atr=03(Int.) MxPS= 32 Ivl=4ms > - E: Ad=02(O) Atr=03(Int.) MxPS= 32 Ivl=4ms > -.. [6] http://lxr.free-electrons.com/ident?i=xpad_device > +.. [4] http://lxr.free-electrons.com/ident?i=xpad_device > > > Historic Edits > -- > 2.9.3 > -- Dmitry