DPDK patches and discussions
 help / color / mirror / Atom feed
* [dpdk-dev] [PATCH RFC 0/1] Add 'make pdf' target to convert guide docs to pdf.
@ 2015-01-14 17:14 John McNamara
  2015-01-14 17:14 ` [dpdk-dev] [PATCH 1/2] doc: " John McNamara
                   ` (3 more replies)
  0 siblings, 4 replies; 41+ messages in thread
From: John McNamara @ 2015-01-14 17:14 UTC (permalink / raw)
  To: dev

This patch adds support for creating PDF versions of the 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 Tex Live '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.

This patch doesn't include PDF generation of the DPDK API document. That will
be submitted later in a separate patch.

I have omitted the 2/2 part of the patch with the PNG files from the RFC.


John McNamara (2):
  doc: Add 'make pdf' target to convert guide docs to pdf.
  doc: Add PNG files for 'make pdf' target.

 doc/api/sphinx-latex-update.pl                     |   71 ++++++++++++++++
 doc/guides/freebsd_gsg/conf.py                     |   86 ++++++++++++++++++++
 doc/guides/freebsd_gsg/img/Intel-logo.png          |  Bin 0 -> 7560 bytes
 doc/guides/linux_gsg/conf.py                       |   86 ++++++++++++++++++++
 doc/guides/linux_gsg/img/Intel-logo.png            |  Bin 0 -> 7560 bytes
 doc/guides/prog_guide/conf.py                      |   86 ++++++++++++++++++++
 doc/guides/prog_guide/img/Intel-logo.png           |  Bin 0 -> 7560 bytes
 .../prog_guide/img/architecture-overview.png       |  Bin 0 -> 69418 bytes
 doc/guides/prog_guide/img/bond-mode-0.png          |  Bin 0 -> 31581 bytes
 doc/guides/prog_guide/img/bond-mode-1.png          |  Bin 0 -> 25550 bytes
 doc/guides/prog_guide/img/bond-mode-2.png          |  Bin 0 -> 33645 bytes
 doc/guides/prog_guide/img/bond-mode-3.png          |  Bin 0 -> 33548 bytes
 doc/guides/prog_guide/img/bond-mode-4.png          |  Bin 0 -> 36763 bytes
 doc/guides/prog_guide/img/bond-mode-5.png          |  Bin 0 -> 40778 bytes
 doc/guides/prog_guide/img/bond-overview.png        |  Bin 0 -> 25065 bytes
 doc/guides/prog_guide/img/linuxapp_launch.png      |  Bin 0 -> 125118 bytes
 doc/guides/prog_guide/img/mbuf1.png                |  Bin 0 -> 37843 bytes
 doc/guides/prog_guide/img/mbuf2.png                |  Bin 0 -> 58682 bytes
 doc/guides/prog_guide/img/memory-management.png    |  Bin 0 -> 22904 bytes
 doc/guides/prog_guide/img/memory-management2.png   |  Bin 0 -> 25411 bytes
 doc/guides/prog_guide/img/mempool.png              |  Bin 0 -> 50966 bytes
 doc/guides/prog_guide/img/multi_process_memory.png |  Bin 0 -> 52930 bytes
 doc/guides/prog_guide/img/ring-dequeue1.png        |  Bin 0 -> 29169 bytes
 doc/guides/prog_guide/img/ring-dequeue2.png        |  Bin 0 -> 30334 bytes
 doc/guides/prog_guide/img/ring-dequeue3.png        |  Bin 0 -> 27677 bytes
 doc/guides/prog_guide/img/ring-enqueue1.png        |  Bin 0 -> 28386 bytes
 doc/guides/prog_guide/img/ring-enqueue2.png        |  Bin 0 -> 29329 bytes
 doc/guides/prog_guide/img/ring-enqueue3.png        |  Bin 0 -> 28907 bytes
 doc/guides/prog_guide/img/ring-modulo1.png         |  Bin 0 -> 21666 bytes
 doc/guides/prog_guide/img/ring-modulo2.png         |  Bin 0 -> 21814 bytes
 doc/guides/prog_guide/img/ring-mp-enqueue1.png     |  Bin 0 -> 35928 bytes
 doc/guides/prog_guide/img/ring-mp-enqueue2.png     |  Bin 0 -> 43924 bytes
 doc/guides/prog_guide/img/ring-mp-enqueue3.png     |  Bin 0 -> 43581 bytes
 doc/guides/prog_guide/img/ring-mp-enqueue4.png     |  Bin 0 -> 43648 bytes
 doc/guides/prog_guide/img/ring-mp-enqueue5.png     |  Bin 0 -> 29787 bytes
 doc/guides/prog_guide/img/ring1.png                |  Bin 0 -> 21466 bytes
 doc/guides/rel_notes/conf.py                       |   85 +++++++++++++++++++
 doc/guides/rel_notes/img/Intel-logo.png            |  Bin 0 -> 7560 bytes
 doc/guides/rel_notes/supported_features.rst        |    2 +-
 doc/guides/sample_app_ug/conf.py                   |   86 ++++++++++++++++++++
 doc/guides/sample_app_ug/img/Intel-logo.png        |  Bin 0 -> 7560 bytes
 doc/guides/sample_app_ug/img/dist_app.png          |  Bin 0 -> 14191 bytes
 doc/guides/sample_app_ug/img/dist_perf.png         |  Bin 0 -> 12355 bytes
 .../sample_app_ug/img/exception_path_example.png   |  Bin 0 -> 57544 bytes
 .../sample_app_ug/img/l2_fwd_benchmark_setup.png   |  Bin 0 -> 21985 bytes
 .../sample_app_ug/img/vm_power_mgr_highlevel.png   |  Bin 0 -> 192526 bytes
 .../img/vm_power_mgr_vm_request_seq.png            |  Bin 0 -> 59573 bytes
 doc/guides/sample_app_ug/img/vmdq_dcb_example.png  |  Bin 0 -> 36777 bytes
 doc/guides/sample_app_ug/test_pipeline.rst         |    6 +-
 doc/guides/testpmd_app_ug/conf.py                  |   85 +++++++++++++++++++
 doc/guides/testpmd_app_ug/img/Intel-logo.png       |  Bin 0 -> 7560 bytes
 mk/rte.sdkdoc.mk                                   |   28 +++++-
 mk/rte.sdkroot.mk                                  |    3 +-
 53 files changed, 614 insertions(+), 10 deletions(-)
 create mode 100644 doc/api/sphinx-latex-update.pl
 create mode 100644 doc/guides/freebsd_gsg/conf.py
 create mode 100644 doc/guides/freebsd_gsg/img/Intel-logo.png
 create mode 100644 doc/guides/linux_gsg/conf.py
 create mode 100644 doc/guides/linux_gsg/img/Intel-logo.png
 create mode 100644 doc/guides/prog_guide/conf.py
 create mode 100644 doc/guides/prog_guide/img/Intel-logo.png
 create mode 100644 doc/guides/prog_guide/img/architecture-overview.png
 create mode 100644 doc/guides/prog_guide/img/bond-mode-0.png
 create mode 100644 doc/guides/prog_guide/img/bond-mode-1.png
 create mode 100644 doc/guides/prog_guide/img/bond-mode-2.png
 create mode 100644 doc/guides/prog_guide/img/bond-mode-3.png
 create mode 100644 doc/guides/prog_guide/img/bond-mode-4.png
 create mode 100644 doc/guides/prog_guide/img/bond-mode-5.png
 create mode 100644 doc/guides/prog_guide/img/bond-overview.png
 create mode 100644 doc/guides/prog_guide/img/linuxapp_launch.png
 create mode 100644 doc/guides/prog_guide/img/mbuf1.png
 create mode 100644 doc/guides/prog_guide/img/mbuf2.png
 create mode 100644 doc/guides/prog_guide/img/memory-management.png
 create mode 100644 doc/guides/prog_guide/img/memory-management2.png
 create mode 100644 doc/guides/prog_guide/img/mempool.png
 create mode 100644 doc/guides/prog_guide/img/multi_process_memory.png
 create mode 100644 doc/guides/prog_guide/img/ring-dequeue1.png
 create mode 100644 doc/guides/prog_guide/img/ring-dequeue2.png
 create mode 100644 doc/guides/prog_guide/img/ring-dequeue3.png
 create mode 100644 doc/guides/prog_guide/img/ring-enqueue1.png
 create mode 100644 doc/guides/prog_guide/img/ring-enqueue2.png
 create mode 100644 doc/guides/prog_guide/img/ring-enqueue3.png
 create mode 100644 doc/guides/prog_guide/img/ring-modulo1.png
 create mode 100644 doc/guides/prog_guide/img/ring-modulo2.png
 create mode 100644 doc/guides/prog_guide/img/ring-mp-enqueue1.png
 create mode 100644 doc/guides/prog_guide/img/ring-mp-enqueue2.png
 create mode 100644 doc/guides/prog_guide/img/ring-mp-enqueue3.png
 create mode 100644 doc/guides/prog_guide/img/ring-mp-enqueue4.png
 create mode 100644 doc/guides/prog_guide/img/ring-mp-enqueue5.png
 create mode 100644 doc/guides/prog_guide/img/ring1.png
 create mode 100644 doc/guides/rel_notes/conf.py
 create mode 100644 doc/guides/rel_notes/img/Intel-logo.png
 create mode 100644 doc/guides/sample_app_ug/conf.py
 create mode 100644 doc/guides/sample_app_ug/img/Intel-logo.png
 create mode 100644 doc/guides/sample_app_ug/img/dist_app.png
 create mode 100644 doc/guides/sample_app_ug/img/dist_perf.png
 create mode 100644 doc/guides/sample_app_ug/img/exception_path_example.png
 create mode 100644 doc/guides/sample_app_ug/img/l2_fwd_benchmark_setup.png
 create mode 100644 doc/guides/sample_app_ug/img/vm_power_mgr_highlevel.png
 create mode 100644 doc/guides/sample_app_ug/img/vm_power_mgr_vm_request_seq.png
 create mode 100644 doc/guides/sample_app_ug/img/vmdq_dcb_example.png
 create mode 100644 doc/guides/testpmd_app_ug/conf.py
 create mode 100644 doc/guides/testpmd_app_ug/img/Intel-logo.png

-- 
1.7.4.1

^ permalink raw reply	[flat|nested] 41+ messages in thread

end of thread, other threads:[~2015-03-19 17:05 UTC | newest]

Thread overview: 41+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2015-01-14 17:14 [dpdk-dev] [PATCH RFC 0/1] Add 'make pdf' target to convert guide docs to pdf John McNamara
2015-01-14 17:14 ` [dpdk-dev] [PATCH 1/2] doc: " John McNamara
2015-01-30 18:13 ` [dpdk-dev] [PATCH v2 0/4] " John McNamara
2015-01-30 18:13   ` [dpdk-dev] [PATCH v2 1/4] mk: Add 'make doc-pdf' " John McNamara
2015-01-30 20:52     ` Thomas Monjalon
     [not found]       ` <B27915DBBA3421428155699D51E4CFE2EAC4D2@IRSMSX103.ger.corp.intel.com>
     [not found]         ` <2564393.TY2qeNvaqR@xps13>
2015-02-03 13:24           ` Mcnamara, John
2015-01-30 18:13   ` [dpdk-dev] [PATCH v2 2/4] doc: Add Sphinx config to build pdf version of guides John McNamara
2015-01-30 21:03     ` Thomas Monjalon
2015-01-30 18:13   ` [dpdk-dev] [PATCH v2 3/4] doc: Fix encoding of (r) character John McNamara
2015-01-30 18:13   ` [dpdk-dev] [PATCH v2 4/4] doc: Refactored split cell formatting in one table John McNamara
2015-01-30 21:05     ` Thomas Monjalon
2015-01-30 20:25   ` [dpdk-dev] [PATCH v2 0/4] doc: Add 'make pdf' target to convert guide docs to pdf Thomas Monjalon
     [not found] ` <1422882967-27060-1-git-send-email-john.mcnamara@intel.com>
     [not found]   ` <1422882967-27060-3-git-send-email-john.mcnamara@intel.com>
2015-02-03 10:30     ` [dpdk-dev] [PATCH v3 2/4] doc: Add Sphinx config to build pdf version of guides Iremonger, Bernard
2015-02-03 14:11 ` [dpdk-dev] [PATCH v4 0/5] doc: Add 'make pdf' target to convert guide docs to pdf John McNamara
2015-02-03 14:11   ` [dpdk-dev] [PATCH v4 1/5] mk: Add 'make doc-pdf' " John McNamara
2015-02-16 12:19     ` Iremonger, Bernard
2015-02-16 12:55       ` Mcnamara, John
2015-02-16 14:16       ` Iremonger, Bernard
2015-02-03 14:11   ` [dpdk-dev] [PATCH v4 2/5] doc: Add Sphinx config to build pdf version of guides John McNamara
2015-02-16 14:20     ` Iremonger, Bernard
2015-02-03 14:11   ` [dpdk-dev] [PATCH v4 3/5] doc: Fix encoding of (r) character John McNamara
2015-02-13 14:29     ` Iremonger, Bernard
2015-02-13 15:59       ` Mcnamara, John
2015-02-13 16:42         ` Iremonger, Bernard
2015-02-16 14:22     ` Iremonger, Bernard
2015-02-03 14:11   ` [dpdk-dev] [PATCH v4 4/5] doc: Refactored split cell formatting in one table John McNamara
2015-02-16 14:23     ` Iremonger, Bernard
2015-02-03 14:11   ` [dpdk-dev] [PATCH v4 5/5] doc: Convert image extensions to wildcard John McNamara
2015-02-16 12:09     ` Iremonger, Bernard
2015-02-16 12:43       ` Mcnamara, John
2015-02-16 14:25     ` Iremonger, Bernard
2015-03-19 11:23   ` [dpdk-dev] [PATCH v5 0/7] add doc-guides-pdf target Thomas Monjalon
2015-03-19 11:23     ` [dpdk-dev] [PATCH v5 1/7] doc: fix encoding of (r) character Thomas Monjalon
2015-03-19 11:23     ` [dpdk-dev] [PATCH v5 2/7] doc: refactor split cell formatting in table Thomas Monjalon
2015-03-19 11:23     ` [dpdk-dev] [PATCH v5 3/7] doc: convert image extensions to wildcard Thomas Monjalon
2015-03-19 11:23     ` [dpdk-dev] [PATCH v5 4/7] doc: add pdf output Thomas Monjalon
2015-03-19 11:23     ` [dpdk-dev] [PATCH v5 5/7] doc: fix version for python 3 Thomas Monjalon
2015-03-19 11:23     ` [dpdk-dev] [PATCH v5 6/7] doc: tune pdf fonts Thomas Monjalon
2015-03-19 11:23     ` [dpdk-dev] [PATCH v5 7/7] doc: remove blank pages in pdf Thomas Monjalon
2015-03-19 13:47     ` [dpdk-dev] [PATCH v5 0/7] add doc-guides-pdf target Mcnamara, John
2015-03-19 17:04       ` Thomas Monjalon

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).