On 2025-06-05 19:50, John Haugabook wrote:
I made a few small edits to the website, and included the patch as an
attachment. Below are the changes:
- Changed links to template elements to absolute, using "/" before the page.
- Included template elements in nested pages.
- Made an edit to "Install.html".
- In style.css edited elements for better UX, and edited comment
markers for consistency, ending at col 78 for comments marking style
section.
I wasn’t sure where website suggestions should be sent — this list
seemed most appropriate, given its name. If there’s a better place or
process to submit patches like this, please feel free to redirect me.
Rather than the *generated* HTML you sent many of your patches against, you will
have to redo many of your changes against the applicable source repos below,
build Cygwin and docs to check the appropriate contents are generated and
appear, then format and send the patches from the commits against each of the
source repos, either as separate individual patches, or a series of *related*
patches against each repo.
Send git-format-patch output against current:
https://cygwin.com/git/cygwin-htdocs.git
sources using git-send-email so they can be reviewed and applied with git-am.
Most other website and doc package contents are generated from DocBook XML:
https://cygwin.com/git/?p=newlib-cygwin.git;f=winsup/doc;a=tree
sources in the above repo: note all the includes of other, sometimes generated,
XML files, most of which are generated from embedded API comments in function
sources:
https://cygwin.com/git/?p=newlib-cygwin.git;f=winsup/cygwin;a=tree
https://cygwin.com/git/?p=newlib-cygwin.git;f=newlib/libc;a=tree
https://cygwin.com/git/?p=newlib-cygwin.git;f=newlib/libm;a=tree
in DocBook XML and other doc formats, and which should be sent using the same
process; except all Newlib changes should be sent to the newlib sourceware
mailing list rather than the cygwin patches mailing list.
Totally understand if the changes are rejected or revised. Thank you
for maintaining the project and reviewing contributions.
To generate the API info and man pages, you can change into the newlib directory
and:
$ make info man
$ make install-info install-man
I have no idea what the process is to deploy the generated HTML files into the
cygwin-htdocs tree, unless it may just be the presence of a parallel repo during
the build, and/or scripts run from one or the other, or the infrastructure.
It would be useful if we could be pointed to docs on how to reproduce the web
site locally.
--
Take care. Thanks, Brian Inglis Calgary, Alberta, Canada
La perfection est atteinte Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter not when there is no more to add
mais lorsqu'il n'y a plus rien à retrancher but when there is no more to cut
-- Antoine de Saint-Exupéry
