| 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: | Whole Thread | Raw Message | 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 |