1 files changed, 257 insertions, 0 deletions
diff --git a/share/doc/gccint/Top-Level.html b/share/doc/gccint/Top-Level.html
new file mode 100644
index 0000000..659f371
--- /dev/null
+++ b/share/doc/gccint/Top-Level.html
@@ -0,0 +1,257 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<!-- Copyright (C) 1988-2023 Free Software Foundation, Inc.
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with the
+Invariant Sections being "Funding Free Software", the Front-Cover
+Texts being (a) (see below), and with the Back-Cover Texts being (b)
+(see below).  A copy of the license is included in the section entitled
+"GNU Free Documentation License".
+
+(a) The FSF's Front-Cover Text is:
+
+A GNU Manual
+
+(b) The FSF's Back-Cover Text is:
+
+You have freedom to copy and modify this GNU Manual, like GNU
+     software.  Copies published by the Free Software Foundation raise
+     funds for GNU development. -->
+<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
+<head>
+<title>GNU Compiler Collection (GCC) Internals: Top Level</title>
+
+<meta name="description" content="GNU Compiler Collection (GCC) Internals: Top Level">
+<meta name="keywords" content="GNU Compiler Collection (GCC) Internals: Top Level">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<link href="index.html#Top" rel="start" title="Top">
+<link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Source-Tree.html#Source-Tree" rel="up" title="Source Tree">
+<link href="gcc-Directory.html#gcc-Directory" rel="next" title="gcc Directory">
+<link href="Configure-Terms.html#Configure-Terms" rel="previous" title="Configure Terms">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.indentedblock {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style:oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nocodebreak {white-space:nowrap}
+span.nolinebreak {white-space:nowrap}
+span.roman {font-family:serif; font-weight:normal}
+span.sansserif {font-family:sans-serif; font-weight:normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
+</head>
+
+<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
+<a name="Top-Level"></a>
+<div class="header">
+<p>
+Next: <a href="gcc-Directory.html#gcc-Directory" accesskey="n" rel="next">gcc Directory</a>, Previous: <a href="Configure-Terms.html#Configure-Terms" accesskey="p" rel="previous">Configure Terms</a>, Up: <a href="Source-Tree.html#Source-Tree" accesskey="u" rel="up">Source Tree</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<hr>
+<a name="Top-Level-Source-Directory"></a>
+<h3 class="section">6.2 Top Level Source Directory</h3>
+
+<p>The top level source directory in a GCC distribution contains several
+files and directories that are shared with other software
+distributions such as that of GNU Binutils.  It also contains several
+subdirectories that contain parts of GCC and its runtime libraries:
+</p>
+<dl compact="compact">
+<dt><samp>c++tools</samp></dt>
+<dd><p>Contains the sources for the g++-mapper-server, a tool used with
+C++ modules.
+</p>
+</dd>
+<dt><samp>config</samp></dt>
+<dd><p>Autoconf macros and Makefile fragments used throughout the tree.
+</p>
+</dd>
+<dt><samp>contrib</samp></dt>
+<dd><p>Contributed scripts that may be found useful in conjunction with GCC.
+One of these, <samp>contrib/texi2pod.pl</samp>, is used to generate man
+pages from Texinfo manuals as part of the GCC build process.
+</p>
+</dd>
+<dt><samp>fixincludes</samp></dt>
+<dd><p>The support for fixing system headers to work with GCC.  See
+<samp>fixincludes/README</samp> for more information.  The headers fixed by
+this mechanism are installed in <samp><var>libsubdir</var>/include-fixed</samp>.
+Along with those headers, <samp>README-fixinc</samp> is also installed, as
+<samp><var>libsubdir</var>/include-fixed/README</samp>.
+</p>
+</dd>
+<dt><samp>gcc</samp></dt>
+<dd><p>The main sources of GCC itself (except for runtime libraries),
+including optimizers, support for different target architectures,
+language front ends, and testsuites.  See <a href="gcc-Directory.html#gcc-Directory">The
+<samp>gcc</samp> Subdirectory</a>, for details.
+</p>
+</dd>
+<dt><samp>gnattools</samp></dt>
+<dd><p>Support tools for GNAT.
+</p>
+</dd>
+<dt><samp>gotools</samp></dt>
+<dd><p>Support tools for Go.
+</p>
+</dd>
+<dt><samp>include</samp></dt>
+<dd><p>Headers for the <code>libiberty</code> library.
+</p>
+</dd>
+<dt><samp>intl</samp></dt>
+<dd><p>GNU <code>libintl</code>, from GNU <code>gettext</code>, for systems which do not
+include it in <code>libc</code>.
+</p>
+</dd>
+<dt><samp>libada</samp></dt>
+<dd><p>The Ada runtime library.
+</p>
+</dd>
+<dt><samp>libatomic</samp></dt>
+<dd><p>The runtime support library for atomic operations (e.g. for <code>__sync</code>
+and <code>__atomic</code>).
+</p>
+</dd>
+<dt><samp>libbacktrace</samp></dt>
+<dd><p>A library that allows GCC to produce backtraces when it crashes.
+</p>
+</dd>
+<dt><samp>libcc1</samp></dt>
+<dd><p>A library that allows GDB to make use of the compiler.
+</p>
+</dd>
+<dt><samp>libcody</samp></dt>
+<dd><p>A compiler dynamism library to allow communication between compilers and
+build systems, for purposes such as C++ modules.
+</p>
+</dd>
+<dt><samp>libcpp</samp></dt>
+<dd><p>The C preprocessor library.
+</p>
+</dd>
+<dt><samp>libdecnumber</samp></dt>
+<dd><p>The Decimal Float support library.
+</p>
+</dd>
+<dt><samp>libffi</samp></dt>
+<dd><p>The <code>libffi</code> library, used as part of the Go runtime library.
+</p>
+</dd>
+<dt><samp>libgcc</samp></dt>
+<dd><p>The GCC runtime library.
+</p>
+</dd>
+<dt><samp>libgfortran</samp></dt>
+<dd><p>The Fortran runtime library.
+</p>
+</dd>
+<dt><samp>libgm2</samp></dt>
+<dd><p>The Modula-2 runtime library.
+</p>
+</dd>
+<dt><samp>libgo</samp></dt>
+<dd><p>The Go runtime library.  The bulk of this library is mirrored from the
+<a href="https://github.com/golang/go">master Go repository</a>.
+</p>
+</dd>
+<dt><samp>libgomp</samp></dt>
+<dd><p>The GNU Offloading and Multi Processing Runtime Library.
+</p>
+</dd>
+<dt><samp>libiberty</samp></dt>
+<dd><p>The <code>libiberty</code> library, used for portability and for some
+generally useful data structures and algorithms.  See <a href="http://gcc.gnu.org/onlinedocs/libiberty/index.html#Top">Introduction</a> in <cite><small>GNU</small> libiberty</cite>, for more information
+about this library.
+</p>
+</dd>
+<dt><samp>libitm</samp></dt>
+<dd><p>The runtime support library for transactional memory.
+</p>
+</dd>
+<dt><samp>libobjc</samp></dt>
+<dd><p>The Objective-C and Objective-C++ runtime library.
+</p>
+</dd>
+<dt><samp>libphobos</samp></dt>
+<dd><p>The D standard and runtime library.  The bulk of this library is mirrored
+from the <a href="https://github.com/dlang">master D repositories</a>.
+</p>
+</dd>
+<dt><samp>libquadmath</samp></dt>
+<dd><p>The runtime support library for quad-precision math operations.
+</p>
+</dd>
+<dt><samp>libsanitizer</samp></dt>
+<dd><p>Libraries for various sanitizers.  The bulk of this directory is mirrored
+from the <a href="https://github.com/google/sanitizers">Google sanitizers
+repositories</a>.
+</p>
+</dd>
+<dt><samp>libssp</samp></dt>
+<dd><p>The Stack protector runtime library.
+</p>
+</dd>
+<dt><samp>libstdc++-v3</samp></dt>
+<dd><p>The C++ runtime library.
+</p>
+</dd>
+<dt><samp>libvtv</samp></dt>
+<dd><p>The vtable verification library.
+</p>
+</dd>
+<dt><samp>lto-plugin</samp></dt>
+<dd><p>Plugin used by the linker if link-time optimizations are enabled.
+</p>
+</dd>
+<dt><samp>maintainer-scripts</samp></dt>
+<dd><p>Scripts used by the <code>gccadmin</code> account on <code>gcc.gnu.org</code>.
+</p>
+</dd>
+<dt><samp>zlib</samp></dt>
+<dd><p>The <code>zlib</code> compression library, used for compressing and
+uncompressing GCC&rsquo;s intermediate language in LTO object files.
+</p></dd>
+</dl>
+
+<p>The build system in the top level directory, including how recursion
+into subdirectories works and how building runtime libraries for
+multilibs is handled, is documented in a separate manual, included
+with GNU Binutils.
+</p>
+<hr>
+<div class="header">
+<p>
+Next: <a href="gcc-Directory.html#gcc-Directory" accesskey="n" rel="next">gcc Directory</a>, Previous: <a href="Configure-Terms.html#Configure-Terms" accesskey="p" rel="previous">Configure Terms</a>, Up: <a href="Source-Tree.html#Source-Tree" accesskey="u" rel="up">Source Tree</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
+</div>
+
+
+
+</body>
+</html>