www.delorie.com/gnu/docs/gcc/gccint_23.html   search  
 
Buy the book!


GNU Compiler Collection (GCC) Internals

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

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.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

  webmaster     delorie software   privacy  
  Copyright 2003   by The Free Software Foundation     Updated Jun 2003