Welcome to the Getting Started section of the GCC Wiki

We are constantly looking for new developers who are willing to donate their time to advance GCC.

This section contains collected information geared towards folks who are new to GCC and may be feeling a bit lost in the barbaric jungles of GCC's source code. Although we are continuously trying to improve GCC's internal modularity and interfaces, the fact remains that GCC is fairly large, has been around for a lot of time and we need to keep it working on the multitude of supported architectures and languages. So, getting to work with GCC can be a challenge.

Everyone is welcome to add links to tutorials, HOWTOs, cheat sheets, etc that may be floating around the net.

Look at EasyHacks for some on-ramp suggestions (but carry on reading this page for how-to information). ImprovementProjects lists more involved projects, that may suit your tastes.

Basics: Contributing to GCC in 10 easy steps

  1. Get the sources. The current development tree is accessible using Git

  2. Build GCC

    • You do not actually need to install GCC to test it, it is enough to build it, alternatively use the --prefix options of the configure script to install somewhere into your home.

  3. Test it and test any changes you make too

    • Unless you have a good reason, you should maximise the number of languages tested by passing --enable-languages=all to configure.

  4. Debug any issues you find

  5. Format your code for GCC

  6. Join the community: Join at least the gcc@ and gcc-patches@ mailing lists.

  7. Submit your patches: Produce a patch with git format-patch, produce a Changelog with contrib/mklog, submit patches to the gcc-patches@ mailing list (possibly CC other relevant mailing lists or MAINTAINERS)

  8. Decide whether you want to assign your copyright to the FSF or not, in which case you'll have to certify the Developer Certificate of Origin. Both options are easy and described in this page about Contributing to GCC.

  9. Commit your patches. For the few first patches you should ask in the submission email that someone commits the patch for you. Once you have a few patches approved, you should ask for write access to the Git repository.

  10. Profit!

Tutorials, HOWTOs

Internal documentation

Dealing with the source code

Structure Of GCC

Reporting and correcting bugs

When using Bugzilla, GCC maintainers (those having at least write after approval status to GCC trunk) should preferably use their username@gcc.gnu.org account to log in Bugzilla.

None: GettingStarted (last edited 2023-11-02 09:32:55 by JonathanWakely)