Re: meson documentation build open issues

From: Andres Freund <andres(at)anarazel(dot)de>
To: Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com>
Cc: pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: meson documentation build open issues
Date: 2023-03-20 02:33:38
Message-ID: 20230320023338.hiclf2hcoxlzizdg@awork3.anarazel.de
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Hi,

On 2023-03-15 20:55:33 -0700, Andres Freund wrote:
> WIP patch for that attached. There's now
> install-doc-man
> install-doc-html
> run targets and a
> install-docs
> alias target.
>
>
> I did end up getting stuck when hacking on this, and ended up adding css
> support for nochunk and support for the website style for htmlhelp and
> nochunk, as well as obsoleting the need for copying the css files... But
> perhaps that's a bit too much.

Updated set of patches attached. This one works in older meson versions too
and adds install-world and install-quiet targets.

I also ended up getting so frustrated at the docs build speed that I started
to hack a bit on that. I attached a patch shaving a few seconds off the
buildtime.

I think we can make the docs build in parallel and incrementally, by building
the different parts of the docs in parallel, using --stringparam rootid,
e.g. building each 'part' separately.

A very very rough draft attached:

parallel with parts:
real 0m10.831s
user 0m58.295s
sys 0m1.402s

normal:
real 0m32.215s
user 0m31.876s
sys 0m0.328s

1/3 of the build time at 2x the cost is nothing to sneeze at.

Greetings,

Andres Freund

Attachment Content-Type Size
v2-0001-meson-rename-html_help-target-to-htmlhelp.patch text/x-diff 1.2 KB
v2-0002-meson-make-install_test_files-more-generic-rename.patch text/x-diff 5.1 KB
v2-0003-wip-meson-add-install-docs-doc-html-doc-man-targe.patch text/x-diff 3.8 KB
v2-0004-meson-add-install-quiet-world-targets.patch text/x-diff 14.9 KB
v2-0005-docs-html-copy-images-to-output-as-part-of-xslt-b.patch text/x-diff 3.3 KB
v2-0006-wip-docs-copy-or-inline-css.patch text/x-diff 7.1 KB
v2-0007-docs-speed-up-docs-build-by-special-casing-the-ge.patch text/x-diff 3.6 KB
v2-0008-VERY-WIP-parallel-doc-generation.patch text/x-diff 5.3 KB

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Kyotaro Horiguchi 2023-03-20 03:20:40 Re: Add pg_walinspect function with block info columns
Previous Message Amit Kapila 2023-03-20 02:13:07 Re: Allow logical replication to copy tables in binary format