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 |
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 |