git.ipfire.org Git - thirdparty/gcc.git/blob

   1 ..
   2   Copyright 1988-2022 Free Software Foundation, Inc.
   3   This is part of the GCC manual.
   4   For copying conditions, see the copyright.rst file.
   5
   6 .. _subdirectories:
   7
   8 Subdirectories of gcc
   9 ^^^^^^^^^^^^^^^^^^^^^
  10
  11 The :samp:`gcc` directory contains the following subdirectories:
  12
  13 :samp:`language`
  14   Subdirectories for various languages.  Directories containing a file
  15   :samp:`config-lang.in` are language subdirectories.  The contents of
  16   the subdirectories :samp:`c` (for C), :samp:`cp` (for C++),
  17   :samp:`objc` (for Objective-C), :samp:`objcp` (for Objective-C++),
  18   and :samp:`lto` (for LTO) are documented in this
  19   manual (see :ref:`passes`);
  20   those for other languages are not.  See :ref:`front-end`, for details of the files in these
  21   directories.
  22
  23 :samp:`common`
  24   Source files shared between the compiler drivers (such as
  25   :command:`gcc`) and the compilers proper (such as :samp:`cc1`).  If an
  26   architecture defines target hooks shared between those places, it also
  27   has a subdirectory in :samp:`common/config`.  See :ref:`target-structure`.
  28
  29 :samp:`config`
  30   Configuration files for supported architectures and operating
  31   systems.  See :ref:`back-end`, for
  32   details of the files in this directory.
  33
  34 :samp:`doc`
  35   ReStructuredText documentation for GCC, together with automatically generated
  36   man pages and support for converting the installation manual to
  37   HTML.  See :ref:`building_documentation`.
  38
  39 :samp:`ginclude`
  40   System headers installed by GCC, mainly those required by the C
  41   standard of freestanding implementations.  See :ref:`headers`, for details of when these and other headers are
  42   installed.
  43
  44 :samp:`po`
  45   Message catalogs with translations of messages produced by GCC into
  46   various languages, :samp:`{language}.po`.  This directory also
  47   contains :samp:`gcc.pot`, the template for these message catalogues,
  48   :samp:`exgettext`, a wrapper around :command:`gettext` to extract the
  49   messages from the GCC sources and create :samp:`gcc.pot`, which is run
  50   by :samp:`make gcc.pot`, and :samp:`EXCLUDES`, a list of files from
  51   which messages should not be extracted.
  52
  53 :samp:`testsuite`
  54   The GCC testsuites (except for those for runtime libraries).
  55   See :ref:`testsuites`.