Re: [PATCH 7/8] Input: docs - split input docs into kernel- and user-facing

Path	csiph.com!news.redatomik.org!aioe.org!bofh.it!news.nic.it!robomod
From	Mauro Carvalho Chehab <mchehab@s-opensource.com>
Newsgroups	linux.kernel
Subject	Re: [PATCH 7/8] Input: docs - split input docs into kernel- and user-facing
Date	Sun, 16 Apr 2017 17:00:02 +0200
Message-ID	<twTOG-4RO-1@gated-at.bofh.it> (permalink)
References	<twKLn-8bo-3@gated-at.bofh.it> <twKLn-8bo-5@gated-at.bofh.it> <twT2i-4Bq-5@gated-at.bofh.it>
X-Original-To	Dmitry Torokhov <dmitry.torokhov@gmail.com>, Jonathan Corbet <corbet@lwn.net>
Organization	Samsung
X-Mailer	Claws Mail 3.14.1 (GTK+ 2.24.31; x86_64-redhat-linux-gnu)
MIME-Version	1.0
Content-Type	text/plain; charset=US-ASCII
Content-Transfer-Encoding	7bit
Sender	robomod@news.nic.it
List-ID	<linux-kernel.vger.kernel.org>
X-Mailing-List	linux-kernel@vger.kernel.org
Approved	robomod@news.nic.it
Lines	47
X-Original-Cc	linux-input@vger.kernel.org, Mauro Carvalho Chehab <mchehab@kernel.org>, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Vojtech Pavlik <vojtech@suse.cz>
X-Original-Date	Sun, 16 Apr 2017 11:50:57 -0300
X-Original-Message-ID	<20170416115053.233b5a37@vento.lan>
X-Original-References	<20170416051145.13618-1-dmitry.torokhov@gmail.com> <20170416051145.13618-7-dmitry.torokhov@gmail.com> <20170416110813.66a4ba64@vento.lan>
X-Original-Sender	linux-kernel-owner@vger.kernel.org
Xref	csiph.com linux.kernel:1624394

Show key headers only | View raw

Em Sun, 16 Apr 2017 11:08:13 -0300
Mauro Carvalho Chehab <mchehab@s-opensource.com> escreveu:

> Hi Dmitry,
> 
> Em Sat, 15 Apr 2017 22:11:44 -0700
> Dmitry Torokhov <dmitry.torokhov@gmail.com> escreveu:
> 
> > Split input documentation into several groups: kernel- and user-facing, and
> > notes about individual device drivers. Move device drivers docs into a
> > separate subdirectory.  
> 
> I reviewed and tested Sphinx generation for this patch series.
> Thinks are a way better organized now. Good work!
> 
> I got just a minor nitpick for HTML generation (see below).
> 
> 
> However, building PDF documentation now hits an error, with Sphinx 1.4.9:
> 
> 	Markup is unsupported in LaTeX:
> 	input/devices/xpad:209: literal blocks in footnotes are not supported by LaTeX
> 
> It seems it didn't like to have literal blocks inside footnotes:
> 
> 	.. [4] /proc/bus/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
> 
> 
> I'll see if I can find a way to fix this issue.

The enclosed patch should fix it. It should come after the one that
replaces /proc/bus/usb/devices to /sys/kernel/debug/usb/devices.

It also fixes the last reference to the last URL.

Thanks,
Mauro

Back to linux.kernel | Previous | Next — Previous in thread | Find similar | Unroll thread

Thread

[PATCH 1/8] Input: move documentation for Amiga CD32 Dmitry Torokhov <dmitry.torokhov@gmail.com> - 2017-04-16 07:20 +0200
  [PATCH 6/8] Input: docs - note that MT-A protocol is obsolete Dmitry Torokhov <dmitry.torokhov@gmail.com> - 2017-04-16 07:20 +0200
  [PATCH 4/8] Input: docs - remove disclaimer/GPL notice Dmitry Torokhov <dmitry.torokhov@gmail.com> - 2017-04-16 07:20 +0200
  [PATCH 5/8] Input: docs - update joystick documentation a bit Dmitry Torokhov <dmitry.torokhov@gmail.com> - 2017-04-16 07:20 +0200
  [PATCH 2/8] Input: rotary-encoder - remove references to platform data from docs Dmitry Torokhov <dmitry.torokhov@gmail.com> - 2017-04-16 07:20 +0200
  [PATCH 8/8] Input: docs - freshen up introduction Dmitry Torokhov <dmitry.torokhov@gmail.com> - 2017-04-16 07:20 +0200
  [PATCH 7/8] Input: docs - split input docs into kernel- and user-facing Dmitry Torokhov <dmitry.torokhov@gmail.com> - 2017-04-16 07:20 +0200
    Re: [PATCH 7/8] Input: docs - split input docs into kernel- and  user-facing Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2017-04-16 16:10 +0200
      Re: [PATCH 7/8] Input: docs - split input docs into kernel- and  user-facing Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2017-04-16 17:00 +0200

csiph-web