[thirdparty/gcc.git] / gcc / doc / gcc / gcc.rst

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

.. %**start of header

.. INTERNALS is used by md.texi to determine whether to include the
   whole of that file, in the internals manual, or only the part
   dealing with constraints, in the user manual.

.. NOTE: checks/things to do:
    c
   -have bob do a search in all seven files for "mew" (ideally -mew,
    but i may have forgotten the occasional "-"..).
       Just checked... all have `-'!  Bob 22Jul96
       Use this to search:   grep -n '\-\-mew' *.texi
   -item/itemx, text after all (sub/sub)section titles, etc..
   -consider putting the lists of options on pp 17-> etc in columns or
    some such.
   -overfulls.  do a search for "mew" in the files, and you will see
     overfulls that i noted but could not deal with.
   -have to add text:  beginning of chapter 8
    c
   anything else?                       -mew 10feb93

.. Create a separate index for command line options.

.. Merge the standard indexes into a single one.

.. %**end of header

.. index:: introduction

.. _top:

Introduction
============

This manual documents how to use the GNU compilers,
as well as their features and incompatibilities, and how to report
bugs.  It corresponds to the compilers
|package_version|
version |gcc_version|.
The internals of the GNU compilers, including how to port them to new
targets and some information about how to write front ends for new
languages, are documented in a separate manual.  See :ref:`gccint:top`.
Commit	Line	Data
c63539ff ML	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	.. %**start of header
	7
	8	.. INTERNALS is used by md.texi to determine whether to include the
	9	whole of that file, in the internals manual, or only the part
	10	dealing with constraints, in the user manual.
	11
	12	.. NOTE: checks/things to do:
	13	c
	14	-have bob do a search in all seven files for "mew" (ideally -mew,
	15	but i may have forgotten the occasional "-"..).
	16	Just checked... all have `-'! Bob 22Jul96
	17	Use this to search: grep -n '\-\-mew' *.texi
	18	-item/itemx, text after all (sub/sub)section titles, etc..
	19	-consider putting the lists of options on pp 17-> etc in columns or
	20	some such.
	21	-overfulls. do a search for "mew" in the files, and you will see
	22	overfulls that i noted but could not deal with.
	23	-have to add text: beginning of chapter 8
	24	c
	25	anything else? -mew 10feb93
	26
	27	.. Create a separate index for command line options.
	28
	29	.. Merge the standard indexes into a single one.
	30
	31	.. %**end of header
	32
	33	.. index:: introduction
	34
	35	.. _top:
	36
	37	Introduction
	38	============
	39
	40	This manual documents how to use the GNU compilers,
	41	as well as their features and incompatibilities, and how to report
	42	bugs. It corresponds to the compilers
	43	\|package_version\|
	44	version \|gcc_version\|.
	45	The internals of the GNU compilers, including how to port them to new
	46	targets and some information about how to write front ends for new
3ed1b4ce	47	languages, are documented in a separate manual. See :ref:`gccint:top`.