[libvirt PATCH 321/351] meson: docs: introduce meson-html-gen.py helper
phrdina at redhat.com
Tue Jul 28 14:46:55 UTC 2020
On Tue, Jul 28, 2020 at 04:23:15PM +0200, Peter Krempa wrote:
> On Tue, Jul 28, 2020 at 16:14:03 +0200, Pavel Hrdina wrote:
> > On Tue, Jul 28, 2020 at 03:59:58PM +0200, Peter Krempa wrote:
> > > On Tue, Jul 28, 2020 at 15:57:16 +0200, Pavel Hrdina wrote:
> > > > On Tue, Jul 28, 2020 at 03:18:23PM +0200, Peter Krempa wrote:
> > > > > On Thu, Jul 16, 2020 at 11:59:17 +0200, Pavel Hrdina wrote:
> > > > > > Signed-off-by: Pavel Hrdina <phrdina at redhat.com>
> > > > > > ---
> > > > > > docs/Makefile.am | 26 ---------------------
> > > > > > scripts/meson-html-gen.py | 49 +++++++++++++++++++++++++++++++++++++++
> > > > > > scripts/meson.build | 1 +
> > > > > > 3 files changed, 50 insertions(+), 26 deletions(-)
> > > > > > create mode 100755 scripts/meson-html-gen.py
> > >
> > > [...]
> > >
> > > > > > +)
> > > > > > +
> > > > > > +html = subprocess.run(
> > > > > > + [args.xmllint, '--nonet', '--format', '-'],
> > > > > > + input=html_tmp.stdout,
> > > > > > + stdout=subprocess.PIPE,
> > > > > > + stderr=subprocess.PIPE,
> > > > >
> > > > > We can then do this as separate stage.
> > > >
> > > > What do you mean by separate stage? Not following here.
> > >
> > > I was arguing that the reformatting done by xmllint can be done as a
> > > separate build target thus eliminating the need to have this script
> > > completely.
> > Right, I guess now it can be done like that since there is not the part
> > that modified the string directly in python. However, I would like to
> > keep it like this.
> Well, and I don't like the extra python wrapper which obscures what is
> happening. Arguably we could write everything ourselves and just invoke
> a massive script from make/meson/whatever.
Thanks for invalid argument.
> > We will not have temporary files in the build directory. With two
> > targets the temporary file should not be removed otherwise ninja would
> > rebuild it every single time and that would cause to rebuild the
> > resulting HTML as well.
> Umm there's plenty of temporary stuff in the build directory. I don't
> think we care.
Not in the docs directory. But I take it as it was not a strong argument
from my side. However, there is another argument.
It is called from docs/meson.build, docs/internals/meson.build,
docs/kbase/meson.build and docs/manpages/meson.build. In order to avoid
repetition in meson it is recommended to use scripts as meson doesn't
To avoid the repetition we could do the same trick as in src/ directory
by using list of dictionaries which would be processed only in
If there majority agrees on removing the script I would rather do it as
a followup series.
-------------- next part --------------
A non-text attachment was scrubbed...
Size: 833 bytes
Desc: not available
More information about the libvir-list