gcc/doc/gccint/makefile-fragments.rst

   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 .. index:: makefile fragment
   7
   8 .. _fragments:
   9
  10 Makefile Fragments
  11 ------------------
  12
  13 When you configure GCC using the :samp:`configure` script, it will
  14 construct the file :samp:`Makefile` from the template file
  15 :samp:`Makefile.in`.  When it does this, it can incorporate makefile
  16 fragments from the :samp:`config` directory.  These are used to set
  17 Makefile parameters that are not amenable to being calculated by
  18 autoconf.  The list of fragments to incorporate is set by
  19 :samp:`config.gcc` (and occasionally :samp:`config.build`
  20 and :samp:`config.host`); See :ref:`system-config`.
  21
  22 Fragments are named either :samp:`t-{target}` or :samp:`x-{host}`,
  23 depending on whether they are relevant to configuring GCC to produce
  24 code for a particular target, or to configuring GCC to run on a
  25 particular host.  Here :samp:`{target}` and :samp:`{host}` are mnemonics
  26 which usually have some relationship to the canonical system name, but
  27 no formal connection.
  28
  29 If these files do not exist, it means nothing needs to be added for a
  30 given target or host.  Most targets need a few :samp:`t-{target}`
  31 fragments, but needing :samp:`x-{host}` fragments is rare.
  32
  33 .. toctree::
  34   :maxdepth: 2
  35
  36   target-makefile-fragments
  37   host-makefile-fragments