GNU Compiler Collection (GCC) Internals
5.3.8.1 The Front End `language' Directory
A front end `language' directory contains the source files
of that front end (but not of any runtime libraries, which should be
outside the `gcc' directory). This includes documentation, and
possibly some subsidiary programs build alongside the front end.
Certain files are special and other parts of the compiler depend on
their names:
- `config-lang.in'
- This file is required in all language subdirectories. See section The Front End `config-lang.in' File, for details of
its contents
- `Make-lang.in'
- This file is required in all language subdirectories. It contains
targets
lang.hook (where lang is the
setting of language in `config-lang.in') for the following
values of hook, and any other Makefile rules required to
build those targets (which may if necessary use other Makefiles
specified in outputs in `config-lang.in', although this is
deprecated).
all.build
all.cross
start.encap
rest.encap
- FIXME: exactly what goes in each of these targets?
info
- Build info documentation for the front end, in the source directory.
This target is only called by
make bootstrap if a suitable
version of makeinfo is available, so does not need to check
for this, and should fail if an error occurs.
dvi
- Build DVI documentation for the front end, in the build directory.
This should be done using
$(TEXI2DVI), with appropriate
`-I' arguments pointing to directories of included files.
generated-manpages
- Build generated man pages for the front end from Texinfo manuals
(see section 5.3.7.2 Man Page Generation), in the source directory. This target
is only called if the necessary tools are available, but should ignore
errors so as not to stop the build if errors occur; man pages are
optional and the tools involved may be installed in a broken way.
install-normal
- FIXME: what is this target for?
install-common
- Install everything that is part of the front end, apart from the
compiler executables listed in
compilers in
`config-lang.in' that are installed in `libsubdir' by
the main `Makefile'.
install-info
- Install info documentation for the front end, if it is present in the
source directory. (It may not be present if a suitable version of
makeinfo was not installed.) This target should run the
command install-info to update the info directory, but
should ignore errors when running that command.
install-man
- Install man pages for the front end. This target should ignore
errors.
uninstall
- Uninstall files installed by installing the compiler. This is
currently documented not to be supported, so the hook need not do
anything.
mostlyclean
clean
distclean
extraclean
maintainer-clean
- Except for
extraclean, the language parts of the standard GNU
`*clean' targets. See section `Standard Targets for Users' in GNU Coding Standards, for details of the standard
targets. extraclean does distclean and also deletes
anything likely to be found in the source directory that shouldn't be
in the distribution. For GCC, maintainer-clean should delete
all generated files in the source directory that are not checked into
CVS, but should not delete anything checked into CVS.
stage1
stage2
stage3
stage4
- Move to the stage directory files not included in
stagestuff in
`config-lang.in' or otherwise moved by the main `Makefile'.
- `lang-options.h'
- This file provides entries for
documented_lang_options in
`toplev.c' describing command-line options the front end accepts
for `--help' output.
- `lang-specs.h'
- This file provides entries for
default_compilers in
`gcc.c' which override the default of giving an error that a
compiler for that language is not installed.
- `language-tree.def'
- This file, which need not exist, defines any language-specific tree
codes.
