Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754802AbcCDOJa (ORCPT ); Fri, 4 Mar 2016 09:09:30 -0500 Received: from mail.sig21.net ([80.244.240.74]:41807 "EHLO mail.sig21.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751337AbcCDOJ1 (ORCPT ); Fri, 4 Mar 2016 09:09:27 -0500 Date: Fri, 4 Mar 2016 15:09:09 +0100 From: Johannes Stezenbach To: Mauro Carvalho Chehab Cc: Jani Nikula , Keith Packard , Jonathan Corbet , LKML , linux-doc@vger.kernel.org, Daniel Vetter , Hans Verkuil , linux-media@vger.kernel.org, Graham Whaley Subject: Re: Kernel docs: muddying the waters a bit Message-ID: <20160304140909.GA15636@linuxtv.org> References: <20160213145317.247c63c7@lwn.net> <87y49zr74t.fsf@intel.com> <20160303071305.247e30b1@lwn.net> <20160303155037.705f33dd@recife.lan> <86egbrm9hw.fsf@hiro.keithp.com> <20160303221930.32558496@recife.lan> <87si06r6i3.fsf@intel.com> <20160304095950.3358a2cb@recife.lan> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20160304095950.3358a2cb@recife.lan> User-Agent: Mutt/1.5.24 (2015-08-30) X-Spam-21-Score: -2.9 (--) X-Spam-21-Report: No, score=-2.9 required=8.0 tests=ALL_TRUSTED=-1,BAYES_00=-1.9,URIBL_BLOCKED=0.001 autolearn=ham Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1019 Lines: 29 On Fri, Mar 04, 2016 at 09:59:50AM -0300, Mauro Carvalho Chehab wrote: > > 3) I tried to use a .. cssclass, as Johannes suggested, but > I was not able to include the CSS file. I suspect that this is > easy to fix, but I want to see if the cssclass will also work for > the pdf output as well. "cssclass" was (I think) a custom role defined in the example, unless you also have defined a custom role you can use plain "class". I have not looked deeper into the theming and template stuff. > 4) It seems that it can't produce nested tables in pdf: > > Markup is unsupported in LaTeX: > v4l-table-within-table:: nested tables are not yet implemented. > Makefile:115: recipe for target 'latexpdf' failed This: http://www.sphinx-doc.org/en/stable/markup/misc.html#tables suggests you need to add the tabularcolumns directive for complex tables. BTW, as an alternative to the ASCII-art input there is also support for CSV and list tables: http://docutils.sourceforge.net/docs/ref/rst/directives.html#table Johannes