From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wg0-f50.google.com (mail-wg0-f50.google.com [74.125.82.50]) by dpdk.org (Postfix) with ESMTP id 4E215255 for ; Fri, 30 Jan 2015 21:25:43 +0100 (CET) Received: by mail-wg0-f50.google.com with SMTP id b13so28795387wgh.9 for ; Fri, 30 Jan 2015 12:25:43 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:organization :user-agent:in-reply-to:references:mime-version :content-transfer-encoding:content-type; bh=0SYaWvq1vR3smOfgQFBWMIUwH4O8LyvGPL3N30xVvmY=; b=GatSden8y2YN/DeXSSz5LvL+bOc6svziwWxmKL/Z31EAZo0qyuhK/8A8G+TzbRtcqJ 36HI1p4gGpLh8u19KAo5+H6d6ka9nkC806DeMExO7X2PBPJRrXyU9DZAsJW+dw1FqK/l MpmUApbu/egQOhtHuVgH/XRdwK3PcafdNlZ7OUyPjAnCbIb8hgwOTNRAedRT6VIORP60 zEeZr7EfIbpOjfnkjxFqreTUP7N0V3EkNZBTKob4xegz/oaYtp12QD5IBEZDB1PtwxJ8 1cBinuPsJoPcigWCc8knVcsBRHQ87yc0chJbz3EvrN4z2LyvlmtllEXEG3QLR/mNuDXf wuSA== X-Gm-Message-State: ALoCoQmQbPv1ZuQm2XeYCSVyrfgrhUB6NpjBRPsX/q08JHDxZQHu8NYPc0ZtLStDip6OwZfExh8q X-Received: by 10.180.74.6 with SMTP id p6mr863795wiv.79.1422649542392; Fri, 30 Jan 2015 12:25:42 -0800 (PST) Received: from xps13.localnet (136-92-190-109.dsl.ovh.fr. [109.190.92.136]) by mx.google.com with ESMTPSA id q5sm4564418wix.0.2015.01.30.12.25.41 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 30 Jan 2015 12:25:41 -0800 (PST) From: Thomas Monjalon To: John McNamara Date: Fri, 30 Jan 2015 21:25:14 +0100 Message-ID: <8837708.92oJ92tvuU@xps13> Organization: 6WIND User-Agent: KMail/4.14.4 (Linux/3.18.4-1-ARCH; KDE/4.14.4; x86_64; ; ) In-Reply-To: <1422641608-8514-1-git-send-email-john.mcnamara@intel.com> References: <1421255657-19521-1-git-send-email-john.mcnamara@intel.com> <1422641608-8514-1-git-send-email-john.mcnamara@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Cc: dev@dpdk.org Subject: Re: [dpdk-dev] [PATCH v2 0/4] doc: Add 'make pdf' target to convert guide docs to pdf X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 30 Jan 2015 20:25:44 -0000 Hi John, 2015-01-30 18:13, John McNamara: > This patch adds support for creating PDF versions of the user guides. > > Specifically: > > * The Programmer's Guide > * The Linux Getting Started Guide > * The FreeBSD Getting Started Guide > * The Sample Applications User Guide > * The TestPMD User Guide > * The Release Notes > > The local and online Html documentation is very useful but we have had > internal and external requests from people who also liked the PDF > documentation in older releases. > > The PDF generation is fully automated and uses the same Sphinx build system > and RST files used for the Html docs but uses the 'latexpdf' target. In > addition to the standard Sphinx Python modules it requires the Tex/LaTeX > toolchain. For best results it requires a TexLive 'Full' installation. > > The PDF documents are generated as follows: > > make pdf > # or > make doc-pdf > > The PDFs aren't generated as part of the 'make doc' rule since they can take > some 1-3 minutes to build and since they have a large toolchain dependency. > > V2 Changes: > > * Removes config file duplication > * Converts SVG files to PNG on the fly > * Splits the patch into distinct mk/doc parts > * Fixes issues in the RST docs that prevent PDF generation It seems a lot better. I still have some comments but I feel we are not far of the simplest code ;) -- Thomas