Feedback-ID: idd01497b:Fastmail
Content-Type: multipart/mixed;
 boundary=e9f68f5cfacc848e525d83fd6437a87c551d69d0c90d3b64c1adad1a13d9
Mime-Version: 1.0
Date: Thu, 07 Nov 2024 04:37:22 +0000
Message-Id: <D5FO2HAIQQ14.ONGEFJNG2S0Q@partin.io>
Subject: Add html-serve target to autotools and meson
To: "pgsql-hackers" <pgsql-hackers@postgresql.org>
From: "Tristan Partin" <tristan@partin.io>
Archived-At: <https://www.postgresql.org/message-id/D5FO2HAIQQ14.ONGEFJNG2S0Q%40partin.io>
Precedence: bulk

--e9f68f5cfacc848e525d83fd6437a87c551d69d0c90d3b64c1adad1a13d9
Content-Type: multipart/alternative;
 boundary=fa6bbe22ec5b2add7e790493d26903998a74049e99058c86e6bb9e074430

--fa6bbe22ec5b2add7e790493d26903998a74049e99058c86e6bb9e074430
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline
Content-Type: text/plain; charset=UTF-8; format=Flowed

When working on documentation, I find it useful to spawn an HTTP server=20
to serve docs for me to consume in a web browser. I went ahead and used=20
Python's builtin http.server module, but it could also be a run target=20
which just spawned `xdg-open builddir/doc/src/sgml/html/index.html`,=20
though I would doubt Windows has xdg-open(1).

The one controversial part of this patch might be using "port" 0, which=20
asks the kernel to assign an unused port. I'm not sure if that exists on=20
Windows, or is even desireable. Should we have a build option for the=20
port? What would a good default be?

--=20
Tristan Partin
Neon (https://neon.tech)

--fa6bbe22ec5b2add7e790493d26903998a74049e99058c86e6bb9e074430--

--e9f68f5cfacc848e525d83fd6437a87c551d69d0c90d3b64c1adad1a13d9
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename=html-serve.diff
Content-Type: text/x-patch; charset=utf-8; name=html-serve.diff

ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9NYWtlZmlsZSBiL2RvYy9zcmMvc2dtbC9NYWtlZmls
ZQppbmRleCBhMDRjNTMyYjUzLi42ZjYyOWUwMmE3IDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwv
TWFrZWZpbGUKKysrIGIvZG9jL3NyYy9zZ21sL01ha2VmaWxlCkBAIC0xMzAsNiArMTMwLDkgQEAg
aHRtbC1zdGFtcDogc3R5bGVzaGVldC54c2wgcG9zdGdyZXMtZnVsbC54bWwgJChBTExfSU1BR0VT
KQogCSQoWFNMVFBST0MpICQoWE1MSU5DTFVERSkgJChYU0xUUFJPQ0ZMQUdTKSAkKFhTTFRQUk9D
X0hUTUxfRkxBR1MpICQod29yZGxpc3QgMSwyLCReKQogCXRvdWNoICRACiAKK2h0bWwtc2VydmU6
IGh0bWwKKwlweXRob24zIC1tIGh0dHAuc2VydmVyIC0tZGlyZWN0b3J5ICckKHRvcF9idWlsZGRp
cikvJChzdWJkaXIpL2h0bWwnIDAKKwogIyBzaW5nbGUtcGFnZSBIVE1MCiBwb3N0Z3Jlcy5odG1s
OiBzdHlsZXNoZWV0LWh0bWwtbm9jaHVuay54c2wgcG9zdGdyZXMtZnVsbC54bWwgJChBTExfSU1B
R0VTKQogCSQoWFNMVFBST0MpICQoWE1MSU5DTFVERSkgJChYU0xUUFJPQ0ZMQUdTKSAkKFhTTFRQ
Uk9DX0hUTUxfRkxBR1MpIC1vICRAICQod29yZGxpc3QgMSwyLCReKQpkaWZmIC0tZ2l0IGEvZG9j
L3NyYy9zZ21sL21lc29uLmJ1aWxkIGIvZG9jL3NyYy9zZ21sL21lc29uLmJ1aWxkCmluZGV4IGU0
MThkZTgzYTcuLmZhNTk4ZDhhYjEgMTAwNjQ0Ci0tLSBhL2RvYy9zcmMvc2dtbC9tZXNvbi5idWls
ZAorKysgYi9kb2Mvc3JjL3NnbWwvbWVzb24uYnVpbGQKQEAgLTE1NCw2ICsxNTQsMTkgQEAgaWYg
ZG9jc19kZXAuZm91bmQoKQogICBhbGlhc190YXJnZXQoJ2h0bWwnLCBodG1sKQogICBhbGlhc190
YXJnZXQoJ2luc3RhbGwtaHRtbCcsIGluc3RhbGxfZG9jX2h0bWwpCiAKKyAgcnVuX3RhcmdldCgK
KyAgICAnaHRtbC1zZXJ2ZScsCisgICAgY29tbWFuZDogWworICAgICAgcHl0aG9uLAorICAgICAg
Jy1tJywKKyAgICAgICdodHRwLnNlcnZlcicsCisgICAgICAnLS1kaXJlY3RvcnknLAorICAgICAg
bWVzb24uY3VycmVudF9idWlsZF9kaXIoKSAvICdodG1sJywKKyAgICAgICcwJywKKyAgICBdLAor
ICAgIGRlcGVuZHM6IGh0bWwsCisgICkKKwogICAjIGJ1aWxkIGFuZCBpbnN0YWxsIG11bHRpLXBh
Z2UgaHRtbCBkb2NzIGFzIHBhcnQgb2YgZG9jcyB0YXJnZXQKICAgZG9jcyArPSBodG1sCiAgIGlu
c3RhbGxkb2NzICs9IGluc3RhbGxfZG9jX2h0bWwK
--e9f68f5cfacc848e525d83fd6437a87c551d69d0c90d3b64c1adad1a13d9--