Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753705AbcKBN14 (ORCPT ); Wed, 2 Nov 2016 09:27:56 -0400 Received: from mga11.intel.com ([192.55.52.93]:53139 "EHLO mga11.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752586AbcKBN1y (ORCPT ); Wed, 2 Nov 2016 09:27:54 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.31,583,1473145200"; d="scan'208";a="781346812" From: Jani Nikula To: Mauro Carvalho Chehab Cc: Mauro Carvalho Chehab , Linux Doc Mailing List , Jim Davis , Jonathan Corbet , linux-kernel , , kbuild-all@01.org Subject: Re: [PATCH RFC 0/4] Fix PDF build errors In-Reply-To: <20161102062045.1216f864@vela.lan> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <87lgx2jfq0.fsf@intel.com> <20161102062045.1216f864@vela.lan> Date: Wed, 02 Nov 2016 15:27:50 +0200 Message-ID: <87funaj9k9.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 3397 Lines: 109 On Wed, 02 Nov 2016, Mauro Carvalho Chehab wrote: > Em Wed, 02 Nov 2016 13:14:47 +0200 > Jani Nikula escreveu: > >> 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. > > Yes. > >> ...but it'll break again if we include the missing admin-guide in the >> build. :( > > LaTeX/PDF output is ugly... for each new stuff, we need to re-validate its > output :-( Once we have this working, I think the only way to keep it working is to have continuous testing of the pdf build. That won't keep the output pretty, but it'll help ensure passing build. Perhaps 0day could eventually start running 'make DOCBOOKS="" pdfdocs' after the htmldocs target? Cc: Fengguang and kbuild-all. BR, Jani. > > > >> >> BR, >> Jani. >> >> >> From c296287c65f4b6ad6272171456dcf8508c92ae2f Mon Sep 17 00:00:00 2001 >> From: Jani Nikula >> Date: Wed, 2 Nov 2016 13:05:59 +0200 >> Subject: [PATCH] Documentation/sphinx: include admin-guide in the latex/pdf >> build >> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo >> Cc: Jani Nikula >> >> Fix the warning: >> >> WARNING: "latex_documents" config value references unknown document >> user/index >> >> Signed-off-by: Jani Nikula >> >> --- >> >> 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} >> >> Output written on linux-user.pdf (15 pages). >> Transcript written on linux-user.log. >> Makefile:66: recipe for target 'linux-user.pdf' failed >> make[2]: *** [linux-user.pdf] Error 1 >> Documentation/Makefile.sphinx:83: recipe for target 'pdfdocs' failed >> make[1]: *** [pdfdocs] Error 2 >> Makefile:1442: recipe for target 'pdfdocs' failed >> make: *** [pdfdocs] Error 2 >> --- >> Documentation/conf.py | 2 +- >> 1 file changed, 1 insertion(+), 1 deletion(-) >> >> diff --git a/Documentation/conf.py b/Documentation/conf.py >> index 814c336e5f5e..0c758a4f61f1 100644 >> --- a/Documentation/conf.py >> +++ b/Documentation/conf.py >> @@ -340,7 +340,7 @@ if minor > 3: >> # (source start file, target name, title, >> # author, documentclass [howto, manual, or own class]). >> latex_documents = [ >> - ('user/index', 'linux-user.tex', 'Linux Kernel User Documentation', >> + ('admin-guide/index', 'linux-user.tex', 'Linux Kernel User Documentation', > > Oh! It seems I forgot to rename the guide name here :( > > Your patch looks OK! > > Reviewed-by: Mauro Carvalho Chehab > >> 'The kernel development community', 'manual'), >> ('kernel-documentation', 'kernel-documentation.tex', 'The Linux Kernel Documentation', >> 'The kernel development community', 'manual'), > > > > > Cheers, > Mauro -- Jani Nikula, Intel Open Source Technology Center