Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755968AbcKBQIZ convert rfc822-to-8bit (ORCPT ); Wed, 2 Nov 2016 12:08:25 -0400 Received: from smtp2-2.goneo.de ([85.220.129.34]:60448 "EHLO smtp2-2.goneo.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753157AbcKBQIY (ORCPT ); Wed, 2 Nov 2016 12:08:24 -0400 X-Spam-Flag: NO X-Spam-Score: -2.9 Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 6.6 \(1510\)) Subject: Re: [PATCH RFC 0/4] Fix PDF build errors From: Markus Heiser In-Reply-To: <87lgx2jfq0.fsf@intel.com> Date: Wed, 2 Nov 2016 17:08:08 +0100 Cc: Mauro Carvalho Chehab , Linux Doc Mailing List , Mauro Carvalho Chehab , Jim Davis , linux-kernel List Content-Transfer-Encoding: 8BIT Message-Id: References: <87lgx2jfq0.fsf@intel.com> To: Jani Nikula , Jonathan Corbet X-Mailer: Apple Mail (2.1510) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1952 Lines: 63 Am 02.11.2016 um 12:14 schrieb Jani Nikula : > On Wed, 02 Nov 2016, Mauro Carvalho Chehab wrote: >> This series address a series of errors during PDF generation from >> media documentation. >> >> Please notice that patch 2 carries on a PDF conversion from a PNG >> image, because Sphinx is not smart enough to do the convertion. >> >> This is a temporary solution (That's why I'm marking this series >> as RFC). > > This seems to work on top of docs-next. > > ...but it'll break again if we include the missing admin-guide in the > build. :( > Sadly, this breaks the pdf build with: > > ! TeX capacity exceeded, sorry [main memory size=5000000]. > \FV@Space ...ionary {\copy \sphinxvisiblespacebox > }{\sphinxafterbreak } {\ke... > l.3711 ...\PYG{n}{be} \PYG{n}{used} \PYG{n+nb}{to} > or 2 This is the verbatim block of the kernel parameters with more than 4300 lines in. IMO, Verbatim exceeded, because in sphinx.sty is a redefinition of the LaTeX Verbatim command which might be sloppy / see sphinx.sty:: \renewcommand{\Verbatim}[1][1]{% .... The renew-Verbatim has been removed later: https://github.com/sphinx-doc/sphinx/commit/f9880bfcc8b19a7d197badeb6ab412abfca19891 I my POC I use such a modified sphinx.sty https://github.com/return42/sphkerneldoc/blob/master/_tex/sphinx.sty with it, the PDF is build: https://h2626237.stratoserver.net/kernel/books/admin-guide/pdf/linux-user.pdf Using modified sphinx.sty has the drawback, that it is not up- or downward compatible to the installed Sphinx version. So in short, I think it is the best to come back to the reasons and just split kernel parameters in several blocks and using the 'none' option to prevent rendering as C .. E.g: .. code-block:: none acpi= [HW,ACPI,X86,ARM64] Advanced Configuration and Power Interface Format: { force | on | off | strict | noirq | rsdt | copy_dsdt } -- Markus --