On 06/06/2025 21:50, John Haugabook wrote:
Didn't work for me. I can use the xml from:
https://cygwin.com/git/?p=newlib-cygwin.git;f=winsup/doc;a=tree
and do a makeshift build, but doing that doesn't really do any good
unless I can generate the html as it is done from however newlib
generates the html page from xml.
The {faq,cygwin-api/cygwin-ug} documentation is built (by default) as
part of the cygwin build process.
So, the instructions [1] should work.
(You might be able to shortcut this and just do a make in winsup/doc
after the first time)
I think getting the docbook-generated documentation to sit inside our
navbar frame on the website is not straightforward, which is why it's
not done at the moment.
There's some automation I made to deploy this to the website after a CI
build, but unfortunately that's not hooked up yet due to some issues, so
I believe the current process is just a script that corinna runs to copy
the build products into the cygwin-htdocs repo and check them in.
[1] https://cygwin.com/faq.html#faq.programming.building-cygwin
