Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > linux.kernel > #1519641
| From | Mauro Carvalho Chehab <m.chehab@samsung.com> |
|---|---|
| Newsgroups | linux.kernel |
| Subject | Re: [Ksummit-discuss] Including images on Sphinx documents |
| Date | 2016-11-11 10:40 +0100 |
| Message-ID | <sCgtr-2uj-9@gated-at.bofh.it> (permalink) |
| References | (1 earlier) <sAVU5-6hX-13@gated-at.bofh.it> <sBxmG-5pf-21@gated-at.bofh.it> <sBz59-6zy-71@gated-at.bofh.it> <sBzeN-6D4-7@gated-at.bofh.it> <sBzHP-6Ng-1@gated-at.bofh.it> |
| Organization | linux.* mail to news gateway |
Em Wed, 09 Nov 2016 13:58:12 +0200 Jani Nikula <jani.nikula@linux.intel.com> escreveu: > On Wed, 09 Nov 2016, Markus Heiser <markus.heiser@darmarit.de> wrote: > > Am 09.11.2016 um 12:16 schrieb Jani Nikula <jani.nikula@linux.intel.com>: > >>> So I vote for : > >>> > >>>> 1) copy (or symlink) all rst files to Documentation/output (or to the > >>>> build dir specified via O= directive) and generate the *.pdf there, > >>>> and produce those converted images via Makefile.; > >> > >> We're supposed to solve problems, not create new ones. > > > > ... new ones? ... > > Handle in-tree builds without copying. > > Make dependency analysis with source rst and "intermediate" rst work. > > Make sure your copying gets the timestamps right. > > Make Sphinx dependency analysis look at the right copies depending on > in-tree vs. out-of-tree. Generally make sure it doesn't confuse Sphinx's > own dependency analysis. I agree with Jani here: copy the files will make Sphinx recompile the entire documentation every time, with is bad. Ok, Some Makefile logic could be added to copy only on changes, but that will increase the Makefile complexity. So, I prefer not using copy. As I said before, a Sphinx extension that would make transparent for PDF document generation when a non-PDF image is included, doing whatever conversion needed, seems to be the right fix here, but someone would need to step up and write such extension. -- Cheers, Mauro
Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread
Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-07 11:00 +0100
Re: Including images on Sphinx documents Jani Nikula <jani.nikula@intel.com> - 2016-11-07 12:00 +0100
Re: Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-07 12:50 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Josh Triplett <josh@joshtriplett.org> - 2016-11-07 18:10 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-08 12:00 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Arnd Bergmann <arnd@arndb.de> - 2016-11-16 17:10 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@infradead.org> - 2016-11-16 21:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Arnd Bergmann <arnd@arndb.de> - 2016-11-17 12:10 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Jani Nikula <jani.nikula@intel.com> - 2016-11-17 12:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@infradead.org> - 2016-11-17 18:10 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@infradead.org> - 2016-11-17 18:10 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Linus Torvalds <torvalds@linux-foundation.org> - 2016-11-17 18:10 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents James Bottomley <James.Bottomley@HansenPartnership.com> - 2016-11-17 18:10 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@infradead.org> - 2016-11-17 18:20 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Johannes Berg <johannes@sipsolutions.net> - 2016-11-17 18:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Theodore Ts'o <tytso@mit.edu> - 2016-11-17 18:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Linus Torvalds <torvalds@linux-foundation.org> - 2016-11-17 19:10 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Jani Nikula <jani.nikula@intel.com> - 2016-11-18 10:20 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Daniel Vetter <daniel@ffwll.ch> - 2016-11-18 11:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Jonathan Corbet <corbet@lwn.net> - 2016-11-19 18:20 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Andrew Lunn <andrew@lunn.ch> - 2016-11-19 18:40 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Bart Van Assche <Bart.VanAssche@sandisk.com> - 2016-11-19 19:00 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents David Woodhouse <dwmw2@infradead.org> - 2016-11-19 19:00 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Linus Torvalds <torvalds@linux-foundation.org> - 2016-11-19 19:50 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents "David Woodhouse" <dwmw2@infradead.org> - 2016-11-20 00:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-20 15:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-19 22:00 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Linus Torvalds <torvalds@linux-foundation.org> - 2016-11-19 22:10 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Johannes Berg <johannes@sipsolutions.net> - 2016-11-21 11:40 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-21 15:10 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Jani Nikula <jani.nikula@linux.intel.com> - 2016-11-21 16:50 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Johannes Berg <johannes@sipsolutions.net> - 2016-11-21 16:50 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-21 20:50 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents James Bottomley <James.Bottomley@HansenPartnership.com> - 2016-11-21 16:50 +0100
Re: Including images on Sphinx documents Jonathan Corbet <corbet@lwn.net> - 2016-11-13 22:10 +0100
Re: Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-14 15:20 +0100
Re: Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-09 13:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Josh Triplett <josh@joshtriplett.org> - 2016-11-07 18:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Markus Heiser <markus.heiser@darmarit.de> - 2016-11-09 10:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Jani Nikula <jani.nikula@linux.intel.com> - 2016-11-09 12:20 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Markus Heiser <markus.heiser@darmarit.de> - 2016-11-09 12:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Jani Nikula <jani.nikula@linux.intel.com> - 2016-11-09 13:00 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Markus Heiser <markus.heiser@darmarit.de> - 2016-11-09 23:20 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Jani Nikula <jani.nikula@linux.intel.com> - 2016-11-10 11:40 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Jani Nikula <jani.nikula@linux.intel.com> - 2016-11-11 12:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Markus Heiser <markus.heiser@darmarit.de> - 2016-11-11 12:50 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Mauro Carvalho Chehab <m.chehab@samsung.com> - 2016-11-11 10:40 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-09 12:30 +0100
Re: [Ksummit-discuss] Including images on Sphinx documents Jani Nikula <jani.nikula@linux.intel.com> - 2016-11-09 12:50 +0100
Re: Including images on Sphinx documents Jonathan Corbet <corbet@lwn.net> - 2016-11-13 21:00 +0100
Re: Including images on Sphinx documents Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-14 14:40 +0100
csiph-web