From: Mauro Carvalho Chehab <mauro.chehab@linux.intel.com>
To: igt-dev@lists.freedesktop.org
Subject: [igt-dev] [PATCH i-g-t v4 2/8] testplan: build also a PDF file with the testplan
Date: Wed, 22 Mar 2023 09:28:20 +0100 [thread overview]
Message-ID: <20230322082826.1770429-3-mauro.chehab@linux.intel.com> (raw)
In-Reply-To: <20230322082826.1770429-1-mauro.chehab@linux.intel.com>
From: Mauro Carvalho Chehab <mchehab@kernel.org>
PDF files are easier to share, and it costs almost nothing to
produce them with Sphinx, via rst2pdf. Added support for it
if rst2pdf is installed.
Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>
---
docs/testplan/meson.build | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
diff --git a/docs/testplan/meson.build b/docs/testplan/meson.build
index 11c08573307e..50063aa2e84f 100644
--- a/docs/testplan/meson.build
+++ b/docs/testplan/meson.build
@@ -5,6 +5,7 @@ build_sphinx = get_option('sphinx')
rst2html = find_program('rst2html-3', 'rst2html', required : build_testplan)
sphinx = find_program('sphinx-build', required: build_sphinx)
+rst2pdf = find_program('rst2pdf', required: false)
stylesheet = meson.current_source_dir() + '/testplan.css'
@@ -52,8 +53,23 @@ if sphinx.found()
output : 'index.html'
)
endif
+
+ if rst2pdf.found()
+ sphinx_out_pdf = meson.current_build_dir() + '/pdf'
+
+ custom_target('xe_tests.pdf',
+ build_by_default : true,
+ command : [ 'sphinx-build', '-c', meson.current_source_dir(),
+ '-b', 'pdf',
+ '-D', 'version=' + meson.project_version(),
+ meson.current_build_dir(), sphinx_out_pdf],
+ input : index_rst,
+ output : 'xe_tests.pdf'
+ )
+ endif
endif
build_info += 'Build ReST test documentation: @0@'.format(igt_doc_script.found())
build_info += 'Build simple html testplan documentation: @0@'.format(rst2html.found())
build_info += 'Build indexed html testplan documentation: @0@'.format(sphinx.found())
+build_info += 'Build pdf testplan documentation: @0@'.format(sphinx.found() and rst2pdf.found())
--
2.39.2
next prev parent reply other threads:[~2023-03-22 8:28 UTC|newest]
Thread overview: 23+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-03-22 8:28 [igt-dev] [PATCH i-g-t v4 0/8] Build Xe test documentation Mauro Carvalho Chehab
2023-03-22 8:28 ` [igt-dev] [PATCH i-g-t v4 1/8] meson: build " Mauro Carvalho Chehab
2023-03-24 13:31 ` Kamil Konieczny
2023-03-28 17:56 ` Juha-Pekka Heikkila
2023-03-30 5:20 ` Mauro Carvalho Chehab
2023-03-30 11:13 ` Juha-Pekka Heikkila
2023-03-22 8:28 ` Mauro Carvalho Chehab [this message]
2023-03-24 13:32 ` [igt-dev] [PATCH i-g-t v4 2/8] testplan: build also a PDF file with the testplan Kamil Konieczny
2023-03-22 8:28 ` [igt-dev] [PATCH i-g-t v4 3/8] meson.build: place gtk-doc dependencies check at the right place Mauro Carvalho Chehab
2023-03-24 13:43 ` Kamil Konieczny
2023-03-22 8:28 ` [igt-dev] [PATCH i-g-t v4 4/8] meson: get rid of a future-deprecated warning Mauro Carvalho Chehab
2023-03-22 19:11 ` Kamil Konieczny
2023-03-22 8:28 ` [igt-dev] [PATCH i-g-t v4 5/8] meson: get rid of tests/xe/meson.build Mauro Carvalho Chehab
2023-03-24 13:44 ` Kamil Konieczny
2023-03-22 8:28 ` [igt-dev] [PATCH i-g-t v4 6/8] testplan/meson.build: cleanup dependency chain Mauro Carvalho Chehab
2023-03-24 13:49 ` Kamil Konieczny
2023-03-22 8:28 ` [igt-dev] [PATCH i-g-t v4 7/8] testplan/meson.build: use join_paths() Mauro Carvalho Chehab
2023-03-22 19:14 ` Kamil Konieczny
2023-03-22 8:28 ` [igt-dev] [PATCH i-g-t v4 8/8] testplan/meson.build: re-indent file Mauro Carvalho Chehab
2023-03-24 13:50 ` Kamil Konieczny
2023-03-22 9:24 ` [igt-dev] ✓ Fi.CI.BAT: success for Build Xe test documentation Patchwork
2023-03-22 13:59 ` [igt-dev] ✓ Fi.CI.IGT: " Patchwork
-- strict thread matches above, loose matches on Subject: below --
2023-03-22 6:49 [igt-dev] [PATCH i-g-t v4 0/8] " Mauro Carvalho Chehab
2023-03-22 6:49 ` [igt-dev] [PATCH i-g-t v4 2/8] testplan: build also a PDF file with the testplan Mauro Carvalho Chehab
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20230322082826.1770429-3-mauro.chehab@linux.intel.com \
--to=mauro.chehab@linux.intel.com \
--cc=igt-dev@lists.freedesktop.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox