| CARVIEW |
GCC: About
These pages are maintained by the GCC team and it's easy to contribute.
The web effort was originally led by Jeff Law. For the last two decades or so Gerald Pfeifer has been leading the effort, but there are many contributors .
The web pages are under git control. The pages on gcc.gnu.org are updated directly after a change has been committed. www.gnu.org is updated once a day at 4:00 -0700 (PDT).
Please send feedback, problem reports and patches to our mailing lists, ideally putting the string "[wwwdocs]" at the beginning of the mail subject.
Want to contribute? Any help concerning the items below is welcome, as are suggestions. Suggestions accompanied by patches have a higher chance of being implemented soon. ;-)
- Improve navigation, with a consistent (short) menu on every page.
- Set up a system that automatically checks the mirrors list.
It should detect mirrors that have gone away, are persistently down, or very out of date (the last being easy to do for those carrying snapshots, harder for those with releases only). DJ Delorie <dj@redhat.com> has some scripts to do this already.
Using the git repository
Assuming you have both git and SSH installed, you can check out the web pages via
git clone git+ssh://username@gcc.gnu.org/git/gcc-wwwdocs.git
where username is your user name at gcc.gnu.org.
For anonymous access, use
git clone https://gcc.gnu.org/git/gcc-wwwdocs.git
Validating a change
To validate any changes, you can use the W3 Validator. Just use the "Validate by File Upload" functionality.
Checking in a change
We recommend you list files explicitly to avoid accidental checkins and prefer that each checkin be of a complete, single logical change.
- Sync your sources with the master repository via "
git pull". This will also identify any files in your local tree that you have modified. - We recommend reviewing the output of "
git diff". - Use "
git commit" and "git push origin master" to check in the patch. - Upon checkin a message will be sent to the gcc-cvs-wwwdocs mailing list.
As changes are checked in, the respective pages are preprocessed
via the script wwwdocs/bin/preprocess which in turn
uses a tool called MetaHTML. Among others, this preprocessing
adds CSS style sheets, XML and HTML headers, and our standard
footer. The MetaHTML style sheet is in
wwwdocs/htdocs/style.mhtml.
Copyright (C) Free Software Foundation, Inc. Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.
These pages are maintained by the GCC team. Last modified 2025-10-11.