..
  Copyright 1988-2022 Free Software Foundation, Inc.
  This is part of the GCC manual.
  For copying conditions, see the copyright.rst file.

.. index:: bugs, known, installation trouble, known causes of trouble

.. _trouble:

Known Causes of Trouble with GCC
--------------------------------

This section describes known problems that affect users of GCC.  Most
of these are not GCC bugs per se---if they were, we would fix them.
But the result for a user may be like the result of a bug.

Some of these problems are due to bugs in other software, some are
missing features that are too much work to add, and some are places
where people's opinions differ as to what is best.

.. toctree::
  :maxdepth: 2

  known-causes-of-trouble-with-gcc/actual-bugs-we-havent-fixed-yet
  known-causes-of-trouble-with-gcc/interoperation
  known-causes-of-trouble-with-gcc/incompatibilities-of-gcc
  known-causes-of-trouble-with-gcc/fixed-header-files
  known-causes-of-trouble-with-gcc/standard-libraries
  known-causes-of-trouble-with-gcc/disappointments-and-misunderstandings
  known-causes-of-trouble-with-gcc/common-misunderstandings-with-gnu-c
  known-causes-of-trouble-with-gcc/certain-changes-we-dont-want-to-make
  known-causes-of-trouble-with-gcc/warning-messages-and-error-messages